Click or drag to resize

IMcGraphOverlay2Select Method

Select one or all graphic objects or a group of objects.

Namespace:  MediaCy.IQL.Display.Overlays
Assembly:  MediaCy.IQL.Display.Overlays (in MediaCy.IQL.Display.Overlays.dll) Version: 10.0.6912.0
Syntax
VB
Copy
Sub Select ( 
	<OptionalAttribute> Selection As Object,
	Optional AllowMultiple As Boolean = false
)

Parameters

Selection (Optional)
Type: SystemObject
Either missing, Nothing, a McGraphObj or a rectangle. If Missing or Nothing then all objects with the mcgsAllowSelect Sytle bit are selected if the AllowMultiple argument is supplied as TRUE. If missing or Nothing and the AllowMultiple argument is supplied as FALSE, then all objects are deselected. If a single McGraphObj is given then the specified object is selected; other objects will be deselected unless the AllowMultiple argument is supplied as TRUE. If a rectangle is supplied (as either a SINGLERECT or an array of 4 values in the order left,top,right,bottom), then it is treated as a rectangle in image coordinates within which to invert the selection of all objects with the the mcgsAllowSelect Sytle bit ("invert the selection" means that selected objects within the rectangle become deselected and vice versa). The AllowMultiple argument is forced to true in this case.
AllowMultiple (Optional)
Type: SystemBoolean
Allow multiple selection. The default value is False, but this is effectively forced True if the Selection is a rectangle. It also controls what happens when a Missing or Nothing argument is supplied; if AllowMultiple is true, then all objects are selected; if it is false, then no objects are selected (i.e., all objects are deselected).

Implements

IMcGraphOverlaySelect(Object, Boolean)
Remarks
When an object is selected, its handles are drawn as well. When a rectangle is used for Selection, it can be a SINGLERECT structure or an array of 4 float (Single in VB) values. These values are all in image coordinates.
Note Note
Even though SINGLERECT is the natural rectangle type for the Selection argument, it may also be supplied as an array of 4 values of any numeric type or as a LONGRECT or DOUBLERECT. The ObjectSelected notifications are always sent with the NotifyContext mcgoncFromTool bit off. If you want to signal to nofify sinks that the Select call is from a user interface element (e.g., a tool), then assign mcgoncFromUser to the NotifyContext property just before calling Select.
See Also