適用於 Visual Studio 的字型和格式設定

發行項
01/13/2024

環境字型

Visual Studio 中的所有字型都必須公開給用戶以進行自定義。這主要是透過 [工具>選項] 對話方塊中的 [字型和色彩] 頁面來完成。字型設定的三個主要類別如下：

環境字型 - IDE 的主要字 型（集成開發環境），用於所有介面元素，包括對話框、功能表、工具視窗和文檔視窗。根據預設，環境字型會系結至目前 Windows 版本中顯示為 9 pt Segoe UI 的系統字型。針對所有介面元素使用一個字型有助於確保整個 IDE 的字型外觀一致。
文字編輯器 - 可在 [工具>選項] 的 [文字編輯器] 頁面中自定義程式代碼和其他以文字為基礎的編輯器中呈現的專案。
特定集合 - 提供使用者自定義介面元素的設計視窗，可能會在 [工具選項] 的 [ 工具 > 選項] 中，公開其設計介面專屬的字型。

編輯器字型自定義和重設大小

使用者通常會根據使用者的喜好設定，放大或縮放編輯器中文字的大小和/或色彩，與一般使用者介面無關。由於環境字型用於可能出現在編輯器/設計工具內或做為編輯器/設計工具一部分的專案上，因此當其中一個字型分類變更時，請務必注意預期的行為。

建立出現在編輯器中但不屬於 內容的UI元素時，請務必使用環境字型，而不是文字字型，讓元素以可預測的方式重設大小。

針對編輯器中的程式碼文字，請使用程式碼文字字型設定重設大小，並響應編輯器文本的縮放層級。
介面的所有其他元素都應該系結至環境字型設定，並響應環境中的任何全域變更。其中包括 (但不限於)：
- 操作功能表中的文字
- 編輯器裝飾中的文字，例如燈泡菜單文字、快速尋找編輯器窗格，以及瀏覽至窗格
- 對話框中的標籤文字，例如 [在檔案 中尋找] 或 [重構]

存取環境字型

在 Native 或 WinForms 程式代碼中，環境字型可以在從SID_SUIHostLocale服務查詢介面之後呼叫方法IUIHostLocale::GetDialogFont來存取。

針對 Windows Presentation Foundation （WPF），請從殼層的 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
{
}

（以目前版本的 MPF dll 取代 Microsoft.VisualStudio.Shell.11.0 。

若要顯示對話框，請在類別ShowDialog()上呼叫 “ShowModal() ” ShowModal() 會設定殼層中正確的強制回應狀態、確保對話框置中於父視窗等等。

程式碼如下所示：

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

ShowModal 會傳回bool？（可為 Null 的布爾值）與 DialogResult，如有需要可以使用。如果對話框以OK關閉，則傳回值為 true。

如果您需要顯示一些不是對話框且載入於自己的 HwndSourceWPF UI，例如 Win32/WinForms 父視窗的彈出視窗或 WPF 子視窗，則必須在 WPF 元素的根元素上設定 FontFamily 和 FontSize 。（殼層會在主視窗上設定屬性，但不會繼承超過。HWND 殼層會提供屬性可以系結的資源，如下所示：

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