アプリケーションでのフォントのパッケージング

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ここでは、Windows Presentation Foundation (WPF) アプリケーションでフォントをパッケージ化する方法の概要について説明します。

メモ :
多くの種類のソフトウェアと同様に、フォントファイルは、販売されるのではなくライセンスされます。フォントの使用を管理するライセンスはベンダによって異なりますが、Microsoft がアプリケーションや Windows で提供しているフォントをカバーするライセンスも含めて、通常、ほとんどのライセンスは、フォントをアプリケーションに埋め込んだり、別の方法で再頒布したりすることを許可していません。したがって、アプリケーションに埋め込む、または別の方法で再頒布するフォントについて、必要なライセンス権限を取得することは、開発者であるユーザーの責任で行ってください。

多くの種類のソフトウェアと同様に、フォントファイルは、販売されるのではなくライセンスされます。フォントの使用を管理するライセンスはベンダによって異なりますが、Microsoft がアプリケーションや Windows で提供しているフォントをカバーするライセンスも含めて、通常、ほとんどのライセンスは、フォントをアプリケーションに埋め込んだり、別の方法で再頒布したりすることを許可していません。したがって、アプリケーションに埋め込む、または別の方法で再頒布するフォントについて、必要なライセンス権限を取得することは、開発者であるユーザーの責任で行ってください。

このトピックには次のセクションが含まれています。

フォントのパッケージングの概要
コンテンツ項目としてのフォントの追加
リソース項目としてのフォントの追加
フォントリソースライブラリの作成
フォントの使用に関する制限事項
関連トピック

フォントのパッケージングの概要

ユーザーインターフェイスのテキストやその他の種類のテキストベースのコンテンツを表示するために、WPF のリソースとしてフォントを簡単にパッケージ化できます。フォントは、アプリケーションのアセンブリファイルと別にすることも、アセンブリファイル内に埋め込むこともできます。また、アプリケーションで参照できる、リソース専用のフォントライブラリを作成することもできます。

OpenType および TrueType® フォントには、各フォントにおけるフォント埋め込みのライセンス権限を示す、型フラグ fsType が含まれています。ただし、この型フラグはドキュメントに格納された埋め込みフォントのみを参照し、アプリケーションに埋め込まれたフォントは参照しません。フォントの埋め込み権限を取得するには、GlyphTypeface オブジェクトを作成し、その EmbeddingRights プロパティを参照します。fsType フラグの詳細については、OpenType 仕様の「OS/2 and Windows Metrics」を参照してください。

特定のフォントベンダまたはカスタム作業のフォントベンダを探す際に役立つ連絡先情報については、Microsoft の文字体裁の Web サイトを参照してください。

コンテンツ項目としてのフォントの追加

フォントは、アプリケーションのアセンブリファイルとは別のプロジェクトコンテンツ項目としてアプリケーションに追加できます。つまり、コンテンツ項目はアセンブリ内にリソースとして埋め込まれません。コンテンツ項目を定義する方法を次のプロジェクトファイル例に示します。

<Project DefaultTargets="Build" xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
  <!-- Other project build settings ... -->

  <ItemGroup>
    <Content Include="Peric.ttf" />
    <Content Include="Pericl.ttf" />
  </ItemGroup>
</Project>

アプリケーションが実行時にフォントを使用できるようにするには、アプリケーションの展開ディレクトリでフォントをアクセス可能にする必要があります。アプリケーションのプロジェクトファイルの <CopyToOutputDirectory> 要素を使用すると、ビルドプロセスでアプリケーション展開ディレクトリにフォントを自動的にコピーできます。展開ディレクトリにフォントをコピーする方法を次のプロジェクトファイル例に示します。

<ItemGroup>
  <Content Include="Peric.ttf">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </Content>
  <Content Include="Pericl.ttf">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </Content>
</ItemGroup>

次のコード例は、アプリケーションのフォントをコンテンツ項目として参照する方法を示しています。参照されるコンテンツ項目は、アプリケーションのアセンブリファイルと同じディレクトリ内に存在する必要があります。

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

リソース項目としてのフォントの追加

フォントは、アプリケーションのアセンブリファイルに埋め込まれたプロジェクトリソース項目としてアプリケーションに追加できます。リソース用に個別のサブディレクトリを使用して、アプリケーションのプロジェクトファイルを編成できます。個別のサブディレクトリ内のリソース項目としてフォントを定義する方法を次のプロジェクトファイル例に示します。

<Project DefaultTargets="Build" xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
  <!-- Other project build settings ... -->

  <ItemGroup>
    <Resource Include="resources\Peric.ttf" />
    <Resource Include="resources\Pericl.ttf" />
  </ItemGroup>
</Project>

メモ :
アプリケーションにリソースとしてフォントを追加する場合は、アプリケーションのプロジェクトファイルに <EmbeddedResource> 要素ではなく、<Resource> 要素を設定していることを確認してください。ビルドアクションで <EmbeddedResource> 要素はサポートされません。

アプリケーションのフォントリソースを参照する方法を次のマークアップ例に示します。

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

コードからのフォントリソース項目の参照

コードからフォントリソース項目を参照するには、基本統一リソース識別子 (URI) と、フォントの場所の参照との 2 つの部分で構成される、フォントリソース参照を指定する必要があります。これらの値は、FontFamily メソッドのパラメータして使用されます。プロジェクトの resources というサブディレクトリにある、アプリケーションのフォントリソースを参照する方法を次のコード例に示します。

// 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");

基本統一リソース識別子 (URI) には、フォントリソースが存在する、アプリケーションのサブディレクトリを含めることができます。この場合、フォントの場所の参照でディレクトリを指定する必要はありませんが、先頭に "./" を付けて、基本統一リソース識別子 (URI) で指定するディレクトリと同じディレクトリ内のフォントリソースであることを示す必要があります。次のコード例は、フォントリソース項目を参照する別の方法を示しています。これは前のコード例と同等です。

// The base URI reference can include an application subdirectory.
myTextBlock.FontFamily = new FontFamily(new Uri("pack://application:,,,/resources/"), "./#Pericles Light");

同じアプリケーションサブディレクトリからのフォントの参照

アプリケーションのコンテンツとリソースファイルは、アプリケーションプロジェクトのユーザー定義の同じサブディレクトリに配置できます。同じサブディレクトリで定義されたコンテンツページとフォントリソースを次のプロジェクトファイル例に示します。

<ItemGroup>
  <Page Include="pages\HomePage.xaml" />
</ItemGroup>
<ItemGroup>
  <Resource Include="pages\Peric.ttf" />
  <Resource Include="pages\Pericl.ttf" />
</ItemGroup>

アプリケーションのコンテンツとフォントが同じディレクトリにあるため、フォント参照はアプリケーションのコンテンツに関連しています。フォントがアプリケーションと同じディレクトリにある場合に、アプリケーションのフォントリソースを参照する方法を次の例に示します。

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

// The font resource reference includes the base Uri (application directory level),
// and the file resource location, which is relative to the base Uri.
myTextBlock.FontFamily = new FontFamily(new Uri("pack://application:,,,/"), "/pages/#Pericles Light");

アプリケーションでのフォントの列挙

アプリケーション内のリソース項目としてフォントを列挙するには、GetFontFamilies または GetTypefaces メソッドを使用します。次の例は、GetFontFamilies メソッドを使用して、アプリケーションフォントの場所から FontFamily のコレクションを返す方法を示しています。ここでは、アプリケーションに "resources" という名前のサブディレクトリが含まれています。

foreach (FontFamily fontFamily in Fonts.GetFontFamilies(new Uri("pack://application:,,,/"), "./resources/"))
{
    // Perform action.
}

次の例は、GetTypefaces メソッドを使用して、アプリケーションフォントの場所から Typeface のコレクションを返す方法を示しています。ここでは、アプリケーションに "resources" という名前のサブディレクトリが含まれています。

foreach (Typeface typeface in Fonts.GetTypefaces(new Uri("pack://application:,,,/"), "./resources/"))
{
    // Perform action.
}

フォントリソースライブラリの作成

フォントのみを含むリソース専用ライブラリを作成できます。この種類のライブラリプロジェクトにはコードは含まれません。リソース専用ライブラリの作成は、リソースを使用するアプリケーションコードからリソースを切り離すための一般的な手法です。また、これにより、複数のアプリケーションプロジェクトでこのライブラリアセンブリを組み込むことができます。リソース専用ライブラリプロジェクトの主要部分を次のプロジェクトファイル例に示します。

<PropertyGroup>
  <AssemblyName>FontLibrary</AssemblyName>
  <OutputType>library</OutputType>
  ...
</PropertyGroup>
...
<ItemGroup>
  <Resource Include="Kooten.ttf" />
  <Resource Include="Pesca.ttf" />
</ItemGroup

リソースライブラリ内のフォントの参照

アプリケーションからリソースファイル内のフォントを参照するには、フォント参照の前にライブラリアセンブリの名前を付加する必要があります。ここでは、フォントリソースアセンブリは "FontLibrary" です。アセンブリ名をアセンブリ内の参照と区切るために、';' 文字を使用します。キーワード "Component" の後にフォント名への参照を続けて追加すると、フォントライブラリのリソースへの完全参照が完成します。リソースライブラリアセンブリ内のフォントを参照する方法を次のコード例に示します。

<Run FontFamily="/FontLibrary;Component/#Kootenay" FontSize="36">
  ABCDEFGHIJKLMNOPQRSTUVWXYZ
</Run>

メモ :
この SDK には、WPF アプリケーションで使用できる一連の OpenType フォントがサンプルとして用意されています。フォントは、リソース専用ライブラリで定義されています。詳細については、「OpenType フォントパックのサンプル」を参照してください。

フォントの使用に関する制限事項

WPF アプリケーションでのフォントのパッケージングおよび使用に関するいくつかの制限事項を次に示します。

フォント埋め込みアクセス許可情報 : WPF アプリケーションは、フォント埋め込みアクセス許可情報をチェックまたは強制しません。詳細については、「フォントのパッケージングの概要」を参照してください。
フォントの起点サイト : WPF アプリケーションでは、http または ftp の統一リソース識別子 (URI) へのフォント参照は許可されていません。
pack: 表記を使用した絶対 URI : WPF アプリケーションでは、フォントへの絶対統一リソース識別子 (URI) 参照の一部として "pack:" を使用してプログラムで FontFamily オブジェクトを作成することはできません。たとえば、"pack://application:,,,/resources/#Pericles Light" は無効なフォント参照です。
自動フォント埋め込み : デザイン時に、アプリケーションのフォントの使用を検索したり、アプリケーションのリソースにフォントを自動的に埋め込んだりすることはサポートされていません。
フォントサブセット : WPF アプリケーションでは、固定ドキュメント以外でフォントサブセットの作成はサポートされていません。
正しくない参照がある場合、アプリケーションは使用可能なフォントの使用に戻ります。

参照

次の方法で共有

アプリケーションでのフォントのパッケージング

フォントのパッケージングの概要

コンテンツ項目としてのフォントの追加

リソース項目としてのフォントの追加

コードからのフォントリソース項目の参照

同じアプリケーションサブディレクトリからのフォントの参照

アプリケーションでのフォントの列挙

フォントリソースライブラリの作成

リソースライブラリ内のフォントの参照

フォントの使用に関する制限事項

参照

概念

参照

その他の技術情報

その他のリソース

次の方法で共有

アプリケーションでのフォントのパッケージング

フォントのパッケージングの概要

コンテンツ項目としてのフォントの追加

リソース項目としてのフォントの追加

コードからのフォント リソース項目の参照

同じアプリケーション サブディレクトリからのフォントの参照

アプリケーションでのフォントの列挙

フォント リソース ライブラリの作成

リソース ライブラリ内のフォントの参照

フォントの使用に関する制限事項

参照

概念

参照

その他の技術情報

その他のリソース

コードからのフォントリソース項目の参照

同じアプリケーションサブディレクトリからのフォントの参照

フォントリソースライブラリの作成

リソースライブラリ内のフォントの参照