Compartilhar via


Evento Shape.BeforeShapeDelete (Visio)

Ocorre antes de uma forma ser excluída.

Sintaxe

expressão. BeforeShapeDelete (Shape)

Expressão Uma variável que representa um objeto Shape .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Formato Obrigatório [IVSHAPE] A forma que será excluída.

Comentários

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).

Os eventos BeforeSelectionDelete e BeforeShapeDelete são semelhantes pois são disparados antes que a(s) forma(s) seja(m) excluída(s). Eles diferem na maneira em que se comportam quando uma única operação exclui várias formas. Suponha que uma operação Cut exclua três formas. O evento BeforeShapeDelete é disparado três vezes e age em cada um dos três objetos. O evento BeforeSelectionDelete é disparado uma vez e age em um objeto Selection no qual as três formas que você deseja excluir são selecionadas.

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.

Se você quiser criar seus próprios objetos Event , use o método Add ou AddAdvise .

Para criar um objeto Event que execute um complemento, use o método Add, uma vez que ele aplica-se à coleção EventList.

Para criar um objeto Event que receba notificação, use o método AddAdvise.

Para localizar um código de evento que você deseja criar, consulte Códigos de eventos.

Observação

Use a palavra-chave VBA WithEvents para afundar o evento BeforeShapeDelete .

Para obter considerações sobre o desempenho, o conjunto do evento do objeto Document não inclui o evento BeforeShapeDelete. Para afundar o evento BeforeShapeDelete de um objeto Document (e do objeto ThisDocument em um projeto VBA), você deve usar o método AddAdvise .

Se a solução do Visual Studio incluir a referência Microsoft.Office.Interop.Visio , este evento será mapeado para os seguintes tipos:

  • Microsoft.Office.Interop.Visio.EShape_BeforeShapeDeleteEventHandler (o delegado BeforeShapeDelete .)

  • Microsoft.Office.Interop.Visio.EShape_Event.BeforeShapeDelete (o evento BeforeShapeDelete .)

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.