BeforeSelectionDelete Event [Visio 2003 SDK Documentation]

  • Article

Occurs before selected objects are deleted.

Private Subobject_BeforeSelectionDelete(ByVal Selection As IVSelection)

object     The WithEvents object that receives the event.

Version added

4.1

Remarks

A Shape object can serve as the source object for the BeforeSelectionDelete event if the shape's Type property is visTypeGroup(2) or visTypePage(1).

The BeforeSelectionDelete event indicates that selected shapes are about to be deleted. This notification is sent whether or not any of the shapes are locked; however, locked shapes aren't deleted. To find out if a shape is locked against deletion, check the value of its LockDelete cell.

The BeforeSelectionDelete and BeforeShapeDelete events are similar in that they both fire before shape(s) are deleted. They differ in how they behave when a single operation deletes several shapes. Suppose a Cut operation deletes three shapes. The BeforeShapeDelete event fires three times and acts on each of the three objects. The BeforeSelectionDelete event fires once, and it acts on a Selection object in which the three shapes that you want to delete are selected.

If you're using Microsoft Visual Basic or Visual Basic for Applications (VBA), the syntax in this topic describes a common, efficient way to handle events.

If you want to create your own Event objects, use the Add or AddAdvise method. To create an Event object that runs an add-on, use the Add method as it applies to the EventList collection. To create an Event object that receives notification, use the AddAdvise method. To find an event code for the event you want to create, see Event codes.

Applies to | Application object | Document object | Documents collection | InvisibleApp object | Master object | Masters collection | Page object | Pages collection | Shape object

See Also | Action property | AddAdvise method | BeforeShapeDelete event | BeforeWindowSelDelete event | ConvertToGroupCanceled event | Event object | EventList collection | QueryCancelConvertToGroup event | QueryCancelSelectionDelete event | QueryCancelUngroup event | SelectionDeleteCanceled event | UngroupCanceled event