Písma a formátování pro Visual Studio

Článek
10/10/2023

Písmo prostředí

Všechna písma v sadě Visual Studio musí být zpřístupněna uživateli pro přizpůsobení. To se provádí především prostřednictvím stránky Písma a barvy v dialogovém okně Možnosti nástrojů>. Existují tři hlavní kategorie nastavení písma:

Písmo prostředí – primární písmo integrovaného vývojového prostředí (integrované vývojové prostředí), které se používá pro všechny prvky rozhraní, včetně dialogů, nabídek, oken nástrojů a oken dokumentů. Ve výchozím nastavení je písmo prostředí vázané na systémové písmo, které se v aktuálních verzích Windows zobrazuje jako uživatelské rozhraní Segoe 9 bodů. Použití jednoho písma pro všechny prvky rozhraní pomáhá zajistit konzistentní vzhled písma v celém integrovaném vývojovém prostředí ( IDE).
Textový editor – prvky, které se zobrazí v kódu a dalších textových editorech, lze přizpůsobit na stránce Textový editor v možnostech nástroje>.
Konkrétní kolekce – okna návrháře, která nabízejí přizpůsobení prvků rozhraní uživatelům, mohou zveřejnit písma specifická pro návrhovou plochu na vlastní stránce nastavení v možnostech nástrojů>.

Přizpůsobení a změna velikosti písma editoru

Uživatelé často zvětší nebo zvětší velikost a/nebo barvu textu v editoru podle svých preferencí, nezávisle na obecném uživatelském rozhraní. Vzhledem k tomu, že se písmo prostředí používá u prvků, které se můžou objevit v editoru nebo návrháři, je důležité poznamenat očekávané chování při změně některé z těchto klasifikací písem.

Při vytváření prvků uživatelského rozhraní, které se zobrazují v editoru, ale nejsou součástí obsahu, je důležité použít písmo prostředí, nikoli písmo textu, aby se prvky změnily předvídatelným způsobem.

U textu kódu v editoru změňte velikost pomocí nastavení písma textu kódu a odpovězte na úroveň přiblížení textu editoru.
Všechny ostatní prvky rozhraní by měly být svázané s nastavením písma prostředí a reagovat na všechny globální změny v prostředí. To zahrnuje (mimo jiné):
- Text v kontextových nabídkách
- Text v doplňku editoru, například text nabídky žárovky, podokno editoru rychlého hledání a přechod do podokna
- Označení textu v dialogových oknech, jako je Hledání v souborech nebo refaktoring

Přístup k písmu prostředí

V kódu Native nebo WinForms je písmo prostředí přístupné voláním metody IUIHostLocale::GetDialogFont po dotazování rozhraní ze SID_SUIHostLocale služby.

Pro Windows Presentation Foundation (WPF) odvozujte třídu okna dialogového okna z třídy prostředí DialogWindow místo třídy WPF Window .

Kód v XAML vypadá takto:

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

Kód za:

internal partial class WebConfigModificationWindow : DialogWindow
{
}

(Nahraďte Microsoft.VisualStudio.Shell.11.0 aktuální verzí knihovny MPF dll.)

Chcete-li zobrazit dialogové okno, zavolejte "ShowModal()" v třídě nad ShowDialog(). ShowModal() nastaví správný modální stav v prostředí, zajistí, že je dialogové okno zarovnané na střed v nadřazeném okně atd.

Kód je následující:

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

ShowModal vrátí bool? (Logická hodnota s možnou DialogResulthodnotou null) s hodnotou , kterou lze v případě potřeby použít. Vrácená hodnota je true, pokud bylo dialogové okno uzavřeno s OK.

Pokud potřebujete zobrazit nějaké uživatelské rozhraní WPF, které není dialogové okno a je hostované ve své vlastní , HwndSourcenapříklad automaticky otevírané okno nebo podřízené okno WPF nadřazeného okna Win32/WinForms, budete muset nastavit FontFamily a FontSize na kořenovém prvku elementu WPF. (Prostředí nastaví vlastnosti v hlavním okně, ale nebudou zděděny za ).HWND Prostředí poskytuje prostředky, ke kterým mohou být vlastnosti vázány, například takto:

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

Referenční informace k formátování (škálování nebo tučné písmo)

Některá dialogová okna vyžadují, aby byl konkrétní text tučný nebo jiný než písmo prostředí. Dříve byla písma větší než písmo prostředí kódované jako "environment font +2" nebo podobné. Použití zadaných fragmentů kódu bude podporovat monitory s vysokým rozlišením DPI a zajistit, aby se zobrazovaný text vždy zobrazoval ve správné velikosti a hmotnosti (například Light nebo Semilight).

Poznámka:

Než použijete formátování, ujistěte se, že používáte pokyny uvedené ve stylu textu.**

Pokud chcete škálovat písmo prostředí, nastavte styl objektu TextBlock nebo Popisek, jak je uvedeno. Každý z těchto fragmentů kódu, který se správně používá, vygeneruje správné písmo, včetně odpovídajících variant velikosti a hmotnosti.

Kde "vsui" je odkaz na obor názvů Microsoft.VisualStudio.Shell:

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