Étiquette d'aide du volet Actions, exemple

Mise à jour : novembre 2007

Remarque :
Cet exemple s'exécute uniquement dans Microsoft Office Excel 2007 et Microsoft Office Word 2007.

Cet exemple inclut un contrôle qui fournit une aide contextuelle dynamique sur un volet Actions pour un document ou une feuille de calcul contenant des régions mappées en XML. Le contrôle s'associe automatiquement au schéma XML et utilise des annotations de schéma comme texte d'aide. Lorsqu'un utilisateur place le point d'insertion dans une région qui contient un nœud XML, le contrôle affiche le nom de région et le texte d'annotation associés. Le développeur peut utiliser les propriétés du contrôle pour indiquer ce qui se produit lorsqu'une région n'a pas de texte d'annotation.

Le contrôle possède quatre propriétés que vous pouvez configurer pour déterminer ce qu'affiche le contrôle s'il n'existe pas de texte d'annotation. Ces propriétés apparaissent dans la fenêtre Propriétés, dans une section appelée Contenu.

• UseAncestorAnnotation
  Spécifie si le contrôle doit afficher le texte d'annotation de la région ancêtre la plus proche si aucun texte n'est défini pour la région sélectionnée.

• AnnotationType
  Détermine si le type d'élément ou l'annotation de nom d'élément est affiché.

• PlaceholderText
  Le texte que le contrôle affiche s'il n'existe pas d'annotation.

• ShowLocationName
  Décide si le nom de la région apparaît dans le contrôle Help Label.

Il existe une solution avec trois projets dans l'exemple Étiquette d'aide : un projet de bibliothèque de contrôle, un projet de document Word et un projet de classeur Excel. Les projets Word et Excel montrent comment utiliser le contrôle. À mesure que vous cliquez dans les différentes zones du document ou de la feuille de calcul, l'Étiquette d'aide affiche le texte extrait de la région de schéma XML associée.

Note de sécurité :

Cet exemple de code est destiné à illustrer un concept et affiche uniquement le code correspondant. Il peut ne pas répondre aux exigences de sécurité d'un environnement spécifique et ne doit pas être utilisé tel quel. Nous vous conseillons d'ajouter un code de gestion des erreurs et de sécurité afin de renforcer la sécurité et la fiabilité de vos projets. Microsoft fournit cet exemple de code « EN L'ÉTAT », sans garantie d'aucune sorte.

Pour plus d'informations sur l'installation de l'exemple de projet sur votre ordinateur, consultez Comment : installer et utiliser des fichiers d'exemple figurant dans l'aide.

Download sample

Pour exécuter cet exemple

• Appuyez sur F5.

Démonstrations

Cet exemple montre comment créer un contrôle utilisateur et l'incorporer dans un projet, et comment répondre aux événements dans des régions mappées en XML.

Voir aussi

Concepts

Schémas et données XML (Visual Studio Tools pour Office)

Vue d'ensemble du volet Actions

Procédures pas à pas relatives à la personnalisation de l'interface utilisateur

Autres ressources

Exemples au niveau du document