Table of contents
TOC
Recolher sumário
Expandir sumário

Evento Documents.BeforeShapeDelete (Visio)Documents.BeforeShapeDelete Event (Visio)

office 365 dev account|Última Atualização: 22/03/2018
|
2 Colaboradores

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

SintaxeSyntax

Private Sub expressãoBeforeShapeDelete( **_Forma ByVal, como [IVSHAPE]** )Private Sub expressionBeforeShapeDelete( **_ByVal Shape As [IVSHAPE]** )

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

ParâmetrosParameters

NomeNameObrigatório/opcionalRequired/OptionalTipo de dadosData TypeDescriçãoDescription
FormaShapeObrigató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. Eles diferenciam no como eles se comportam quando uma única operação exclui várias formas. Suponha que uma operação de Recortar exclui três formas. O evento BeforeShapeDelete disparará três vezes e atua em cada um dos três objetos. 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 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.

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 . Para criar um objeto Event que execute um complemento, use o método Add como ele se aplica à coleção EventList . Para criar um objeto Event que recebe uma notificação, use o método AddAdvise . Para localizar um código de evento para o evento que você deseja criar, consultecódigos de evento.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, seeEvent 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 . 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 .For performance considerations, the Document object's event set does not include the BeforeShapeDelete event. To sink the BeforeShapeDelete event from a Document object (and from the ThisDocument object in a VBA project), you must use the AddAdvise method.

© 2018 Microsoft