Zobrazení zdroje stránky SetActiveRegion/en

<languages/>
[[Category:GuiMaster]]
[[Category:GuiMaster Library]]

== Description ==

'''Alias: SAR'''

'''Sets the active region of the screen.'''

Sets the active region of the screen with the [[#regionid-| RegionId]] number for use in the [[#capturemode-| CaptureMode]]=2 (or 512-520) viewport in subsequent commands. The area is specified by two points [[#reference1-| Reference1]] and [[#reference2-| Reference2]] relative to [[#bitmap1-| Bitmap1]] and [[#bitmap2-| Bitmap2]]. To search for reference bitmaps, the maximum waiting time can be set using [[#wait-|Wait]], to skip multiple occurrences using [[#skip1-|Skip1]] or [[#skip2-|Skip2]], and to mask the search by using [[#maskmode1-|MaskMode1]], [[#bitmapmaskcolor1-|BitmapMaskColor1]] and [[#screenmaskcolor1-|ScreenMaskColor1]] or [[#maskmode2-|MaskMode2]], [[#bitmapmaskcolor2-|BitmapMaskColor2]] and [[#screenmaskcolor2-|ScreenMaskColor2]]. Search areas are specified by the values of [[#capturemode1-|CaptureMode1]] and [[#capturemode2-|CaptureMode2]]. If any of the bitmaps is not found, the command ends in error.

== Input parameters ==

<span id="bitmap1-"></span>
=== Bitmap1 ===

Type [[Special:MyLanguage/Data types#Bitmap | Bitmap]]

Bitmap reference of the first corner of the viewport.

<span id="reference1-"></span>
=== Reference1 ===

Type [[Special:MyLanguage/Data types#Reference | Reference]]

Reference relative to [[#bitmap1-|Bitmap1]] specifying the first corner of the viewport.

<span id="bitmap2-"></span>
=== Bitmap2 ===

Type [[Special:MyLanguage/Data types#Bitmap | Bitmap]]

Bitmap reference of the second corner of the viewport.

<span id="reference2-"></span>
=== Reference2 ===

Type [[Special:MyLanguage/Data types#Reference | Reference]]

Reference relative to [[#bitmap2-|Bitmap2]] specifying the second corner of the viewport.

<span id="regionid-"></span>
=== RegionId ===

Type [[Special:MyLanguage/Data types#Number | Number]]

Number of region. Admissable values are from 0 to 8.

<span id="maskmode1-"></span>
=== MaskMode1 ===

Type [[Special:MyLanguage/Data types#Number | Number]]

Mask mode used for searching for [[#bitmap1-| Bitmap1]] (0=none, 1=user mask, 2=automatic mask).

<span id="bitmapmaskcolor1-"></span>
=== BitmapMaskColor1 ===

Type [[Special:MyLanguage/Data types#Color | Color]]

Key color of the user mask in [[#bitmap1-| Bitmap1]] (used only for [[#maskmode1-| MaskMode1]]=1).

<span id="screenmaskcolor1-"></span>
=== ScreenMaskColor1 ===

Type [[Special:MyLanguage/Data types#Color | Color]]

Key color of the user mask for the capture, matching the color of [[#bitmapmaskcolor1-| BitmapMaskColor1]]. You should set this value only if these two colors are different.

<span id="maskmode2-"></span>
=== MaskMode2 ===

Type [[Special:MyLanguage/Data types#Number | Number]]

Mask mode used for searching for [[#bitmap2-| Bitmap2]] (0=none, 1=user mask, 2=automatic mask).

<span id="bitmapmaskcolor2-"></span>
=== BitmapMaskColor2 ===

Type [[Special:MyLanguage/Data types#Color | Color]]

Key color of the user mask in [[#bitmap2-| Bitmap2]] (used only for [[#maskmode2-| MaskMode2]]=1).

<span id="screenmaskcolor2-"></span>
=== ScreenMaskColor2 ===

Type [[Special:MyLanguage/Data types#Color | Color]]

Key color of the user mask for the capture, matching the color of the [[#bitmapmaskcolor2-| BitmapMaskColor2]]. You should set this value only if these two colors are different.

<span id="skip1-"></span>
=== Skip1 ===

Type [[Special:MyLanguage/Data types#Number | Number]]

Specifies the number of times [[#bitmap1-| Bitmap1]] was skipped during the search.

<span id="skip2-"></span>
=== Skip2 ===

Type [[Special:MyLanguage/Data types#Number | Number]]

Specifies the number of times [[#bitmap2-| Bitmap2]] was skipped during the search.

<span id="wait-"></span>
=== Wait ===

Typ [[Special:MyLanguage/Datové typy#Number | Number]]

Doba čekání v sekundách na výskyt hledaných bitmap.

<span id="capturemode1-"></span>
=== CaptureMode1 ===

Typ [[Special:MyLanguage/Datové typy#Number | Number]]

Definuje oblast vyhledávání bitmapy [[#bitmap1-| 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).

<span id="capturemode2-"></span>
=== CaptureMode2 ===

Typ [[Special:MyLanguage/Datové typy#Number | Number]]

Definuje oblast vyhledávání bitmapy [[#bitmap2-| 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 [[Special:MyLanguage/Datové typy#Number | Number]]

Povoluje nebo zakazuje příkaz. Při hodnotě 0 nebude příkaz proveden.

=== PreWait ===

Typ [[Special:MyLanguage/Datové typy#Number | Number]]

Prodleva v milisekundách před provedením příkazu. Nemá žádný vliv je-li Enabled=0.

=== PostWait ===

Typ [[Special:MyLanguage/Datové typy#Number | Number]]

Prodleva v milisekundách po provedení příkazu. Nemá žádný vliv je-li Enabled=0.

== Výstupní parametry ==

== Viz také ==

[[Special:MyLanguage/Příklady použití#SetActiveRegion|Příklady použití]]

[[Special:MyLanguage/Používání masky|Používání masky]]

[[Special:MyLanguage/Režimy snímání obrazovky|Režimy snímání obrazovky]]

[[Special:MyLanguage/Řešení více výskytů hledané bitmapy|Řešení více výskytů hledané bitmapy]]

[[Special:MyLanguage/Časový limit a systémové parametry|Časový limit a systémové parametry]]