Evento Shape.TextChanged (Visio)
Ocorre após o texto de uma forma ser alterado em um documento.
Sintaxe
expressão. TextChanged (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 cujo texto foi alterado. |
Comentários
O evento TextChanged é disparado quando o texto não acabado de uma forma é alterado, como quando os caracteres que o Microsoft Visio armazena para a forma são alterados. Se os caracteres de uma forma mudam porque um usuário está digitando, o evento TextChanged não é disparado até que a sessão de edição de texto seja encerrada.
Quando um campo é adicionado ou removido do texto de uma forma, seu texto não acabado é alterado; portanto, um evento TextChanged é disparado. No entanto, nenhum evento TextChanged é disparado quando o texto de um campo é alterado. Por exemplo, uma forma possui um campo de texto que exibe sua largura. Um evento TextChanged não é disparado quando a largura da forma é alterada, porque o texto não acabado armazenado para a forma não foi alterado, mesmo que o texto aparente (expandido) da forma não seja alterado. Use o evento CellChanged para uma das células na seção Text Fields para detectar quando o texto de um campo é alterado.
Para acessar o texto não acabado de uma forma, use a propriedade Text. Para acessar o texto de uma forma na qual campos de texto foram expandidos, use a propriedade Characters.Text. Você pode determinar o local e as propriedades dos campos de texto em um texto da forma usando o objeto Shape.Characters.
No Visio 5.0 e em versões anteriores, os caracteres não acabados relatados pela propriedade Text para um campo incluíam quatro caracteres, sendo que o primeiro era o caractere de escape. A partir do Visio 2000, apenas um único caractere de escape está presente na sucessão de texto não acabado.
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 variáveis WithEvents do VBA para afundar o evento TextChanged .
Para obter considerações sobre o desempenho, o conjunto do evento do objeto Document não inclui o evento TextChanged. Para afundar o evento TextChanged de um objeto Document (e do objeto ThisDocument em um projeto VBA), você deve usar o método AddAdvise .
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.