Method TriggerScopes.Window(+ 1 overload)

Overload

Sets scope "only this window". Hotkey, autotext and mouse triggers added afterwards will work only when the specified window is active.

public TriggerScope Window(string name = null, string cn = null, WOwner of = default, Func<wnd, bool> also = null, WContains contains = default)

Parameters

name (string)

Window name. Usually it is the title bar text. String format: wildcard expression. null means "can be any". "" means "no name".

cn (string)

Window class name. String format: wildcard expression. null means "can be any". Cannot be "".

of (WOwner)

Owner window, program or thread. Depends on argument type:

wnd - owner window. Will use wnd.IsOwnedBy with level 2.
string - program file name, like "notepad.exe". String format: wildcard expression. Cannot be "" or path.
WOwner - WOwner.Process(process id), WOwner.Thread(thread id).

See wnd.getwnd.Owner, wnd.ProcessId, process.thisProcessId, wnd.ThreadId, process.thisThreadId.

also (Func<wnd, bool>)

Callback function. Called for each matching window. It can evaluate more properties of the window and return true when they match. Example: also: t => !t.IsPopupWindow. Called after evaluating all other parameters except contains.

contains (WContains)

Defines an object that must be in the client area of the window:

UI element: elmFinder or string like "name" or "e 'role' name" or "e 'role'".
Child control: wndChildFinder or string like "c 'cn' name" or "c '' name" or "c 'cn'".
Image(s) or color(s): uiimageFinder or string "image:..." (uses a uiimageFinder with flag IFFlags.WindowDC).
OCR text: ocrFinder or string "ocr:..." (uses an ocrFinder with flag OcrFlags.WindowDC).

Returns

TriggerScope

Returns an object that can be later passed to TriggerScopes.Again to reuse this scope.

Exceptions

ArgumentException

cn is "". To match any, use null.
of is "" or 0 or contains character '\\' or '/'. To match any, use null.
Invalid wildcard expression ("**options " or regular expression).

Examples

TriggerScopes

Overload(top)

Sets scope "only this window". Hotkey, autotext and mouse triggers added afterwards will work only when the specified window is active.

public TriggerScope Window(wndFinder f)

Parameters

f (wndFinder)

Returns

TriggerScope

Returns an object that can be later passed to TriggerScopes.Again to reuse this scope.