FontFamily クラス

リファレンス

定義

名前空間:: System.Windows.Media

アセンブリ:: PresentationCore.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

関連するフォントのファミリを表します。

public ref class FontFamily

[System.ComponentModel.TypeConverter(typeof(System.Windows.Media.FontFamilyConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.Font)]
public class FontFamily

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Media.FontFamilyConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.Font)>]
type FontFamily = class

Public Class FontFamily

継承: Object
FontFamily

属性: TypeConverterAttribute LocalizabilityAttribute

注釈

フォントファミリは、"Times New Roman" など、同じファミリ名を共有する一連の書体ですが、機能は異なります。これらの機能の違いには、斜体などの、太字Weightなどのが含まれますStyle。

フォントフォント
"Times New Roman" フォントファミリのメンバーである書体の例

や TextBlockなどのButtonほとんどのユーザーインターフェイス (UI) 要素は、コントロールのFontFamilyテキストコンテンツのフォントを指定するために使用できるプロパティを提供します。フォントを定義する場合は、そのプロパティに値を FontFamily 設定します。次の例では、拡張アプリケーションマークアップ言語 (XAML) とコードでフォントを参照する方法を示します。

myTextBlock.FontFamily = new FontFamily("Comic Sans MS");

myTextBlock.FontFamily = New FontFamily("Comic Sans MS")

<TextBlock FontFamily="Comic Sans MS">Hello, world</TextBlock>

前の例では、参照されるフォント "Comic Sans MS" はフレンドリ名で参照されます。また、この例では、フォントはシステムフォントコレクション内にあると見なされます。

代替ディレクトリでのフォントの指定

Windows Presentation Foundation (WPF) アプリケーションでは、フォント参照を解決するために、システムフォントコレクションを含むディレクトリ以外のディレクトリを指定できます。フォントのフレンドリ名では、次の拡張アプリケーションマークアップ言語 (XAML) とコード例に示すように、フォント参照を解決するための絶対 UNIFORM リソース識別子 (URI) 値を指定できます。

// Create a new FontFamily object, using an absolute URI reference.
myTextBlock.FontFamily = new FontFamily("file:///d:/MyFonts/#Pericles Light");

' Create a new FontFamily object, using an absolute URI reference.
myTextBlock.FontFamily = New FontFamily("file:///d:/MyFonts/#Pericles Light")

<TextBlock FontFamily="file:///d:/MyFonts/#Pericles Light">
  Aegean Sea
</TextBlock>

フォントのフレンドリ名では、相対 URI 値を指定することもできます。これには、フォント参照を解決するためのベース URI が必要です。オブジェクトのプロパティは BaseUri 、 FontFamily ベース URI 値に対応します。次のコード例は、ベース URI 値と相対 URI 値で構成されるフォント参照を作成する方法を示しています。

// Create a new FontFamily object, using a base URI reference and a relative URI reference.
myTextBlock.FontFamily = new FontFamily(new Uri("file:///d:/MyFonts/"), "./#Pericles Light");

' Create a new FontFamily object, using a base URI reference and a relative URI reference.
myTextBlock.FontFamily = New FontFamily(New Uri("file:///d:/MyFonts/"), "./#Pericles Light")

基本 URI 値は、アプリケーションの一部としてパッケージ化されたフォントを参照するときに使用できます。たとえば、ベース URI 値には "pack://application" URI を指定できます。これにより、アプリケーションリソースとしてパッケージ化されたフォントを参照できます。次のコード例は、ベース URI 値と相対 URI 値で構成されるフォント参照を示しています。

// The font resource reference includes the base URI reference (application directory level),
// and a relative URI reference.
myTextBlock.FontFamily = new FontFamily(new Uri("pack://application:,,,/"), "./resources/#Pericles Light");

' The font resource reference includes the base URI reference (application directory level),
' and a relative URI reference.
myTextBlock.FontFamily = New FontFamily(New Uri("pack://application:,,,/"), "./resources/#Pericles Light")

FontFamilyがマークアップの属性として指定されている場合、基本 URI 値は常に暗黙的に指定されます。その値は XAML ページの URI です。暗黙的なベース URI 値は、フォントの場所を取得するために、フレンドリ名文字列の相対 URI 値と共に使用されます。次の拡張アプリケーションマークアップ言語 (XAML) の例では、相対 URI 値で "./" 表記が使用されていることに注意してください。これは、ベース URI 値の "現在のフォルダー内" を意味します。

<TextBlock FontFamily="./resources/#Pericles Light">
  Aegean Sea
</TextBlock>

WPF アプリケーションでは、フォントをコンテンツアイテム、リソースアイテム、またはライブラリリソースアイテムとしてパッケージ化できます。詳細については、「アプリケーションでのフォントのパッケージング」を参照してください。

フォントフォールバック

フォントフォールバックは、クライアントアプリケーションによって選択されたフォント以外のフォントの自動置換を指します。フォントフォールバックが呼び出される主な理由は 2 つあります。

クライアントアプリケーションによって指定されたフォントがシステム上に存在しません。
クライアントアプリケーションで指定されたフォントには、テキストのレンダリングに必要なグリフが含まれていません。

WPF では、フォントフォールバックメカニズムでは、代替フォントとして既定のフォールバックフォントファミリ "グローバルユーザーインターフェイス" が使用されます。このフォントは、ファイル名が "GlobalUserInterface.CompositeFont" である複合フォントとして定義されます。複合フォントの詳細については、このトピックの「複合フォント」セクションを参照してください。

WPF フォントフォールバックメカニズムは、以前の Win32 フォント置換テクノロジに置き換えられます。

コードでのフォントフォールバックシーケンスの定義

コードでフォントフォールバックシーケンスを定義できます。これにより、代替フォントを定義できます。オブジェクトを FontFamily 作成するときは、"Comic Sans MS, Verdana" などのパラメーターに複数のフォントファミリ名をコンマで String 区切って指定します。この場合、"Comic Sans MS" タイプフェイスのグリフが使用できない場合は、"Verdana" タイプフェイスのグリフが使用されます。 "Comic Sans MS" と "Verdana" のどちらも必要なグリフがない場合は、書体のフォールバックフォントファミリが使用されます。これは既定では "グローバルユーザーインターフェイス" です。

次の例では、拡張アプリケーションマークアップ言語 (XAML) とコードでフォントフォールバックシーケンスを定義する方法を示します。

myTextBlock.FontFamily = new FontFamily("Comic Sans MS, Verdana");

myTextBlock.FontFamily = New FontFamily("Comic Sans MS, Verdana")

<TextBlock FontFamily="Comic Sans MS, Verdana">Hello, world</TextBlock>

フォールバックシーケンス内の任意のフォントで、フォントの場所を指定できます。次の例では、"Pericles Light" がアプリケーションリソースとして参照され、"Verdana" がシステムフォントコレクションメンバーとして参照されています。

myTextBlock.FontFamily = new FontFamily(new Uri("pack://application:,,,/"), "./resources/#Pericles Light, Verdana");

myTextBlock.FontFamily = New FontFamily(New Uri("pack://application:,,,/"), "./resources/#Pericles Light, Verdana")

<TextBlock FontFamily="./resources/#Pericles Light, Verdana">Aegean Sea</TextBlock>

複合フォント

WPF プラットフォームには、全範囲の多言語フォントを構築し、不足しているグリフを表示しないようにするための複合フォント機能が用意されています。複合フォントは、Win32 フォントリンク、フォントフォールバック、フォントバインド、フォント関連付け、エンドユーザー定義文字 (EUDC) メカニズムに置き換わります。

複合フォントファミリは、他のフォントファミリと同様に、 FontFamily および Typeface コンストラクターを使用してアプリケーションで使用できます。各複合フォントファミリには名前が付けられ、他のフォントと同様に、複数の言語でその名前のローカライズされたバリエーションを提供できます。

次のマークアップの例は、複合フォントファミリをディスクファイルとして定義する方法を示しています。このファイルは、インストールされている他のフォントと同様に、既定の Windows フォントディレクトリに格納することも、名前でファミリを参照するときに URI を含めることで任意の場所で参照することもできます。

次の例は、のフォントファミリマークアップを示しています。CompositeFont" ファイル。

<FontFamily
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/composite-font"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:System="clr-namespace:System;assembly=mscorlib"
    Baseline="0.9"
    LineSpacing="1.2">

    <!-- Name mapping -->
    <FontFamily.FamilyNames>
        <System:String x:Key="en-US">Global User Interface</System:String>
    </FontFamily.FamilyNames>

    <!-- Faces to report in font chooser UI -->
    <FontFamily.FamilyTypefaces>
        <FamilyTypeface
            Weight="Normal" Stretch="Normal" Style="Normal"
            UnderlinePosition="-0.1" UnderlineThickness="0.05"
            StrikethroughPosition="0.3" StrikethroughThickness="0.05"
            CapsHeight="0.5" XHeight="0.3" />

        <FamilyTypeface
            Weight="Bold" Stretch="Normal" Style="Normal"
            UnderlinePosition="-0.1" UnderlineThickness="0.05"
            StrikethroughPosition="0.3" StrikethroughThickness="0.05"
            CapsHeight="0.5" XHeight="0.3" />
    </FontFamily.FamilyTypefaces>

    <!-- Character to family lookups (in lookup order) -->
    <FontFamily.FamilyMaps>

        <!--
            Basic Latin                 0000-007F
            Latin-1 Supplement          0080-00FF
            Latin Extended-A            0100-017F
            Latin Extended-B            0180-024F
            IPA Extensions              0250-02AF
            Spacing Modifier Letters    02B0-02FF 
            Combining Diacritics Marks  0300-036F 
            Greek and Coptic            0370-03FF
            Cyrillic                    0400-04FF 
            Cyrillic Supplement         0500-052F 
            Phonetic Extensions         1D00-1D7F
            Latin Extended Additional   1E00-1EFF
            Greek Extended              1F00-1FFF
            Alpha Pres Forms Latin      FB00-FB0F -->
        <!-- CHS -->    
        <FontFamilyMap
            Unicode="0000-052F, 1D00-1FFF, FB00-FB0F"
            Language="zh-Hans"
            Target="Times New Roman"
            Scale="1.0" />
        <!-- CHT -->    
        <FontFamilyMap
            Unicode="0000-052F, 1D00-1FFF, FB00-FB0F"
            Language="zh-Hant"
            Target="Times New Roman"
            Scale="1.0" />
        <!-- Other (include JA and KO) -->    
        <FontFamilyMap
            Unicode="0000-052F, 1D00-1FFF, FB00-FB0F"
            Target="Comic Sans MS, Verdana"
            Scale="4.0" />

        <!--
            Armenian                    0530-058F    
            Georgian                    10D0-10FF
            Alpha Pres Forms Armenian   FB10-FB1C -->
        <FontFamilyMap
            Unicode="0530-058F, 10D0-10FF, FB10-FB1C"
            Target="Sylfaen"
            Scale="1.0" />

        <!-- Other FontFamilyMap elements defined ... --> 

    </FontFamily.FamilyMaps>

</FontFamily>

WPF インストールの一部として、既定の Windows フォントディレクトリに次の 4 つの複合フォントが表示されます。

フォント	メモ
GlobalMonospace.CompositeFont	ラテン文字の "Courier New" など、モノスペースフォントを使用してテキストをレンダリングします。
GlobalSanSerif.CompositeFont	sans serif フォント (ラテン文字の場合は "Arial" など) を使用してテキストをレンダリングします。
GlobalSerif.CompositeFont	セリフフォント (ラテン文字の "Times New Roman" など) を使用してテキストをレンダリングします。
GlobalUserInterface.CompositeFont	既定のフォント (ラテン文字の "Times New Roman" など) を使用してテキストをレンダリングします。

XAML 属性の使用方法

<object FontFamily="fontFamilyName"/>  
- or -  
<object FontFamily="fontFamilyNamesList"/>  
- or -  
<object FontFamily="fontFamilyFolderReference"/>  
- or -  
<object FontFamily="fontFamilyUriReference"/>

XAML 値

fontFamilyName
フォントファミリ名を指定する文字列。たとえば、"Arial" または "Century Gothic" です。

fontFamilyNamesList
複数のフォントファミリ名を指定する文字列。それぞれコンマで区切られます (コンマの後の空白は無視されます)。指定された最初のフォントファミリは、プライマリフォントファミリとして機能します。以降のフォントファミリは、プライマリフォントファミリが使用できない場合や適用できない場合に使用するフォールバックファミリとして機能します。たとえば、 "Arial, Century Gothic" Arial をプライマリフォントファミリとして指定し、Century Gothic をフォールバックフォントファミリとして指定します。

fontFamilyFolderReference
フォントを含むフォルダーとフォントファミリ名を指定する文字列。フォルダーとフォントファミリ名は、 # 文字で区切られます。フォルダー参照は、絶対参照または相対参照である場合があります。たとえば、「 "Custom Fonts\#My Custom Font" 」のように入力します。

fontFamilyUriReference
フォントの UNIFORM リソース識別子 (URI) とフォントファミリ名を指定する文字列。 URI とフォントファミリ名は、 # 文字で区切られます。たとえば、「 "http://MyFontServer/Fonts/#My Custom Font" 」のように入力します。

コンストラクター

FontFamily()	匿名の FontFamily クラスの新しいインスタンスを初期化します。
FontFamily(String)	指定したフォントファミリ名から、FontFamily クラスの新しいインスタンスを初期化します。
FontFamily(Uri, String)	指定したフォントファミリ名およびオプションの基本 Uniform Resource Identifier (URI) の値から FontFamily クラスの新しいインスタンスを初期化します。

プロパティ

Baseline	ベースラインと文字セルの上端との間の距離を取得または設定します。
BaseUri	フォントファミリ名を解決するために使用される基本 Uniform Resource Identifier (URI) を取得します。
FamilyMaps	FontFamilyMap オブジェクトのコレクションを取得します。
FamilyNames	CultureInfo オブジェクトのフォントファミリ名を表す文字列と FontFamily 値のコレクションを取得します。
FamilyTypefaces	FontFamily オブジェクトのタイプフェイスのコレクションを取得します。
LineSpacing	FontFamily オブジェクトの行間隔の値を取得または設定します。行間隔は、全角サイズを基準とする、このフォントのテキストに対して推奨されるベースライン間の距離です。
Source	FontFamily オブジェクトを構築するために使用されるフォントファミリ名を取得します。

メソッド

Equals(Object)	現在のフォントファミリオブジェクトと、指定したフォントファミリオブジェクトが同じであるかどうかを示す値を取得します。
GetHashCode()	FontFamily のハッシュ関数として機能します。ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetTypefaces()	既定のシステムフォントの場所にあるタイプフェイスを表す Typeface オブジェクトのコレクションを返します。
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	Source プロパティの値を返します。

適用対象

こちらもご覧ください

Fonts

次の方法で共有

FontFamily クラス

定義

注釈

代替ディレクトリでのフォントの指定

フォントフォールバック

コードでのフォントフォールバックシーケンスの定義

複合フォント

XAML 属性の使用方法

XAML 値

コンストラクター

プロパティ

メソッド

適用対象

こちらもご覧ください

その他のリソース

次の方法で共有

FontFamily クラス

定義

注釈

代替ディレクトリでのフォントの指定

フォント フォールバック

コードでのフォント フォールバック シーケンスの定義

複合フォント

XAML 属性の使用方法

XAML 値

コンストラクター

プロパティ

メソッド

適用対象

こちらもご覧ください

その他のリソース

フォントフォールバック

コードでのフォントフォールバックシーケンスの定義