Polices et mise en forme pour Visual Studio

Article
10/10/2023

Police d’environnement

Toutes les polices de Visual Studio doivent être exposées à l’utilisateur pour la personnalisation. Cette opération s’effectue principalement via la page Polices et couleurs dans la boîte de dialogue Options des outils>. Les trois principales catégories de paramètres de police sont les suivantes :

Police d’environnement : police principale de l’IDE (environnement de développement intégré), utilisée pour tous les éléments d’interface, y compris les dialogues, les menus, les fenêtres d’outils et les fenêtres de document. Par défaut, la police d’environnement est liée à une police système qui apparaît sous forme d’interface utilisateur Segoe 9 pts dans les versions actuelles de Windows. L’utilisation d’une police pour tous les éléments d’interface permet de garantir une apparence de police cohérente dans l’IDE.
Éditeur de texte : les éléments qui s’affichent dans le code et d’autres éditeurs basés sur du texte peuvent être personnalisés dans la page Éditeur de texte dans options d’outils>.
Collections spécifiques : les fenêtres de concepteur qui offrent une personnalisation utilisateur de leurs éléments d’interface peuvent exposer des polices spécifiques à leur aire de conception dans leur propre page de paramètres dans options d’outils>.

Personnalisation et redimensionnement de la police de l’éditeur

Les utilisateurs agrandissent ou zooment souvent la taille et/ou la couleur du texte dans l’éditeur en fonction de leur préférence, indépendamment de l’interface utilisateur générale. Étant donné que la police d’environnement est utilisée sur les éléments qui peuvent apparaître dans ou dans le cadre d’un éditeur/concepteur, il est important de noter le comportement attendu lorsque l’une de ces classifications de polices est modifiée.

Lors de la création d’éléments d’interface utilisateur qui apparaissent dans l’éditeur, mais qui ne font pas partie du contenu, il est important d’utiliser la police d’environnement et non la police de texte afin que les éléments soient redimensionnés de manière prévisible.

Pour le texte du code dans l’éditeur, redimensionnez avec le paramètre de police du texte du code et répondez au niveau de zoom de l’éditeur.
Tous les autres éléments de l’interface doivent être liés au paramètre de police d’environnement et répondre à toutes les modifications globales de l’environnement. Ce sont notamment les suivantes :
- Texte dans les menus contextuels
- Texte dans un ornement de l’éditeur, tel que le texte du menu ampoule, le volet d’éditeur de recherche rapide et accéder au volet
- Étiqueter du texte dans les boîtes de dialogue, comme Rechercher dans des fichiers ou refactoriser

Accès à la police d’environnement

Dans le code Natif ou WinForms, la police d’environnement est accessible en appelant la méthode IUIHostLocale::GetDialogFont après avoir interrogé l’interface à partir du SID_SUIHostLocale service.

Pour Windows Presentation Foundation (WPF), dérivez votre classe de fenêtre de boîte de dialogue de la classe de l’interpréteur de DialogWindow commandes au lieu de la classe de Window WPF.

En XAML, le code ressemble à ceci :

<ui:DialogWindow
    x:Class"MyNameSpace.MyWindow"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:s="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:ui="clr-namespace:Microsoft.VisualStudio.PlatformUI;assembly=Microsoft.VisualStudio.Shell.11.0"
    ShowInTaskbar="False"
    WindowStartupLocation="CenterOwner"
    Title="My Dialog">
</ui:DialogWindow>

Code behind :

internal partial class WebConfigModificationWindow : DialogWindow
{
}

(Remplacez Microsoft.VisualStudio.Shell.11.0 par la version actuelle de la dll MPF.)

Pour afficher la boîte de dialogue, appelez «ShowModal() » sur la classe sur ShowDialog(). ShowModal() définit l’état modal correct dans l’interpréteur de commandes, garantit que la boîte de dialogue est centrée dans la fenêtre parente, et ainsi de suite.

Le code se présente comme suit :

MyWindow window = new MyWindow();
window.ShowModal()

ShowModal retourne un bool ? (booléen nullable) avec le DialogResult, qui peut être utilisé si nécessaire. La valeur de retour est true si la boîte de dialogue a été fermée avec OK.

Si vous devez afficher une interface utilisateur WPF qui n’est pas une boîte de dialogue et qui est hébergée dans sa propre HwndSourcefenêtre contextuelle, par exemple une fenêtre contextuelle ou une fenêtre enfant WPF d’une fenêtre parente Win32/WinForms, vous devez définir l’élément FontFamily FontSize racine de l’élément WPF. (L’interpréteur de commandes définit les propriétés sur la fenêtre principale, mais elles ne seront pas héritées d’un HWND). L’interpréteur de commandes fournit des ressources auxquelles les propriétés peuvent être liées, comme suit :

<Setter Property="FontFamily" Value="{DynamicResource VsFont.EnvironmentFontFamily}" />
<Setter Property="FontSize" Value="{DynamicResource VsFont.EnvironmentFontSize}" />

Référence de mise en forme (mise à l’échelle/gras)

Certaines boîtes de dialogue nécessitent un texte particulier en gras ou une taille autre que la police d’environnement. Auparavant, les polices supérieures à la police d’environnement étaient codées comme «environment font +2 » ou similaires. L’utilisation des extraits de code fournis prend en charge les moniteurs haute résolution et garantit que le texte d’affichage s’affiche toujours à la taille et au poids corrects (comme Light ou Semilight).

Remarque

Avant d’appliquer la mise en forme, vérifiez que vous suivez les instructions trouvées dans le style texte.**

Pour mettre à l’échelle la police d’environnement, définissez le style du TextBlock ou de l’étiquette comme indiqué. Chacun de ces extraits de code, correctement utilisés, génère la police correcte, y compris la taille appropriée et les variations de poids.

Où «vsui » est une référence à l’espace de noms Microsoft.VisualStudio.Shell:

xmlns:vsui="clr-namespace:Microsoft.VisualStudio.Shell;assembly=Microsoft.VisualStudio.Shell.14.0"