abHiFindMarker

abHiFindMarker(
[ w_windowID ]
)
=> t / nil

Description

In the specified window, selects the row corresponding to a marker in the Annotation Browser when the corresponding marker object is clicked in the layout canvas. Even though the marker object is selected in the layout canvas, this does not modify the selection in the canvas. If the corresponding marker is not displayed in the Annotation Browser due to the applied filtering, nothing is selected in the Annotation Browser. If a window ID is not specified, the current window is used.

Arguments

w_windowID

ID of the window for which the marker clicked in the layout canvas needs to be found in the Annotation Browser.

Value Returned

t	The command was successful.
nil	The command was canceled.

Example

abHiFindMarker(hiGetCurrentWindow())

Uses the current window to locate in Annotation Browser the marker that corresponds to the marker object clicked in the layout canvas.

Additional Information

The abHiFindMarker enter function does not modify the canvas selection. For example, if you select some shapes and instances in the layout canvas and then want to check the corresponding marker, you can invoke the abHiFindMarker enter function and click the marker object in the layout canvas. This selects the corresponding marker in the Annotation Browser, but in the layout canvas, it will still be the shapes and instances that are selected, not the marker object.

In some cases, such as when the applied Annotation Browser filters prevent the marker from displaying or when the marker exists outside of the display depth set for the Annotation Browser, the marker clicked in the layout canvas is not selected in the Annotation browser at all. In this case, if a marker was previously selected in the Annotation Browser, it is deselected and no new marker is selected in the Annotation Browser.

Related Topics

Incomplete Net Filter

Annotation Browser Assistant

Return to top