Evento Master.BeforeShapeDelete (Visio)Master.BeforeShapeDelete Event (Visio)

Ocorre antes de uma forma ser excluída.Occurs before a shape is deleted.

SintaxeSyntax

Private Sub expressão _ BeforeShapeDelete (Forma ByVal, como [IVSHAPE])Private Sub expression _'BeforeShapeDelete'(ByVal Shape As [IVSHAPE])

expressão Uma variável que representa um objeto Master .expression A variable that represents a Master object.

ParâmetrosParameters

NomeName Obrigatório/OpcionalRequired/Optional Tipo de dadosData type DescriçãoDescription
ShapeShape ObrigatórioRequired [IVSHAPE][IVSHAPE] A forma que será excluída.The shape that is going to be deleted.

ComentáriosRemarks

Um objeto Shape pode servir como o objeto de origem para o evento BeforeShapeDelete se a propriedade Type da forma for visTypeGroup (2) ou visTypePage (1).A Shape object can serve as the source object for the BeforeShapeDelete event if the shape's Type property is visTypeGroup (2) or visTypePage (1).

Os eventos BeforeSelectionDelete e BeforeShapeDelete são semelhantes, pois ambos acionada antes de forma (s) serão excluídos.The BeforeSelectionDelete and BeforeShapeDelete events are similar in that they both fire before shape(s) are deleted. Eles diferenciam no como eles se comportam quando uma única operação exclui várias formas.They differ in how they behave when a single operation deletes several shapes. Suponha que uma operação de Recortar exclui três formas.Suppose a Cut operation deletes three shapes. O evento BeforeShapeDelete disparará três vezes e atua em cada um dos três objetos.The BeforeShapeDelete event fires three times and acts on each of the three objects. O evento BeforeSelectionDelete dispara uma vez, e ele atua em um objeto Selection selecionadas no qual as três formas que você deseja excluir.The BeforeSelectionDelete event fires once, and it acts on a Selection object in which the three shapes that you want to delete are selected.

Se estiver usando o Microsoft Visual Basic ou o Visual Basic for Applications (VBA), a sintaxe deste tópico descreverá uma maneira comum e eficiente de lidar com eventos.If you are using Microsoft Visual Basic or Visual Basic for Applications (VBA), the syntax in this topic describes a common, efficient way to handle events.

Se você deseja criar seus próprios objetos de evento , use o método Add ou AddAdvise .If you want to create your own Event objects, use the Add or AddAdvise method. Para criar um objeto Event que execute um complemento, use o método Add como ele se aplica à coleção EventList .To create an Event object that runs an add-on, use the Add method as it applies to the EventList collection. Para criar um objeto Event que recebe uma notificação, use o método AddAdvise .To create an Event object that receives notification, use the AddAdvise method. Para localizar um código de evento para o evento que você deseja criar, consulte códigos de evento.To find an event code for the event you want to create, see Event codes.

Observação Você pode usar a palavra-chave WithEvents do VBA para coletar o evento BeforeShapeDelete .Note You can use the VBA WithEvents keyword to sink the BeforeShapeDelete event.

Para considerações de desempenho, o conjunto de eventos do objeto Document não inclui o evento BeforeShapeDelete .For performance considerations, the Document object's event set does not include the BeforeShapeDelete event. Para coletar o evento BeforeShapeDelete a partir de um objeto de documento (e do objeto ThisDocument em um projeto do VBA), você deve usar o método AddAdvise .To sink the BeforeShapeDelete event from a Document object (and from the ThisDocument object in a VBA project), you must use the AddAdvise method.