Příklady použití

ActiveWindow

Získání Handle okna

1. Příkaz ActiveWindow umístěte za některý synchronizační příkaz (např. WaitForBmp) nebo do místa, kde je synchronizace již zajištěna.
2. Výstupní parametr Handle napojte na výstupní parametr aktivity k dalšímu použití nebo přímo (doporučuje se pouze v rámci jedné aktivity) na vstup příkazu, který jej bude využívat.

Poznámka: Synchronizace je nutná k tomu, aby se příkaz ActiveWindow vykonal ve chvíli, kdy je dotyčné okno zaručeně aktivní.

Poznámka: Handle okna lze použít např. v příkazu WindowAction pro manipulaci s oknem (nejčastěji k uzavření).

BmpToText

Příkaz BmpToText použijte k získání zobrazeného textu, jestliže to není možné provést využitím příkazu CaptureText nebo GetClipboard.

Získání textu ze sejmuté části obrazovky

1. Příkaz BmpToText umístěte za příkaz CaptureBitmap, který nastavte tak, aby sejmul požadovaný text.
2. Výstupní parametr Bitmap příkazu CaptureBitmap napojte na vstupní parametr Bitmap příkazu BmpToText
3. Do parametru FontDB uveďte cestu k databázi fontů, která obsahuje písmo použité pro vykreslení rozpoznávaného textu.
4. Není-li text dostatečně kontrastní nebo když pozadí narušuje detekci textu, nastavte parametr Masked=1 a do parametru MaskColor zadejte barvu písma.

Poznámka: Detekci písma i vytvoření databáze fontů umožňují nástroje aplikace GuiMaster Editor.

Poznámka: Ideální je stav, kdy zadaná databáze fontů obsahuje pouze použité písmo včetně správné velikosti a stylu a pouze znaky, které se v detekovaném textu mohou vyskytnout.

ClickBmpRef

Kliknutí na tlačítko

1. Do parametru Bitmap nastavte výřez textu tlačítka.
2. Je-li to nutné, nastavte parametry pro masku.

Poznámka: Není nutné zadávat referenci. Jestliže není zadána, bude kurzor myši umístěn do středu nalezené bitmapy.

Kliknutí na radiobutton nebo checkbox

1. Do parametru Bitmap nastavte výřez textu popisku dotyčného radiobuttonu či checkboxu.
2. Referenci umístěte přibližně do středu kolečka radiobuttonu případně čtverce checkboxu.
3. Je-li to nutné, nastavte parametry pro masku.

Vyvolání kontextové nabídky

1. Do parametru Bitmap nastavte vhodný výřez textu nebo obrázku, který bude sloužit jako kotva reference.
2. Bod kliknutí Reference umístěte do místa, kde sa má kontextová nabídka vyvolat.
3. Parametr Button změňte na hodnotu 2=pravé.
4. Je-li to nutné, nastavte parametry pro masku.

WaitForBmp

Příklad použití

Příkaz WaitForBmp slouží k synchronizaci stavu testované aplikace s během testu. Mnoho příkazů využívajících referenční bitmapu se synchronizuje automaticky čekáním na tuto bitmapu. Avšak mohou nastat situace, kdy je nutné použít tento příkaz. Například když je třeba počkat na zobrazení formuláře a následně použít příkaz, který referenční bitmapu nepoužívá nebo když je nutné počkat na zmizení určité signalizace (např. informace o načítání obsahu).

Do parametru Bitmap uložte signalizační bitmapu a pak nastavte režim čekání parametrem Disappear. Pro čekání na zmizení signalizace použijte hodnotu 1, jinak pro čekání na zobrazení bitmapy ponechte hodnotu 0.