Compartilhar via


ViewInfo.Caption Propriedade

Definição

Obtém o valor do atributo legenda do elemento xsf:view associado à exibição no arquivo de definição de formulário (.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

Valor da propriedade

O valor do atributo legenda do elemento xsf:view associado à exibição no arquivo de definição de formulário (.xsf)

Comentários

Por padrão, o valor do atributo legenda do elemento xsf:view é o mesmo que o nome dado ao modo de exibição quando ele foi criado no modo de design de modelo de formulário InfoPath. Como resultado, a propriedade Caption retornará o mesmo valor que a Name propriedade por padrão.

A propriedade Caption pode ser usada para facilitar dois cenários:

  • Para criar uma versão localizada do nome de uma exibição. Você pode salvar os arquivos de modelo de formulário como arquivos de origem (Salvar Como Arquivos de Origem no menu Arquivo) e, em seguida, editar o arquivo de definição de formulário (.xsf) para alterar o valor do atributo legenda de um elemento xsf:view para dar à exibição um nome localizado. Depois disso, a propriedade Caption pode ser usada para retornar o nome localizado.
  • Quando o InfoPath é hospedado como um controle usando o FormControl em outro aplicativo ou no FormViewControl no InfoPath Forms Services, o valor do atributo legenda pode ser usado para criar uma lista suspensa para alternar exibições. Por exemplo, quando o item selecionado for alterado, o controle de lista suspensa usaria o método FormControl.XmlForm.ViewInfos.SwitchView() para alternar exibições usando o valor do nome de exibição retornado pela propriedade Name , mas usando o valor localizado retornado pela propriedade Caption para texto da interface do usuário.

Importante: ao usar uma propriedade para passar o nome de uma exibição para o SwitchView(String) método, você só deve usar o valor retornado pela propriedade Name .

Aplica-se a