ViewInfo.Caption-Eigenschaft
Ruft den Wert des caption-Attributs des xsf:view-Elements ab, das der Ansicht in der Formulardefinitionsdatei (XSF) zugeordnet ist.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustOverride ReadOnly Property Caption As String
Get
'Usage
Dim instance As ViewInfo
Dim value As String
value = instance.Caption
public abstract string Caption { get; }
Eigenschaftswert
Typ: System.String
Der Wert des caption-Attributs des xsf:view-Elements, das der Ansicht in der Formulardefinitionsdatei (XSF) zugeordnet ist.
Hinweise
Standardmäßig ist der Wert des caption-Attributs des xsf:view-Elements mit dem Namen gleich, den die Ansicht beim Erstellen im InfoPath-Entwurfsmodus für Formularvorlagen erhalten hat. Daher gibt die Caption-Eigenschaft standardmäßig denselben Wert wie die Name-Eigenschaft zurück.
Die Caption-Eigenschaft kann zum Vereinfachen der folgenden beiden Szenarien verwendet werden:
Zum Erstellen einer lokalisierten Version des Namens einer Ansicht. Sie können die Formularvorlagendateien als Quelldateien speichern (Als Quelldateien speichern im Menü Datei) und die Formulardefinitionsdatei (XSF) dann manuell bearbeiten, um den Wert des caption-Attributs eines xsf:view-Elements zu ändern und der Ansicht einen lokalisierten Namen zu geben. Danach kann die Caption-Eigenschaft verwendet werden, um den lokalisierten Namen zurückzugeben.
Wenn InfoPath mithilfe des FormControl-Objekts in einer anderen Anwendung oder im FormViewControl-Objekt in InfoPath Forms Services als Steuerelement gehostet wird, kann der Wert des caption-Attributs verwendet werden, um eine Dropdownliste zum Wechseln der Ansichten zu erstellen. Wenn beispielsweise das ausgewählte Element geändert wird, verwendet das Dropdownlisten-Steuerelement die FormControl.XmlForm.ViewInfos.SwitchView()-Methode zum Wechseln der Ansichten mithilfe des Ansichtsnamenswertes, der von der Name-Eigenschaft zurückgegeben wird, jedoch mithilfe des lokalisierten Wertes, der von der Caption-Eigenschaft zurückgegeben wird, für den Benutzeroberflächentext.
Wichtig
Wenn Sie eine Eigenschaft verwenden, um den Namen einer Ansicht an die SwitchView(String)-Methode zu übergeben, sollten Sie nur den Wert verwenden, der von der Name-Eigenschaft zurückgegeben wird.