::hwp::GetClient

Gets a client handle.

Syntax

::hwp::GetClient

Application

HyperWorks Tcl Query

Description

This procedure implements minus options.

This procedure returns a client handle of HyperGraph/HyperView/MotionView.

If no page ID is given, then it operates on the current/active page.

If no window ID is given, then it returns the client of the active window.

Use GetClient function to check for a particular client type. To do this, use the option "-type". If the check fails, then an error is returned.

The option "-byHandle" is an exclusive option (no other minus options are allowed).

Mandatory Arguments

None.

Optional Arguments

-page "pageID"
The page ID of the requested page.
-window "windowID"
The window ID of the requested window.
-type "client type"
A client type. The requested client is checked for this client type. If this check fails, an error is returned.
-byHandle "handle"
A handle created with this tool and which contains a page and window ID.

Returns

Returns a client handle.

Examples

set clientHandle1 [::hwp::GetClient -page 2 -window 4]
set activeClientHandle [::hwp::GetClient]