Czcionki i formatowanie dla programu Visual Studio

Artykuł
01/13/2024

Czcionka środowiska

Wszystkie czcionki w programie Visual Studio muszą być widoczne dla użytkownika w celu dostosowania. Odbywa się to głównie za pośrednictwem strony Czcionki i kolory w oknie dialogowym Opcje narzędzi>. Trzy główne kategorie ustawień czcionek to:

Czcionka środowiska — czcionka podstawowa dla środowiska IDE (zintegrowanego środowiska projektowego), używana dla wszystkich elementów interfejsu, w tym okien dialogowych, menu, okien narzędzi i okien dokumentów. Domyślnie czcionka środowiska jest powiązana z czcionką systemową, która jest wyświetlana jako 9 pkt Segoe UI w bieżących wersjach systemu Windows. Użycie jednej czcionki dla wszystkich elementów interfejsu pomaga zapewnić spójny wygląd czcionki w całym środowisku IDE.
Edytor tekstu — elementy, które są dostępne w kodzie i innych edytorach opartych na tekście, można dostosować na stronie Edytor tekstu w obszarze Opcje narzędzi>.
Określone kolekcje — okna projektanta, które oferują dostosowywanie przez użytkownika swoich elementów interfejsu, mogą uwidaczniać czcionki specyficzne dla ich powierzchni projektowej na stronie własnych ustawień w obszarze Opcje narzędzi>.

Dostosowywanie i zmienianie rozmiaru czcionki edytora

Użytkownicy często powiększają lub powiększają rozmiar i/lub kolor tekstu w edytorze zgodnie z ich preferencjami, niezależnie od ogólnego interfejsu użytkownika. Ponieważ czcionka środowiska jest używana w elementach, które mogą pojawiać się w edytorze/projektancie, należy pamiętać o oczekiwanym zachowaniu w przypadku zmiany jednej z tych klasyfikacji czcionek.

Podczas tworzenia elementów interfejsu użytkownika, które są wyświetlane w edytorze, ale nie są częścią zawartości, ważne jest, aby używać czcionki środowiska, a nie czcionki tekstowej, aby elementy zmieniały rozmiar w przewidywalny sposób.

W przypadku tekstu kodu w edytorze zmień rozmiar przy użyciu ustawienia czcionki tekstu kodu i odpowiadaj na poziom powiększenia tekstu edytora.
Wszystkie inne elementy interfejsu powinny być powiązane z ustawieniem czcionki środowiska i reagować na wszelkie globalne zmiany w środowisku. Obejmuje to (ale nie tylko):
- Tekst w menu kontekstowym
- Tekst w edytorze ozdobiony tekstem menu żarówki, okienkiem szybkiego znajdowania edytora i przejdź do okienka
- Etykieta tekstu w oknach dialogowych, takich jak Znajdź w plikach lub Refaktoryzacja

Uzyskiwanie dostępu do czcionki środowiska

W kodzie Native lub WinForms można uzyskać dostęp do czcionki środowiska, wywołując metodę IUIHostLocale::GetDialogFont po wykonaniu SID_SUIHostLocale zapytania o interfejs z usługi.

W przypadku programu Windows Presentation Foundation (WPF) utwórz klasę okna dialogowego z klasy powłoki DialogWindow zamiast klasy WPF Window .

W języku XAML kod wygląda następująco:

<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>

Kod za:

internal partial class WebConfigModificationWindow : DialogWindow
{
}

(Zastąp Microsoft.VisualStudio.Shell.11.0 ciąg bieżącą wersją biblioteki DLL MPF).

Aby wyświetlić okno dialogowe, wywołaj metodę "ShowModal()" w klasie za pośrednictwem ShowDialog()metody . ShowModal() Ustawia prawidłowy stan modalny w powłoce, zapewnia, że okno dialogowe jest wyśrodkowane w oknie nadrzędnym itd.

Kod jest następujący:

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

ShowModal zwraca wartość logiczną? (wartość logiczna dopuszczana do wartości null) z wartością DialogResult, która może być używana w razie potrzeby. Wartość zwracana ma wartość true, jeśli okno dialogowe zostało zamknięte z ok.

Jeśli musisz wyświetlić jakiś interfejs użytkownika WPF, który nie jest dialogiem i jest hostowany we własnym HwndSourceoknie , takim jak okno podręczne lub okno podrzędne WPF okna nadrzędnego Win32/WinForms, należy ustawić FontFamily element i FontSize na elemenie głównym elementu WPF. (Powłoka ustawia właściwości w oknie głównym, ale nie będą dziedziczone obok obiektu HWND). Powłoka udostępnia zasoby, z którymi można powiązać właściwości, w następujący sposób:

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

Odwołanie do formatowania (skalowanie/pogrubienie)

Niektóre okna dialogowe wymagają pogrubienia określonego tekstu lub rozmiaru innego niż czcionka środowiska. Wcześniej czcionki większe niż czcionka środowiska były kodowane jako "environment font +2" lub podobne. Użycie podanych fragmentów kodu będzie obsługiwać monitory o wysokiej rozdzielczości DPI i upewnić się, że tekst wyświetlany zawsze jest wyświetlany przy prawidłowym rozmiarze i wadze (na przykład światło lub średnik).

Uwaga

Przed zastosowaniem formatowania upewnij się, że przestrzegasz wskazówek znalezionych w stylu tekstu.**

Aby skalować czcionkę środowiska, ustaw styl kontrolki TextBlock lub Label zgodnie z opisem. Każdy z tych fragmentów kodu, prawidłowo używany, wygeneruje poprawną czcionkę, w tym odpowiednie zmiany rozmiaru i wagi.

Gdzie "vsui" jest odwołaniem do przestrzeni nazw Microsoft.VisualStudio.Shell:

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