ViewInfo.Caption プロパティ

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

プロパティ値

フォーム定義ファイル (.xsf) でビューに関連付けられた xsf:view 要素の caption 属性の値。

注釈

既定では、xsf:view 要素の caption 属性の値は、InfoPath フォーム テンプレートのデザイン モードでビューを作成した際に付けた名前と同じです。 その結果、 Caption プロパティは既定で プロパティと同じ値を Name 返します。

Caption プロパティを使用すると、次の 2 つのシナリオに容易に対応できます。

• ビューの名前のローカライズされたバージョンを作成するには。 フォーム テンプレート ファイルをソース ファイルとして保存し ([ファイル] メニューの [ソース ファイルとして保存] )、フォーム定義ファイル (.xsf) を手動で編集して、xsf:view 要素のキャプション属性の値を変更して、ビューにローカライズされた名前を付けることができます。 その後、 Caption プロパティを使用してローカライズされた名前を返すことができます。
• InfoPath が別のアプリケーションまたはInfoPath Forms Servicesの FormViewControl で FormControl を使用してコントロールとしてホストされている場合、キャプション属性の値を使用してビューを切り替えるためのドロップダウン リストを作成できます。 たとえば、選択項目が変更されたときに、ドロップダウン リストのコントロールは FormControl.XmlForm.ViewInfos.SwitchView() メソッドで、ユーザー インターフェイス テキストの Caption プロパティで返されるローカライズされた値ではなく、Name プロパティで返されるビューの名前の値を使用してビューを切り替えます。

重要: プロパティを使用してビューの名前をメソッドに SwitchView(String) 渡す場合は、 Name プロパティによって返される値のみを使用する必要があります。

適用対象