Partager via


Comment : Ajoutez des marqueurs de texte standard

Utilisez la procédure suivante pour créer un des types de marqueur de texte par défaut fournis d'éditeur principal de Visual Studio .

pour créer un marqueur de texte

  • Selon que vous utilisez une ou le système de coordonnées à deux dimensions, appelez la méthode d' CreateLineMarker ou la méthode d' CreateStreamMarker pour créer un marqueur de texte.

    dans cet appel de méthode, spécifiez un type de marqueur, une plage de texte pour créer la marque plus de, et une interface d' IVsTextMarkerClient . Cette méthode retourne ensuite un pointeur vers le marqueur de texte récemment créée. Les types de marqueur sont pris de l'énumération d' MARKERTYPE . Spécifiez une interface d' IVsTextMarkerClient si vous souhaitez être informés des événements de marque.

    Notes

    Créez des marqueurs de texte sur le thread d'interface utilisateur principal uniquement.L'éditeur principal dépend du contenu de la mémoire tampon de texte pour créer des marqueurs de texte et la mémoire tampon de texte n'est pas thread-safe.

ajouter une commande personnalisée

Implémenter l'interface de IVsTextMarkerClient et la fourniture d'un pointeur partir d'une marque améliore le comportement de marque de plusieurs façons. D'abord, cela vous permet de fournir des conseils pour votre marque et d'exécuter des commandes. Cela vous permet également de recevoir des notifications d'événements pour des marques et créer un menu contextuel personnalisé sur la marque. Utilisez la procédure suivante pour ajouter une commande personnalisée au menu contextuel de la marque.

pour ajouter une commande personnalisée au menu contextuel

  1. Avant que le menu contextuel affiché, l'environnement appelle la méthode d' GetMarkerCommandInfo et vous passe un pointeur vers le marqueur de texte affectées et le numéro de l'élément de commande dans le menu contextuel.

    Par exemple, les commandes de point d'arrêt-détail dans le menu contextuel incluent supprimez le point d'arrêt via Nouveau point d'arrêt, comme le montre la capture d'écran suivante.

    Menu contextuel Marqueur

  2. Passez en arrière du texte identifiant le nom de la commande personnalisée. Par exemple, supprimez le point d'arrêt peut être une commande personnalisée si l'environnement ne la fournissait pas déjà. Vous passez également en arrière si la commande est prise en charge, disponible et actif, et/ou une bascule aligner sur. L'environnement utilise ces informations pour afficher la commande personnalisée dans le menu contextuel de la façon correcte.

  3. Pour exécuter la commande, les appels d'environnement la méthode d' ExecMarkerCommand , vous pouvez passer un pointeur vers le marqueur de texte et numéro de la commande sélectionnée dans le menu contextuel.

    Utilisez ces informations de cet appel pour exécuter toute action du marqueur de texte votre commande personnalisée implique.

Voir aussi

Tâches

Comment : implémentez les marques d'erreurs

Comment : Créez des marqueurs de texte personnalisés

Concepts

Comment : marqueurs de texte d'utilisation

Autres ressources

Utilisation des marqueurs de texte avec l'API héritée