Show / Hide Table of Contents

Method TriggerScopes.NotWindow(+ 1 overload)


Overload

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

public TriggerScope NotWindow(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 "not this window". Hotkey, autotext and mouse triggers added afterwards will not work when the specified window is active.

public TriggerScope NotWindow(wndFinder f)
Parameters
f  (wndFinder)
Returns
TriggerScope

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