Partager via


Modifier les ajustements d'affichage à l'aide de l'API héritée

Les paramètres de l'éditeur principal fonctionnalité, telle que le retour automatique à la ligne, la marge de sélection, et l'espace virtuel, peut être modifié par l'utilisateur au moyen de la boîte de dialogue d' Options . Toutefois, il est également possible de modifier ces paramètres par programmation.

Modifier les paramètres à l'aide de l'API héritée

L'interface d' IVsTextEditorPropertyCategoryContainer expose un jeu de propriétés de l'éditeur de texte. L'affichage de texte contient une catégorie de propriétés (GUID_EditPropCategory_View_MasterSettings) qui représente le groupe de paramètres modifiés par programme pour l'affichage de texte. Une fois que les ajustements d'affichage ont été modifiés de cette façon, ils ne peuvent pas être modifiés dans la boîte de dialogue d' Options jusqu'à ce qu'ils sont réinitialisés.

Voici le processus habituel pour modifier les ajustements d'affichage pour une instance du éditeur principal.

  1. appelez QueryInterface sur (VsTextView) pour l'interface d' IVsTextEditorPropertyCategoryContainer .

  2. Appelez la méthode d' GetPropertyCategory , en spécifiant une valeur de GUID_EditPropCategory_View_MasterSettings pour le paramètre d' rguidCategory .

    De cette façon retourne un pointeur vers l'interface d' IVsTextEditorPropertyCategoryContainer , qui contient l'ensemble de propriétés de liaison pour la vue. Tous les paramètres à ce groupe sont définitivement convertis. Si un paramètre n'est pas à ce groupe, il effectue les options spécifiées dans la boîte de dialogue d' Options ou les ordres de l'utilisateur.

  3. Appelez la méthode d' SetProperty , en spécifiant la valeur appropriée de paramètres dans le paramètre d' idprop .

    par exemple, pour forcer le retour automatique à la ligne, l' SetProperty d'appel et spécifier une valeur de VSEDITPROPID_ViewLangOpt_WordWrap, vt pour le paramètre d' idprop . Dans cet appel, vt est a VARIANT du type VT_BOOL et vt.boolVal est VARIANT_TRUE.

Réinitialiser les ajustements d'affichage modifiés

Pour réinitialiser tout ajustement d'affichage modifié pour une instance du éditeur principal, appeler la méthode d' RemoveProperty et spécifier la valeur appropriée de paramètre dans le paramètre d' idprop .

par exemple, pour permettre au retour automatique à la ligne pour flotter librement, vous le supprimeriez de la catégorie de propriété RemoveProperty appelant et en spécifiant une valeur de VSEDITPROPID_ViewLangOpt_WordWrap pour le paramètre d' idprop .

Pour supprimer tous les paramètres modifiés pour l'éditeur principal immédiatement, spécifiez une valeur de VSEDITPROPID_ViewComposite_AllCodeWindowDefaults, VT pour le paramètre d' idprop . Dans cet appel, le VT est a VARIANT du type VT_BOOL et vt.boolVal est VARIANT_TRUE.

Voir aussi

Référence

Options, boîte de dialogue (Visual Studio)

Concepts

Vue d'accès de theText à l'aide de l'API héritée

Autres ressources

À l'intérieur de le éditeur principal