ViewInfo.Caption Propriété

Définition

Espace de noms:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Obtient la valeur de l'attribut caption de l'élément xsf:view associé à la vue dans le fichier de définition du formulaire (.xsf).

public:
 abstract property System::String ^ Caption { System::String ^ get(); };

public abstract string Caption { get; }

member this.Caption : string

Public MustOverride ReadOnly Property Caption As String

Valeur de propriété

String

La valeur de l'attribut caption de l'élément xsf:view associé à la vue dans le fichier de définition du formulaire (.xsf).

Remarques

Par défaut, la valeur de l'attribut caption de l'élément xsf:view est le nom donné à la vue lors de sa création en mode Création dans InfoPath. Par conséquent, la propriété Caption retourne la même valeur que la Name propriété par défaut.

La propriété Caption peut être utilisée dans deux cas de figure :

• Pour créer une version traduite du nom d'une vue. Vous pouvez enregistrer les fichiers des modèles de formulaire sous forme de fichiers source (Enregistrer en tant que fichiers source dans le menu Fichier), puis modifier directement le fichier de définition de formulaire (.xsf) pour changer la valeur de l'attribut caption d'un élément xsf:view pour donner un nom traduit à la vue. La propriété Caption peut ensuite être utilisée pour renvoyer le nom modifié.
• Quand InfoPath est hébergé en tant que contrôle à l’aide de FormControl dans une autre application ou dans formViewControl sur InfoPath Forms Services, la valeur de l’attribut légende peut être utilisée pour créer une liste déroulante pour changer d’affichage. Par exemple, lorsque l'élément sélectionné est changé, la liste déroulante utilise la méthode FormControl.XmlForm.ViewInfos.SwitchView() pour basculer entre les vues à l'aide de la valeur de nom de vue renvoyée par la propriété Name, en utilisant cependant la valeur traduite renvoyée par la propriété Caption pour le texte affiché.

Important : Lorsque vous utilisez une propriété pour transmettre le nom d’une vue à la SwitchView(String) méthode, vous devez utiliser uniquement la valeur retournée par la propriété Name .