Empaquetage de polices avec des applications

Article
08/22/2008

Mise à jour : novembre 2007

Cette rubrique fournit une vue d'ensemble de la manière d'empaqueter des polices avec votre application Windows Presentation Foundation (WPF).

Remarque :
Comme avec la plupart des types de logiciels, les fichiers de police font l'objet d'une licence et ne sont pas vendus. Les licences qui régissent l'utilisation de polices varient d'un fournisseur à l'autre mais en général, la plupart des licences (y compris celles qui portent sur des polices Microsoft) fournies avec des applications et Windows, n'autorisent pas l'incorporation de polices dans des applications ni leur redistribution. Par conséquent, en tant que développeur, il vous incombe de veiller à disposer des droits de licence requis pour toute police incorporée dans une application ou redistribuée d'une autre manière.

Comme avec la plupart des types de logiciels, les fichiers de police font l'objet d'une licence et ne sont pas vendus. Les licences qui régissent l'utilisation de polices varient d'un fournisseur à l'autre mais en général, la plupart des licences (y compris celles qui portent sur des polices Microsoft) fournies avec des applications et Windows, n'autorisent pas l'incorporation de polices dans des applications ni leur redistribution. Par conséquent, en tant que développeur, il vous incombe de veiller à disposer des droits de licence requis pour toute police incorporée dans une application ou redistribuée d'une autre manière.

Cette rubrique comprend les sections suivantes.

Introduction à l'empaquetage de polices
Ajout de polices en tant qu'éléments de contenu
Ajout de polices en tant qu'éléments de ressource
Création d'une bibliothèque de ressources de polices
Limitations sur l'utilisation de polices
Rubriques connexes

Introduction à l'empaquetage de polices

Vous pouvez empaqueter facilement des polices comme ressources dans vos applications WPF pour afficher le texte de l'interface utilisateur et d'autres types de contenu basé sur du texte. Les polices peuvent être séparées des fichiers d'assembly de l'application ou y être incorporées. Vous pouvez également créer une typothèque de ressources uniquement, que votre application peut référencer.

Les polices OpenType et TrueType® contiennent un indicateur de type (fsType) qui indique les droits de licence pour incorporation de la police. Toutefois, cet indicateur de type fait seulement référence aux polices incorporées stockées dans un document. Il ne fait pas référence aux polices incorporées dans une application. Vous pouvez récupérer les droits d'incorporation de polices pour une police en créant un objet GlyphTypeface et en référençant sa propriété EmbeddingRights. Pour plus d'informations sur l'indicateur fsType, reportez-vous à la section « OS/2 and Windows Metrics » de la page OpenType Specification.

Le site Web sur la typographie de Microsoft inclut des informations de contact qui peuvent vous aider à localiser un fournisseur de polices ou à trouver un fournisseur de polices pour un projet particulier.

Ajout de polices en tant qu'éléments de contenu

Vous pouvez ajouter des polices à votre application en tant qu'éléments de contenu du projet distincts des fichiers d'assembly de l'application. Cela signifie que les éléments de contenu ne sont pas incorporés comme ressources dans un assembly. L'exemple de fichier projet suivant indique comment définir des éléments de contenu.

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

Pour garantir que l'application peut utiliser les polices au moment de l'exécution, ces polices doivent être accessibles dans le répertoire de déploiement de l'application. L'élément <CopyToOutputDirectory> du fichier projet de l'application vous permet de copier automatiquement les polices vers le répertoire de déploiement de l'application pendant le processus de génération. L'exemple de fichier projet suivant indique comment copier des polices vers le répertoire de déploiement.

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

L'exemple de code suivant indique comment référencer la police de l'application comme élément de contenu. L'élément de contenu référencé doit se trouver dans le même répertoire que les fichiers d'assembly de l'application.

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

Ajout de polices en tant qu'éléments de ressource

Vous pouvez ajouter des polices à votre application comme éléments de ressource du projet qui sont incorporés dans les fichiers d'assembly de l'application. L'utilisation d'un sous-répertoire distinct pour les ressources permet d'organiser les fichiers projet de l'application. L'exemple de fichier projet suivant indique comment définir des polices comme éléments de ressource dans un sous-répertoire séparé.

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

Remarque :
Lorsque vous ajoutez des polices comme ressources à votre application, assurez-vous que vous définissez l'élément <Resource>, et non l'élément <EmbeddedResource> dans le fichier projet de votre application. L'élément <EmbeddedResource> de l'action de génération n'est pas pris en charge.

L'exemple de balisage suivant indique comment référencer les ressources de police de l'application.

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

Référencement d'éléments de ressource de police dans le code

Pour référencer des éléments de ressource de police à partir du code, vous devez fournir une référence à une ressource de police en deux parties : le URI (Uniform Resource Identifier) de base et la référence de l'emplacement de la police. Ces valeurs sont utilisées comme paramètres pour la méthode FontFamily. L'exemple de code suivant montre comment référencer les ressources de police de l'application dans le sous-répertoire de projet appelé 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");

Le URI (Uniform Resource Identifier) de base peut inclure le sous-répertoire d'application où la ressource de police réside. Dans ce cas, la référence de l'emplacement de la police ne doit pas spécifier de répertoire, mais doit inclure un préfixe ./, qui indique que la ressource de police se trouve dans le même répertoire spécifié par le URI (Uniform Resource Identifier) de base. L'exemple de code suivant montre une autre manière de référencer l'élément de ressource de police. Il équivaut à l'exemple de code précédent.

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

Référencement de polices à partir du même sous-répertoire d'application

Vous pouvez placer les fichiers de contenu d'application et les fichiers de ressources dans le même sous-répertoire défini par l'utilisateur dans votre projet d'application. L'exemple de fichier projet suivant montre une page de contenu et des ressources de police définies dans le même sous-répertoire.

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

Comme le contenu de l'application et la police se trouvent dans le même sous-répertoire, la référence de police est relative au contenu d'application. Les exemples suivants indiquent comment référencer la ressource de police de l'application lorsque la police se trouve dans le même répertoire que l'application.

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

Énumération des polices dans une application

Pour énumérer des polices en tant qu'éléments de ressource dans votre application, utilisez la méthode GetFontFamilies ou GetTypefaces. L'exemple suivant montre comment utiliser la méthode GetFontFamilies pour renvoyer la collection d'objets FontFamily depuis l'emplacement des polices de l'application. Dans ce cas, l'application contient un sous-répertoire appelé « ressources ».

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

L'exemple suivant montre comment utiliser la méthode GetTypefaces pour renvoyer la collection d'objets Typeface depuis l'emplacement des polices de l'application. Dans ce cas, l'application contient un sous-répertoire appelé « ressources ».

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

Création d'une bibliothèque de ressources de polices

Vous pouvez créer une bibliothèque de ressources uniquement qui ne contient que des polices. Ce type de projet de bibliothèque ne renferme aucun code. La création d'une bibliothèque de ressources uniquement est une technique fréquemment utilisée pour découpler des ressources du code d'application qui les utilise. L'assembly de bibliothèque peut ainsi être inclus dans plusieurs projets d'application. L'exemple de fichier projet suivant montre les parties clés d'un projet de bibliothèque contenant uniquement des ressources.

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

Référencement d'une police dans une bibliothèque de ressources

Pour référencer une police dans une bibliothèque de ressources de votre application, vous devez faire précéder la référence de police du nom de l'assembly de bibliothèque. Dans le cas présent, l'assembly de ressource de police est « FontLibrary ». Pour séparer le nom de l'assembly de la référence dans l'assembly, utilisez un caractère ';'. L'ajout du mot clé « Component » suivi de la référence au nom de police complète la référence à la ressource du typothèque. L'exemple de code suivant indique comment référencer une police dans un assembly de bibliothèque de ressources.

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

Remarque :
Ce Kit de développement logiciel contient un jeu des exemples de polices OpenType que vous pouvez utiliser avec les applications WPF. Les polices sont définies dans une bibliothèque de ressources uniquement. Pour plus d'informations, consultez Exemple de pack de polices OpenType.

Limitations sur l'utilisation de polices

La liste suivante décrit plusieurs restrictions sur l'empaquetage et l'utilisation de polices dans les applications WPF :

Bits d'autorisation d'incorporation de polices : les applications WPF ne vérifient ni n'appliquent les bits d'autorisation d'incorporation de polices. Consultez la section Introduction à l'empaquetage de polices pour plus d'informations.
Site de polices d'origine : les applications WPF n'autorisent pas de référence de police à un URI (Uniform Resource Identifier) http ou ftp.
URI absolu utilisant la notation « pack: » : les applications WPF ne vous permettent pas de créer par programme un objet FontFamily utilisant la notation « pack: » dans le cadre de la référence URI (Uniform Resource Identifier) absolue à une police. Par exemple, "pack://application:,,,/resources/#Pericles Light" est une référence de police non valide.
Incorporation de police automatique : Au moment du design, la recherche des polices utilisées par une application et l'incorporation automatique des polices dans les ressources de l'application ne sont pas prises en charge.
Sous-ensembles de polices : les applications WPF ne prennent pas en charge la création de sous-ensembles de polices pour les documents non fixes.
En cas de référence incorrecte, l'application retourne à une police disponible.

Voir aussi

Partager via