SetField
Popis
Alias: SF
Vyplní textové pole.
Hledá na obrazovce bitmapu danou parametrem Bitmap a v místě k ní vztažené reference Reference simuluje kliknutí myší levým tlačítkem, aby bylo aktivováno textové pole, které se v tomto místě očekává. Následně smaže původní obsah v řežimu určeném parametrem ClearMode a vypíše text uložený v parametru Text. Režim simulace psaní udává parametr TypeMode. Nakonec může být simulován stisk klávesy zadané parametrem AppendKey, případně, má-li AppendLabelClick nenulovou hodnotu, klik na nalezenou bitmapu. Pro vyhledávání referenční bitmapy je možné nastavit maximální čekací dobu parametrem Wait, přeskočení vícenásobných výskytů parametrem Skip a vyhledávání s maskou (parametry MaskMode, BitmapMaskColor a ScreenMaskColor). Oblast vyhledávání určuje hodnota parametru CaptureMode. Pokud není zadaná bitmapa naleznena, příkaz končí chybou.
Vstupní parametry
Bitmap
Typ Bitmap
Vztažná bitmapa, která spolu s referencí Reference určuje pozici textového pole.
Reference
Typ Reference
Reference k textovému poli vztažená k bitmapě Bitmap.
Text
Typ String
Text pro vyplnění pole
MaskMode
Typ Number
Režim masky použité při vyhledávání (0=žádná, 1=uživatelská maska, 2=automatická maska).
BitmapMaskColor
Typ Color
Klíčová barva uživatelské masky v zadané bitmapě (používá se pouze při MaskMode=1).
ScreenMaskColor
Typ Color
Klíčová barva uživatelské masky na sejmuté obrazovce, odpovídající barvě BitmapMaskColor. Tuto hodnotu je třeba nastavit jen v případě, že se tyto dvě barvy liší.
Skip
Typ Number
Určuje počet výskytů bitmap, které se při vyhledávání přeskočí.
Wait
Typ Number
Doba čekání v sekundách na výskyt hledané bitmapy.
CaptureMode
Typ Number
Definuje oblast vyhledávání (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).
ClearMode
Typ Number
Režim mazání obsahu pole (0=nemazat, 1=Ctrl+A/Del, 2=Home/Shift+End/Del, 3=Ctrl+A/Back, 4=Home/Shift+End/Back)
TypeMode
Typ Number
Režim psaní textu (0=send message, 1=keyboard event (Alt+0xxx), 2=keyboard event (local keyboard), 3=send message (no delay))
AppendKey
Typ String
Při nenulové hodnotě simuluje po vyplnění pole stisk zadané klávesy.
AppendLabelClick
Typ Number
Při nenulové hodnotě klikne po vyplnění pole na nalezenou bitmapu Bitmap.
OnlyIfNotNull
Typ Number
Pokud má hodnotu 1, pak se příkaz neprovádí v případě, kdy není zadána hodnota parametru Bitmap nebo Text.
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.
