Freigeben über

ViewInfo.Caption Eigenschaft

  • Referenz

Definition

Namespace:
Microsoft.Office.InfoPath
Assembly:
Microsoft.Office.InfoPath.dll

Ruft den Wert des caption-Attributs des xsf:view-Elements ab, das der Ansicht in der Formulardefinitionsdatei (XSF) zugeordnet ist.

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

Eigenschaftswert

String

Der Wert des caption-Attributs des xsf:view-Elements, das 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 als Steuerelement mit FormControl in einer anderen Anwendung oder in FormViewControl auf InfoPath Forms Services gehostet wird, kann der Wert des attributs Untertitel verwendet werden, um eine Dropdownliste zum Wechseln von 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 Sicht an die SwitchView(String) Methode zu übergeben, sollten Sie nur den von der Name-Eigenschaft zurückgegebenen Wert verwenden.

Gilt für: