WinDriver

Popis

Alias: WND

Spustí příkaz přes zprávy Windows API.

Spustí příkaz určený parametrem Command přes zprávy Windows API.

Vstupní parametry

Command

Typ String

Příkaz pro Windows API.

• cbGetCount (zjistí počet položek v nabídce comboboxu)
  • Target=Parametry identifikující combobox
  • Output=Počet položek
• cbGetCurrent (vrátí index právě zvolené položky)
  • Target=Parametry identifikující combobox
  • Output=Index zvolené položky
• cbGetText (vrátí text položky)
  • Target=Parametry identifikující combobox
  • Value=Index požadované položky (0 odpovídá první položce)
  • Output=Text položky
• cbSetCurrent (nastaví index aktuální položky)
  • Target=Parametry identifikující combobox
  • Value=Index požadované položky (0 odpovídá první položce, -1 ruší výběr)
• click (vyvolá kliknutí)
  • Target=Parametry identifikující komponentu (typicky typu Button)
• clickAsync (vyvolá kliknutí, nečeká na zpracování)
  • Target=Parametry identifikující komponentu (typicky typu Button)
• command (vykoná příkaz)
  • Target=Parametry identifikující okno
  • Value=Id příkazu
• getChecked (zjistí stav checkboxu/radiobuttonu)
  • Target=Parametry identifikující komponentu (typicky typu Checkbox nebo Radiobutton)
  • Output=Stav (0=nezaškrtnuto, 1=zaškrtnuto)
• getCount (zjistí počet objektů)
  • Target=Parametry identifikující komponentu(-y)
  • Output=Počet nalezených objektů
• getHandle (zjistí handle objektu)
  • Target=Parametry identifikující komponentu
  • Output=Handle prvního nalezeného objektu
• getHandles (zjistí handle objektů)
  • Target=Parametry identifikující komponentu(-y)
  • Output=Čárkou oddělený seznam handlů nalezených objektů
• getText (vrátí text objektu)
  • Target=Parametry identifikující komponentu nebo okno
  • Output=Text objektu
• lbGetCount (zjistí počet položek listboxu)
  • Target=Parametry identifikující listbox
• lbGetCurrent (vrátí index aktuální položky)
  • Target=Parametry identifikující listbox
  • Output=Index aktuální položky
• lbGetSelected (vrátí index vybrané položky | indexy vybraných položek)
  • Target=Parametry identifikující listbox
  • Value=Pořadové číslo výběru | prázdný
  • Output=Index vybrané položky | středníkem oddělený seznam indexů vybraných položek
• lbGetSelectedCount (vrátí počet vybraných položek listboxu)
  • Target=Parametry identifikující listbox
  • Output=Počet vybraných položek
• lbGetText (vrátí text položky listboxu)
  • Target=Parametry identifikující listbox
  • Value=Index požadované položky (0 odpovídá první položce)
  • Output=Text položky
• lbSetCurrent (nastaví aktuální položku listboxu)
  • Target=Parametry identifikující listbox
  • Value=Index požadované položky (0 odpovídá první položce, -1 ruší výběr)
• lbSetSelected (výbere položky listboxu)
  • Target=Parametry identifikující listbox
  • Value=index položky | středníkem oddělený seznam indexů položek
• lbSetUnselected (zruší výběr položek listboxu)
  • Target=Parametry identifikující listbox
  • Value=index položky | středníkem oddělený seznam indexů položek
• setChecked (nastaví zaškrtnutí checkboxu/radiobuttonu)
  • Target=Parametry identifikující komponentu (typicky typu Checkbox nebo Radiobutton)
  • Value=Požadovaný stav (0=nezaškrtnuto, nenulové celé číslo=zaškrtnuto)
• setText (nastaví text objektu)
  • Target=Parametry identifikující komponentu nebo okno
  • Value=Text
• setTimeout (nastaví timeout pro vyhledávání objektů)
  • Value=Čas v sekundách

Target

Typ String

Cíl příkazu identifikovaný použitím parametrů:

• windowHandle
• windowClass
• windowText
• parentHandle
• parentClass
• parentText
• parentIndex
• handle
• class
• text
• index

Value

Typ String

Hodnota parametru příkazu.

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.

Výstupní parametry

Output

Typ String

Výstup příkazu

Wizard

Tento příkaz má vlastního pomocníka pro nastavení (Wizard). Většina důležitých informací o komponentách, na které je WinDriver aplikován, je uživateli skryta. Wizard poskytuje nástroje umožňující tyto informace získat.

1. Obsahuje nejpoužívanější typy příkazů. Je zde možné požadovaný příkaz vybrat nebo ponechat sekci bez výběru a příkaz zvolit v nabídce Inspektoru u parametru Command.
2. Definice cíle příkazu je založena na 3 záchytných bodech: identifikace okna (sekce Window), identifikace kontejneru obsahujícího cíl (sekce Parent) a identifikace samotného cíle (sekce Target), což je okno či komponenta, se kterou má WinDriver interagovat. Z techto polí s ohledem na stav jejich checkboxů je automaticky sestavena definice parametrů v poli Target Parameters. Ve většině případů postačí ponechat hodnoty tak, jak je dosadí funkce Pick. Za pozornost stojí hodnoty v polích Text Pokud např. má okno proměnlivý titulek (např. obsahuje název dokumentu nebo značku oznamující změnu dokumentu), je nutné check box u tohoto pole zrušit nebo hodnotu parametrizovat. Tlačítko Pick spustí režim získávání informací o komponentě pod kurzorem myši. Pokud je červeně orámována správná komponenta, klikněte na červený text PICK v levém horním rohu orámování. Hodnoty v této sekci budou dosazeny podle zjištěných informací.
3. Pole Value odpovídá hodnotě parametru Value. Pokud je zvolen příkaz Command a pole Target Parameters označuje okno obsahující nabídku (Menu), lze použít tlačítko Commands k výběru položky nabídky a získání identifikátoru odpovídajícího příkazu, který bude dosazen do pole Value.