D3DXCreateFont fonction)

Crée un objet de police pour un appareil et une police.

Syntaxe

HRESULT D3DXCreateFont(
  _In_  LPDIRECT3DDEVICE9 pDevice,
  _In_  INT               Height,
  _In_  UINT              Width,
  _In_  UINT              Weight,
  _In_  UINT              MipLevels,
  _In_  BOOL              Italic,
  _In_  DWORD             CharSet,
  _In_  DWORD             OutputPrecision,
  _In_  DWORD             Quality,
  _In_  DWORD             PitchAndFamily,
  _In_  LPCTSTR           pFacename,
  _Out_ LPD3DXFONT        *ppFont
);

Paramètres

pDevice [ dans]

Type : LPDIRECT3DDEVICE9

Pointeur vers une interface IDirect3DDevice9 , l’appareil à associer à l’objet font.

Hauteur [ dans]

Type : int

Hauteur des caractères dans les unités logiques.

Largeur [ dans]

Type : uint

Largeur des caractères en unités logiques.

Poids [ dans]

Type : uint

Épaisseur du caractère. Un exemple est le gras.

Miplevels a [ dans]

Type : uint

Nombre de niveaux de mipmap.

Italique [ dans]

Type : bool

True pour la police en italique ; sinon, false.

Jeu [ de caractères dans]

Type : DWORD

Jeu de caractères de la police.

OutputPrecision [ dans]

Type : DWORD

spécifie comment Windows doit tenter de faire correspondre les tailles de police et les caractéristiques souhaitées avec les polices réelles. Utilisez _ TT _ uniquement _ precis par exemple, pour vous assurer que vous recevez toujours une police TrueType.

Qualité [ dans]

Type : DWORD

spécifie comment Windows doit correspondre à la police souhaitée avec une police réelle. Elle s’applique uniquement aux polices Raster et ne doit pas affecter les polices TrueType.

PitchAndFamily [ dans]

Type : DWORD

Index de la famille et de la hauteur.

pFacename [ dans]

Type : LPCTSTR

Chaîne contenant le nom de la police. Si les paramètres du compilateur requièrent Unicode, le type de données LPCTSTR est résolu en LPCWSTR. Dans le cas contraire, le type de données String est résolu en LPCSTR. Consultez la section Notes.

ppFont [ à]

Type : LPD3DXFONT*

Retourne un pointeur vers une interface ID3DXFont représentant l’objet de police créé.

Valeur retournée

Type : HRESULT

Si la fonction est réussie, la valeur de retour est S _ OK. Si la fonction échoue, la valeur de retour peut être l’une des suivantes : D3DERR _ INVALIDCALL, D3DXERR _ sera déplacé, E _ OUTOFMEMORY.

Remarques

La création d’un objet ID3DXFont nécessite que l’appareil prenne en charge la couleur 32 bits.

Le paramètre du compilateur détermine également la version de la fonction. Si Unicode est défini, l’appel de fonction est résolu en D3DXCreateFontW. Dans le cas contraire, l’appel de fonction est résolu en D3DXCreateFontA, car les chaînes ANSI sont utilisées.

Si vous souhaitez plus d’informations sur les paramètres de police, consultez la police logique.

Configuration requise

Condition requise Valeur
En-tête
D3dx9core. h
Bibliothèque
D3dx9. lib

Voir aussi

Fonctions usage général