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

Bitmap for reference to the start of text selection.

Reference1

Reference type

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

Bitmap2

Bitmap type

Bitmap for reference to the end of text selection.

Reference2

Reference type

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

ClickCount

Number type

Specifies the number of clicks at the Reference1 position. A value of 0 does not click, a value of 1 means a single click, a value of 2 means a double click, etc. The last click will be released after moving the mouse cursor at Reference2 point.

Button

Number type

Specifies the mouse button to click (0=none, 1=left, 2=right, 3=middle).

MaskMode1

Number type

Mask mode used for Bitmap1 search (0=none, 1=user mask, 2=automatic mask).

BitmapMaskColor1

Color type

The key color of the user mask in the Bitmap1 (used only if MaskMode1=1).

ScreenMaskColor1

Color type

The key color of the user mask on the captured screen corresponding to the color BitmapMaskColor1. It is only need to set this value if the two colors are different.

MaskMode2

Number type

Mask mode used for Bitmap2 search (0=none, 1=user mask, 2=automatic mask).

BitmapMaskColor2

Color type

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

ScreenMaskColor2

Color type

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

Number type

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

Skip2

Number type

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

Wait

Number type

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

CaptureMode1

Number type

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

Number type

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

Number type

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

PreWait

Number type

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

PostWait

Number type

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