Visual Studio のフォントと書式設定

[アーティクル]
03/10/2023

適用対象:Visual Studio Visual Studio for Mac Visual Studio Code

環境フォント

Visual Studio 内のすべてのフォントは、カスタマイズのためにユーザーに公開する必要があります。これは主に、[ツール] > [オプション] ダイアログの [フォントおよび色] ページを使用して行います。フォント設定には、主に次の 3 つのカテゴリがあります。

環境フォント - IDE (統合開発環境) 用のプライマリフォントで、ダイアログ、メニュー、ツールウィンドウ、ドキュメントウィンドウなど、すべてのインターフェイス要素に使用されます。既定では、環境フォントは、現在のバージョンの Windows では 9 ポイントの Segoe UI で表示されるシステムフォントに関連付けられています。すべてのインターフェイス要素に 1 つのフォントを使用すると、IDE 全体で一貫したフォントの外観を確保できます。
テキストエディター - コードやその他のテキストベースエディターに表示される要素は、[ツール] > [オプション] の [テキストエディター] ページでカスタマイズできます。
特定のコレクション - ユーザーがインターフェイス要素をカスタマイズできるデザイナーウィンドウでは、そのデザインサーフェイスに固有のフォントを、[ツール] > [オプション] にある独自の設定ページで公開できます。

エディターのフォントのカスタマイズとサイズ変更

一般的なユーザーインターフェイスとは別に、ユーザーが自分の好みに合わせてエディター内でテキストの拡大縮小や色の変更を行うことはよくあります。環境フォントは、エディターやデザイナー内で、またはそれらの一部として表示される可能性がある要素で使用されるため、これらのフォント分類のいずれかが変更されたときに予想される動作に注意することは重要です。

エディターに表示されるがコンテンツの一部ではない UI 要素を作成するときは、要素のサイズを変更しても動作が予測できるよう、テキストフォントではなく環境フォントを使用することが重要です。

エディター内のコードテキストについては、コードテキストのフォント設定でサイズを変更し、エディターテキストのズームレベルに応答します。
インターフェイスの他のすべての要素は、環境のフォント設定に関連付けられて環境のグローバルな変更に応答するようにしします。たとえば、次のようなものが挙げられます。
- コンテキストメニュー内のテキスト
- エディターの表示要素内のテキスト (電球メニューのテキスト、クイック検索エディターペイン、ナビゲーションペインなど)
- ダイアログボックス内のラベルテキスト ( [フォルダーを指定して検索] や [リファクター] など)

環境フォントへのアクセス

ネイティブまたは WinForms コードで、環境フォントには、SID_SUIHostLocale サービスからインターフェイスをクエリした後に IUIHostLocale::GetDialogFont メソッドを呼び出してアクセスできます。

Windows Presentation Foundation (WPF) の場合、ダイアログウィンドウクラスは、WPF の Window クラスではなくシェルの DialogWindow クラスから派生させます。

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 の現在のバージョンに置き換えます。)

ダイアログを表示するには、クラスの "ShowModal()" を ShowDialog() よりも優先して呼び出します。 ShowModal() は、正しいモーダル状態をシェルで設定し、親ウィンドウなどの中でダイアログが中央に位置するようにします。

コードは次のとおりです。

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

ShowModal は bool? (null 許容ブール値) を DialogResult と共に返します (後者は必要に応じて使用できます)。ダイアログが [OK] で閉じられた場合、戻り値は true です。

ダイアログではなく、その独自の HwndSource でホストされる何らかの WPF 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"