Proprietà ViewInfo.Caption

Ottiene il valore dell'attributo caption dell'elemento xsf:view associato alla visualizzazione nel file di definizione del modulo, con estensione xsf.

Spazio dei nomi: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Sintassi

Public MustOverride ReadOnly Property Caption As String

Dim instance As ViewInfo
Dim value As String

value = instance.Caption

public abstract string Caption { get; }

Valore proprietà

Valore dell'attributo caption dell'elemento xsf:view associato alla visualizzazione nel file di definizione del modulo, con estensione xsf.

Osservazioni

Per impostazione predefinita, il valore dell'attributo caption dell'elemento xsf:view corrisponde al nome assegnato alla visualizzazione al momento della sua creazione in modalità progettazione del modello di modulo di InfoPath. Di conseguenza, per impostazione predefinita la proprietà Caption restituisce lo stesso valore della proprietà Name.

La proprietà Caption può essere utilizzata per semplificare i due scenari seguenti:

• Per creare una versione localizzata del nome di una visualizzazione. È possibile salvare i file del modello di modulo come file di origine, scegliendo Salva come file di origine dal menu File, e quindi modificare manualmente il file di definizione del modulo, con estensione xsf, per cambiare il valore dell'attributo caption di un elemento xsf:view al fine di assegnare alla visualizzazione un nome localizzato. È quindi possibile utilizzare la proprietà Caption per restituire il nome localizzato.

• Quando InfoPath è ospitato come controllo utilizzando l'oggetto FormControl in un'altra applicazione o nell'oggetto FormViewControl in InfoPath Forms Services, il valore dell'attributo caption può essere utilizzato per creare un elenco a discesa che consenta di cambiare la visualizzazione. Se, ad esempio l'elemento selezionato viene modificato, tramite il controllo elenco a discesa viene utilizzato il metodo FormControl.XmlForm.ViewInfos.SwitchView() per cambiare la visualizzazione utilizzando il nome restituito dalla proprietà Name, mentre per il testo dell'interfaccia utente viene utilizzato il valore localizzato restituito dalla proprietà Caption.

Importante:
Quando si utilizza una proprietà per passare il nome di una visualizzazione al metodo SwitchView(String), utilizzare solo il valore restituito dalla proprietà Name.

Vedere anche

Riferimenti

Classe ViewInfo
Membri ViewInfo
Spazio dei nomi Microsoft.Office.InfoPath