SetField/en

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 for completing the field

MaskMode

Type 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

Type Number

Určuje počet výskytů bitmap, které se při vyhledávání přeskočí.

Wait

Type Number

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

CaptureMode

Type 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

Type 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

Type 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

Type Number

Při nenulové hodnotě klikne po vyplnění pole na nalezenou bitmapu Bitmap.

OnlyIfNotNull

Type Number

Pokud má hodnotu 1, pak se příkaz neprovádí v případě, kdy není zadána hodnota parametru Bitmap nebo Text.

Enabled

Type Number

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

PreWait

Type Number

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

PostWait

Type Number

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

Viz také

Příklady použití

Používání masky

Režimy snímání obrazovky

Řešení více výskytů hledané bitmapy

Časový limit a systémové parametry