Esempio Help Label per il riquadro delle azioni

Aggiornamento: novembre 2007

Nota:
Questo esempio viene eseguito solo in Microsoft Office Excel 2007 e Microsoft Office Word 2007.

In questo esempio è incluso un controllo che fornisce una guida dinamica e sensibile al contesto per un riquadro delle azioni relativo a un documento o a un foglio di lavoro che contiene aree con mapping XML. Il controllo viene associato automaticamente allo schema XML e utilizza le annotazioni dello schema come testo della guida. Quando un utente posiziona il punto di inserimento in un'area che contiene un nodo XML, il controllo consente di visualizzare il nome dell'area e il testo di annotazione associati. Lo sviluppatore può utilizzare le proprietà del controllo per indicare l'operazione che viene eseguita quando a un'area non è associato un testo di annotazione.

Il controllo è dotato di quattro proprietà che è possibile impostare per determinare il contenuto visualizzato in assenza di testo dell'annotazione. Tali proprietà sono elencate nella finestra Proprietà, all'interno di una sezione denominata Contenuto.

• UseAncestorAnnotation
  Specifica se il controllo deve visualizzare il testo dell'annotazione dell'area predecessore più vicina nel caso in cui nella regione selezionata non se sia stato specificato uno.

• AnnotationType
  Consente di determinare se viene visualizzata l'annotazione relativa al tipo dell'elemento o al nome dell'elemento.

• PlaceholderText
  Testo visualizzato dal controllo in assenza di annotazioni.

• ShowLocationName
  Viene attivato se il nome dell'area appare nel controllo Help Label.

Nell'esempio di Help Label è contenuta una soluzione con tre progetti: un progetto Libreria di controlli, un progetto Documento di Word e un progetto Cartella di lavoro di Excel. Nei progetti di Word ed Excel viene illustrato come utilizzare il controllo. Quando si fa clic sulle diverse aree del documento o del foglio di lavoro, il controllo Help Label consente di visualizzare il testo dell'area dello schema XML associata.

Nota sulla sicurezza:

Il codice di esempio riportato di seguito è finalizzato alla descrizione di un concetto e ne viene illustrata solo la parte pertinente al concetto in questione. È possibile che non soddisfi i requisiti di sicurezza per un ambiente specifico ed è opportuno non utilizzarlo esattamente in questo formato. È consigliabile aggiungere codice di sicurezza e di gestione degli errori per rendere i progetti più sicuri e affidabili. Microsoft fornisce questo codice di esempio "COSÌ COME È", senza garanzie.

Per informazioni sull'installazione del progetto di esempio nel computer, vedere Procedura: installare e utilizzare i file di esempio presenti nella Guida.

Download sample

Per eseguire l'esempio

• Premere F5.

Dimostrazione

In questo esempio viene illustrato come creare un controllo utente e incorporarlo in un progetto e come rispondere agli eventi nelle aree con mapping XML.

Vedere anche

Concetti

Schemi e dati XML (Visual Studio Tools per Office)

Cenni preliminari sul riquadro delle azioni

Procedure dettagliate di personalizzazione dell'interfaccia utente

Altre risorse

Esempi a livello di documento