PickObjectsInRectangle Method (GoDocument)

Return a collection of objects that are surrounded by a given rectangle.

Syntax

Visual Basic
C#

'Declaration
 
Public Function PickObjectsInRectangle( _
   ByVal rect As RectangleF, _
   ByVal pickstyle As GoPickInRectangleStyle, _
   ByVal coll As IGoCollection, _
   ByVal max As Integer _
) As IGoCollection

public IGoCollection PickObjectsInRectangle( 
   RectangleF rect,
   GoPickInRectangleStyle pickstyle,
   IGoCollection coll,
   int max
)

Parameters

rect: A RectangleF in document coordinates.
pickstyle: If GoPickInRectangleStyle.SelectableOnlyContained or GoPickInRectangleStyle.SelectableOnlyIntersectsBounds, only consider objects for which GoObject.CanSelect is true.
coll: An IGoCollection that is modified by adding results and then returned. If this value is null, a GoCollection is allocated and returned.
max: A limit on the number of objects to be found and added to the result collection.

Return Value

The coll argument, or a newly allocated one if that was null.

Remarks

This basically calls GoLayer.GoLayer.PickObjectsInRectangle on each layer in this document. If pickstyle is GoPickInRectangleStyle.SelectableOnlyContained and CanSelectObjects is false, this will not add any objects to the result collection.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

GoDocument Class
GoDocument Members