CaptureText/en

Description

Alias: CT

Selects and copies text.

Selects text by clicking the Button at the point specified by Reference1 related to Bitmap1 and dragging to Reference2 related to Bitmap2. The selected text is copied using the clipboard and saved in the output parameter Text. The number of clicks in Reference1 is determined by the ClickCount parameter. It is possible to set the timeout with the Wait parameter, skip multiple occurrences with the Skip1 and Skip2 parameters and specify masking ( MaskMode1, BitmapMaskColor1 and ScreenMaskColor1 eventually MaskMode2, BitmapMaskColor2 and ScreenMaskColor2 parameters). The search area is determined by the value of the CaptureMode1 and CaptureMode2 parameters. If any of the bitmaps is not found, the command ends with an error.

Input parameters

Bitmap1

Bitmap type

A reference relative to the Bitmap1 specifying the start of text selection.

Reference1

Reference type

Reference vztažená k Bitmap1 určující začátek výběru textu.

Bitmap2

Bitmap type

A reference relative to the Bitmap1 specifying the end of text selection.

Reference2

Typ Reference

Reference vztažená k Bitmap2 určující konec výběru textu.

ClickCount

Typ Number

Určuje počet kliknutí v místě Reference1. Při hodnotě 0 se kliknutí neprovede, hodnota 1 znamená jednoduchý klik, hodnota 2 dvojklik, atd. Poslední kliknutí bude uvolněno po přesunu kurzoru myši v místě Reference2.

Button

Typ Number

Určuje tlačítko myši pro kliknutí (0=žádné, 1=levé, 2=pravé, 3=střední).

MaskMode1

Typ Number

Režim masky použité při vyhledávání bitmapy Bitmap1 (0=žádná, 1=uživatelská maska, 2=automatická maska).

BitmapMaskColor1

Typ Color

Klíčová barva uživatelské masky v bitmapě Bitmap1 (používá se pouze při MaskMode1=1).

ScreenMaskColor1

Typ Color

Klíčová barva uživatelské masky na sejmuté obrazovce, odpovídající barvě BitmapMaskColor1. Tuto hodnotu je třeba nastavit jen v případě, že se tyto dvě barvy liší.

MaskMode2

Typ Number

Režim masky použité při vyhledávání bitmapy Bitmap2 (0=žádná, 1=uživatelská maska, 2=automatická maska).;

BitmapMaskColor2

Typ Color

Klíčová barva uživatelské masky v bitmapě Bitmap2 (používá se pouze při MaskMode2=1).

ScreenMaskColor2

Typ Color

Klíčová barva uživatelské masky na sejmuté obrazovce, odpovídající barvě BitmapMaskColor2. Tuto hodnotu je třeba nastavit jen v případě, že se tyto dvě barvy liší.

Skip1

Typ Number

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

Skip2

Typ Number

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

Wait

Typ Number

Doba čekání na výskyt hledaných bitmap.

CaptureMode1

Typ Number

Definuje oblast vyhledávání bitmapy Bitmap1 (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).

CaptureMode2

Typ Number

Definuje oblast vyhledávání bitmapy Bitmap2 (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).

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

Text

Typ String

Text získaný z označeného textu použitím schránky.

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