Propriété Characters.Text (Visio)

Article
04/07/2023

Renvoie la plage de texte représentée par un objet Characters, qui peut être un sous-ensemble du texte de la forme en fonction des valeurs des propriétés Begin et End de l’objet Characters. Lecture/écriture.

Syntaxe

expression. Texte

Expression Variable qui représente un objet Characters .

Valeur renvoyée

Variant

Remarques

Le texte d'un objet Characters est renvoyé dans un élément Variant de type String, et non dans un élément String. Ceci est particulièrement frappant si vous utilisez Microsoft Visual Basic.

Dans le texte renvoyé par un objet Characters, les champs sont étendus au nombre de caractères visibles dans la fenêtre de dessin. Par exemple, si le texte d'une forme contient un champ qui affiche le nom de fichier d'un dessin, la propriété Text d'un objet Characters renvoie le nom de fichier étendu (à condition de ne pas avoir modifié les propriétés Begin et End).

Si un objet Characters représente le texte d'une forme constituée d'un groupe, il renverra toujours le texte du groupe.

Les objets issus d'autres applications et les repères n'ont pas de propriété Text.

Si votre solution Visual Studio inclut la référence Microsoft.Office.Interop.Visio , cette propriété correspond aux types suivants :

Microsoft.Office.Interop.Visio.IVCharacters.Text

Exemple

Cette macro Microsoft Visual Basic pour Applications (VBA) indique comment obtenir la propriété Text d'un objet 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

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.

Partager via