instance_deactivate_region()

Game Maker Language リファレンス > 組み込み関数 用途別 > ゲームプレイ > instance_deactivate_region

instance_deactivate_region() †

• 対応：5.3A 6.0 6.1A 7.0
• lite OK

書式 †

instance_deactivate_region(left,top,width,height,inside,notme)

left

矩形領域の左上角のｘ座標

top

矩形領域の左上角のｙ座標

width

矩形領域の横幅

height

矩形領域の縦幅

inside

対象を矩形領域の内部に指定するフラグ

notme

実行主体インスタンスを対象からはずすためのフラグ

戻り値 †

N/A

なし

機能 †

(left,top,width,height)の矩形領域を境として、対象のインスタンスを全て非アクティブにします。
(left,top)はルーム座標で指定します。
引数 inside をtrueとすると、矩形領域内部のインスタンスが非アクティブになります。
逆にfalseとすると、矩形領域の外側のインスタンスが非アクティブになります。
引数 notme を true としておくと、実行主体であるインスタンスは非アクティブになりません。（true推奨）
全てのインスタンスが非アクティブとなるとゲームが動かなくなりますので注意してください。

Example †

viewの外側を非アクティブにする例１

instance_activate_all();
instance_deactivate_region(view_xview[0], view_yview[0], view_wview[0], view_hview[0], false, true);
/* view[0] の外側にあるインスタンスは非アクティブにされる。*/
/* 外側の領域に少しでも含まれるインスタンスが対象となるので、本当はview領域より少し大きくしたほうが良い。 */