Propriedade Characters.Text (Visio)

Retorna o intervalo de texto representado por um objeto Characters, que pode ser um subconjunto do texto da forma, dependendo dos valores das propriedades End e Begin do objeto Characters. Leitura/gravação.

Sintaxe

expressão. Texto

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

Valor de retorno

Variant

Comentários

O texto de um objeto Characters é retornado em uma Variant do tipo String e não em uma String. Normalmente, isso é transparente se você estiver usando o Microsoft Visual Basic.

No texto retornado por um objeto Characters, os campos são expandidos para o número de caracteres visíveis na janela de desenho. Por exemplo, se o texto de uma forma contiver um campo de texto que exibe o nome do arquivo de um desenho, a propriedade Text de um objeto Characters retornará o nome expandido do arquivo (contanto que as propriedades Begin e End não tenham sido alteradas).

Se um objeto Characters representar o texto de uma forma que é um grupo, ele sempre retornará o texto do grupo.

Os objetos provenientes de outros aplicativos e guias não possuem uma propriedade Text.

Se sua solução do Visual Studio incluir a referência Microsoft.Office.Interop.Visio , essa propriedade será mapeada para os seguintes tipos:

• Microsoft.Office.Interop.Visio.IVCharacters.Text

Exemplo

Esta macro VBA (Microsoft Visual Basic for Applications) mostra como obter a propriedade Text de um objeto Characters.

 
Public Sub CharactersText_Example()  
 
    Dim vsoOval As Visio.Shape  
    Dim vsoCharacters As Visio.Characters  
 
    'Create a shape and add text. 
    Set vsoOval = ActivePage.DrawOval(2, 5, 5, 7)  
    vsoOval.Text = "Oval Shape"  
 
    'Get a Characters object from the shape. 
    Set vsoCharacters = vsoOval.Characters  
 
    'Get the text from the Characters object. 
    Debug.Print vsoCharacters.Text  
 
End Sub

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.