Visual Studio 的字体和格式

项目
10/10/2023

环境字体

Visual Studio 中的所有字体都必须向用户公开以供自定义。这主要通过“工具选项”对话框中的“字体和颜色”页完成。 > 字体设置的三个主要类别包括：

环境字体 - IDE（集成开发环境）的主字体，用于所有界面元素，包括对话框、菜单、工具窗口和文档窗口。默认情况下，环境字体绑定到当前版本的 Windows 中显示为 9 pt Segoe UI 的系统字体。对所有界面元素使用一种字体有助于确保整个 IDE 中的字体外观一致。
文本编辑器 - 可以在“工具>选项”中的“文本编辑器”页中自定义代码和其他基于文本的编辑器中显示的元素。
特定集合 - 提供用户自定义界面元素的设计器窗口可能会在“工具>选项”的自己的设置页中公开特定于其设计图面的字体。

编辑器字体自定义和调整大小

用户通常会根据用户偏好（独立于常规用户界面）放大或缩放编辑器中文本的大小和/或颜色。由于环境字体用于可能出现在编辑器/设计器中或作为编辑器/设计器的一部分的元素，因此当其中一种字体分类发生更改时，请务必注意预期行为。

创建显示在编辑器中但不属于 内容的 UI 元素时，必须使用环境字体，而不是文本字体，以便元素以可预测的方式调整大小。

对于编辑器中的代码文本，请使用代码文本字体设置调整大小，并响应编辑器文本的缩放级别。
接口的所有其他元素都应绑定到环境字体设置，并响应环境中的任何全局更改。这包括但不限于：
- 上下文菜单中的文本
- 编辑器装饰中的文本，如灯泡菜单文本、快速查找编辑器窗格和导航到窗格
- 对话框中的标签文本，例如 “在文件中 查找”或 “重构”

访问环境字体

在 Native 或 WinForms 代码中，可以通过从SID_SUIHostLocale服务查询接口后调用方法IUIHostLocale::GetDialogFont来访问环境字体。

对于 Windows Presentation Foundation （WPF），请从 shell 的 DialogWindow 类而不是 WPF 类 Window 派生对话窗口类。

在 XAML 中，代码如下所示：

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

代码隐藏：

internal partial class WebConfigModificationWindow : DialogWindow
{
}

（替换为 Microsoft.VisualStudio.Shell.11.0 MPF dll 的当前版本。

若要显示对话框，请通过ShowDialog()对类调用“ShowModal()”。 ShowModal() 在 shell 中设置正确的模式状态，确保对话居中以父窗口为中心，依如此。

代码如下所示:

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

ShowModal 返回布尔值？（可为 null 的布尔值）与 DialogResult（如果需要）。如果对话框已关闭且正常，则返回值为 true。

如果需要显示一些不是对话框且托管在其自身HwndSource的 WPF UI，例如 Win32/WinForms 父窗口的弹出窗口或 WPF 子窗口，则需要设置 FontFamily WPF 元素的根元素。FontSize （shell 设置主窗口上的属性，但它们不会继承过 a HWND）。 shell 提供属性可绑定到的资源，如下所示：

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

格式设置（缩放/加粗）参考

某些对话框要求特定文本为粗体或环境字体以外的其他大小。以前，大于环境字体的字体被编码为“”environment font +2或类似字体。使用提供的代码片段将支持高 DPI 监视器，并确保显示文本始终以正确的大小和重量（如浅色或半光）显示。

注意

在应用格式设置之前，请确保遵循文本样式中的指南。**

若要缩放环境字体，请按指示设置 TextBlock 或 Label 的样式。这些代码片段（正确使用）将生成正确的字体，包括适当的大小和粗细变化。

其中“vsui”是对命名空间 Microsoft.VisualStudio.Shell的引用：

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