SetField
Description
Alias: SF
Completing the text field.
Searches for the bitmap screen provided by the Bitmap parameter, and simulates at the Reference point relative to it a left mouse button click in order to activate the text field expected at that point. It then clears the original content in the mode specified by ClearMode and types in the text saved in the Text parameter. The typing simulation mode is provided by TypeMode. Finally, the keystroke specified by AppendKey can be simulated or, if AppendLabelClick is non-null, then the click on the bitmap found. To search for reference bitmaps, the maximum waiting time can be set with Wait, skipping multiple occurrences using Skip, and doing a masked search using MaskMode, BitmapMaskColor and ScreenMaskColor. The search area is specified by the value of the CaptureMode. If the specified bitmap is not found, the command ends in error.
Input parameters
Bitmap
Type Bitmap
Related bitmap that together with the Reference specifies the position of the text field.
Reference
Type Reference
Reference to the text field relative to the Bitmap.
Text
Type 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
Type 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.
