Selection Object Members

Article
06/14/2014

Visio Automation Reference

Represents a subset of Shape objects for a page or master to which an operation can be applied.

Methods

	Name	Description
	AddToGroup	Adds the selected shapes to the selected group.
	Align	Aligns two or more selected shapes. Returns Nothing.
	AutomaticLink	Links selected shapes to data rows in the specified data recordset automatically, without requiring you to specify the exact correspondence of all shapes and data rows. Returns the number of shapes linked.
	BoundingBox	Returns a rectangle that tightly encloses the shapes of a selection.
	BreakLinkToData	Breaks links between all shapes in the selection and data rows in the specified data recordset.
	BringForward	Brings the shape or selected shapes forward one position in the z-order.
	BringToFront	Brings the shape or selected shapes to the front of the z-order.
	Combine	Creates a new shape by combining selected shapes.
	ConnectShapes	Connects two or more selected shapes with a dynamic connector. ReturnsNothing.
	ConvertToGroup	Converts a selection or an object from another application (a linked or embedded object) to a group.
	Copy	Copies a selection to the Clipboard.
	Cut	Deletes a selection and places it on the Clipboard.
	Delete	Deletes an object or selection.
	DeselectAll	Deselects all shapes in a window or selection.
	Distribute	Distributes three or more selected shapes at regular intervals on the drawing page. The order of selection is irrelevant. Returns Nothing.
	DrawRegion	Draws a new shape that represents the region containing a given point.
	Duplicate	Duplicates a selection.
	Export	Exports an object from Microsoft Office Visio to a file format such as .bmp, .dib, .dwg, .dxf, .emf, .emz, .gif, .htm, .jpg, .png, .svg, .svgz, .tif, or .wmf.
	FitCurve	Reduces the number of geometry segments in a shape or shapes by replacing them with similar spline, arc, and line segments that approximate the paths of the initial segments. Typically, this reduces the number of segments in the shape.
	Flip	Flips selected shapes either as a group or individually about their pins. Returns Nothing.
	FlipHorizontal	Flips an object horizontally.
	FlipVertical	Flips an object vertically.
	Fragment	Breaks selected shapes into smaller shapes.
	GetIDs	Gets the shape IDs of the shapes in the selection.
	Group	Groups the objects that are selected in a selection, or it converts a shape into a group.
	Intersect	Creates one closed shape from the area in which selected shapes overlap or intersect.
	Join	Creates a new shape by joining selected shapes.
	Layout	Lays out the shapes and/or reroutes the connectors for the page, master, group, or selection.
	LinkToData	Links a selection of shapes to a single data row in a data recordset.
	Move	Moves a selection a specified distance. Returns Nothing.
	Offset	Offsets a selection a specified amount.
	RemoveFromGroup	Removes selected shapes from a group.
	ReverseEnds	Reverses an object by flipping it both horizontally and vertically.
	Rotate	Rotates selected shapes either as a group or individually about their pins.
	Rotate90	Rotates an object 90 degrees counterclockwise.
	Select	Selects or deselects an object.
	SelectAll	Selects all possible shapes in a window or selection.
	SendBackward	Moves a shape or selected shapes back one position in the z-order.
	SendToBack	Moves the shape or selected shapes to the back of the z-order.
	Subtract	Subtracts the areas that overlap the selected shape.
	SwapEnds	Swaps the begin and end points of a one-dimensional (1-D) shape.
	Trim	Trims selected shapes into smaller shapes.
	Ungroup	Ungroups a group.
	Union	Creates a new shape from the perimeter of selected shapes.
	UpdateAlignmentBox	Updates the alignment box for a shape.

Properties

	Name	Description
	Application	Read-only. Returns the instance of Microsoft Office Visio that is associated with an object.
	ContainingMaster	Returns the Master object that contains an object. Read-only.
	ContainingMasterID	Returns the ID of the Master object that contains an object. Read-only.
	ContainingPage	Returns the page that contains an object.
	ContainingPageID	Returns the ID of the page that contains an object. Read-only
	ContainingShape	Returns the Shape object that contains an object or collection. Read-only
	Count	Returns the number of objects in a collection. Read-only.
	DataGraphic	Gets the data graphic master (Master object of type visTypeDataGraphic) of the primary shape in the selection. Sets the data graphic master of all shapes in the selection. Read/write.
	Document	Gets the Document object that is associated with an object. Read-only.
	EventList	Returns the EventList collection of an object or the EventList collection that contains an Event object. Read-only.
	FillStyle	Returns or sets the fill style for an object. Read/write.
	FillStyleKeepFmt	Applies a fill style to an object while preserving local formatting. Read/write.
	Item	Returns an object from a collection. The Item property is the default property for all collections, and for the Path and Selection objects. Read-only.
	ItemStatus	Indicates if an item in a Selection object is subselected, if the group to which it belongs is selected, or if it is the primary item. Read-only.
	IterationMode	Determines whether a Selection object reports subselected shapes and groups in which a shape is selected. Read/write.
	LineStyle	Specifies the line style for an object. Read/write.
	LineStyleKeepFmt	Applies a line style to an object while preserving local formatting. Read/write.
	ObjectType	Returns an object's type. Read-only.
	PersistsEvents	Indicates whether an object is capable of containing persistent events in its EventList collection. Read-only.
	Picture	Returns a picture that represents an enhanced metafile (EMF) contained in a master, shape, selection, or page. Read-only.
	PrimaryItem	Returns the Shape object that is a Selection object's primary item. Read-only.
	Stat	Returns status information for an object. Read-only.
	Style	Gets or sets the style for a Selection object. Read/write.
	StyleKeepFmt	Applies a style to an object while preserving local formatting. Read/write
	TextStyle	Gets or sets the text style for an object. Read/write.
	TextStyleKeepFmt	Applies a text style to an object while preserving local formatting. Read/write.

Selection Object Members

Additional resources