SetActiveRegion
Popis
Alias: SAR
Nastaví aktivní oblast obrazovky.
Nastaví aktivní oblast obrazovky s číslem RegionId pro použití v režimu snímání výřezu CaptureMode=2 (příp. 512-520) v následných příkazech. Oblast je určena dvěma body Reference1 a Reference2 vztaženými k bitmapám Bitmap1 a Bitmap2. Pro vyhledávání referenčních bitmap je možné nastavit maximální čekací dobu parametrem Wait, přeskočení vícenásobných výskytů parametry Skip1 příp. Skip2 a vyhledávání s maskou (parametry MaskMode1, BitmapMaskColor1 a ScreenMaskColor1 resp. MaskMode2, BitmapMaskColor2 a ScreenMaskColor2). Oblasti vyhledávání určují hodnoty parametrů CaptureMode1 a CaptureMode2. Pokud není některá z bitmap naleznena, příkaz končí chybou.
Vstupní parametry
Bitmap1
Typ Bitmap
Bitmapa reference prvního rohu výřezu.
Reference1
Typ Reference
Reference vztažená k Bitmap1 určující první roh výřezu.
Bitmap2
Typ Bitmap
Bitmapa reference druhého rohu výřezu.
Reference2
Typ Reference
Reference vztažená k Bitmap2 určující druhý roh výřezu.
RegionId
Typ Number
Číslo regionu. Přípustné hodnoty jsou 0 až 8.
MaskMode1
Typ Number
Režim masky použité při vyhledávání bitmapy Bitmap1 (0=žádná, 1=uživatelská maska, 2=automatická maska).
BitmapMaskColor1
Typ Color
Klíčová barva uživatelské masky v bitmapě Bitmap1 (používá se pouze při MaskMode1=1).
ScreenMaskColor1
Typ Color
Klíčová barva uživatelské masky na sejmuté obrazovce, odpovídající barvě BitmapMaskColor1. Tuto hodnotu je třeba nastavit jen v případě, že se tyto dvě barvy liší.
MaskMode2
Typ Number
Režim masky použité při vyhledávání bitmapy Bitmap2 (0=žádná, 1=uživatelská maska, 2=automatická maska).
BitmapMaskColor2
Typ Color
Klíčová barva uživatelské masky v bitmapě Bitmap2 (používá se pouze při MaskMode2=1).
ScreenMaskColor2
Typ Color
Klíčová barva uživatelské masky na sejmuté obrazovce, odpovídající barvě BitmapMaskColor2. Tuto hodnotu je třeba nastavit jen v případě, že se tyto dvě barvy liší.
Skip1
Typ Number
Určuje počet výskytů bitmapy Bitmap1, které se při vyhledávání přeskočí.
Skip2
Typ Number
Určuje počet výskytů bitmapy Bitmap2, které se při vyhledávání přeskočí.
Wait
Typ Number
Doba čekání v sekundách na výskyt hledaných bitmap.
CaptureMode1
Typ Number
Definuje oblast vyhledávání bitmapy Bitmap1 (0=desktop, 1=aktivní okno, 2=aktivní region, 3=oblast aktivního okna, 16=klientská část aktivního okna, 257-264=monitor 1-8, 512-520=aktivní region 0-8).
CaptureMode2
Typ Number
Definuje oblast vyhledávání bitmapy Bitmap2 (0=desktop, 1=aktivní okno, 2=aktivní region, 3=oblast aktivního okna, 16=klientská část aktivního okna, 257-264=monitor 1-8, 512-520=aktivní region 0-8).
Enabled
Typ Number
Povoluje nebo zakazuje příkaz. Při hodnotě 0 nebude příkaz proveden.
PreWait
Typ Number
Prodleva v milisekundách před provedením příkazu. Nemá žádný vliv je-li Enabled=0.
PostWait
Typ Number
Prodleva v milisekundách po provedení příkazu. Nemá žádný vliv je-li Enabled=0.
