IDWriteFontFace Interface
Represents an absolute reference to a font face which contains font face type, appropriate file references, face identification data and various font data such as metrics, names and glyph outlines.
Mitglieder
IDWriteFontFaceSchnittstelle erbt von der IUnknown-Schnittstelle. IDWriteFontFace umfasst auch die folgenden Typen von Mitgliedern:
- Methoden
Methoden
IDWriteFontFaceSchnittstelle umfasst die folgenden Methoden.
| Methode | Beschreibung |
|---|---|
| GetDesignGlyphMetrics | Obtains ideal (resolution-independent) glyph metrics in font design units. |
| GetFiles | Obtains the font files representing a font face. |
| GetGdiCompatibleGlyphMetrics | Obtains glyph metrics in font design units with the return values compatible with what GDI would produce. |
| GetGdiCompatibleMetrics | Obtains design units and common metrics for the font face. These metrics are applicable to all the glyphs within a fontface and are used by applications for layout calculations. |
| GetGlyphCount | Obtains the number of glyphs in the font face. |
| GetGlyphIndices | Returns the nominal mapping of UCS4 Unicode code points to glyph indices as defined by the font 'CMAP' table. |
| GetGlyphRunOutline | Computes the outline of a run of glyphs by calling back to the outline sink interface. |
| GetIndex | Obtains the index of a font face in the context of its font files. |
| GetMetrics | Obtains design units and common metrics for the font face. These metrics are applicable to all the glyphs within a fontface and are used by applications for layout calculations. |
| GetRecommendedRenderingMode | Determines the recommended rendering mode for the font, given the specified size and rendering parameters. |
| GetSimulations | Obtains the algorithmic style simulation flags of a font face. |
| GetType | Obtains the file format type of a font face. |
| IsSymbolFont | Determines whether the font is a symbol font. |
| ReleaseFontTable | Releases the table obtained earlier from TryGetFontTable. |
| TryGetFontTable | Finds the specified OpenType font table, if it exists, and returns a pointer to it. The function accesses the underlying font data via the IDWriteFontFileStream interface implemented by the font file loader. |
Beispiele
The following code example demonstrates creating a font face from a font file's file name.
HRESULT CreateFontFaceFromFontFile(wchar_t* filename, IDWriteFontFace **ppFontFace)
{
HRESULT hr = S_OK;
IDWriteFactory* pDWriteFactory = NULL;
IDWriteFontFace* pFontFace = NULL;
IDWriteFontFile* pFontFiles = NULL;
// Create the DirectWrite factory.
hr = DWriteCreateFactory(
DWRITE_FACTORY_TYPE_SHARED,
__uuidof(IDWriteFactory),
reinterpret_cast<IUnknown**>(&pDWriteFactory)
);
//Gets a filename from a application directory
WCHAR fontFolderPath[MAX_PATH];
UINT curDirLength = GetCurrentDirectory(
sizeof(fontFolderPath),
fontFolderPath
);
if (curDirLength == 0)
{
return E_UNEXPECTED;
}
if (SUCCEEDED(hr))
{
hr = StringCchCatW(
fontFolderPath,
sizeof(fontFolderPath),
L"\\"
);
}
if (SUCCEEDED(hr))
{
hr = StringCchCatW(
fontFolderPath,
sizeof(fontFolderPath),
(STRSAFE_LPCWSTR)filename
);
}
if (SUCCEEDED(hr))
{
hr = pDWriteFactory->CreateFontFileReference(
fontFolderPath,
NULL,
&pFontFiles);
}
IDWriteFontFile* fontFileArray[] = {pFontFiles};
if (SUCCEEDED(hr))
{
hr = pDWriteFactory->CreateFontFace(
DWRITE_FONT_FACE_TYPE_TRUETYPE,
1, // file count
fontFileArray,
0,
DWRITE_FONT_SIMULATIONS_NONE,
&pFontFace
);
}
//Return the pointer to the caller
*ppFontFace = pFontFace;
SafeRelease(&pDWriteFactory);
SafeRelease(&pFontFiles);
return hr;
}
Anforderungen
Mindestens unterstützter Client |
Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista |
Mindestens unterstützter Server |
Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 |
Header |
Dwrite.h |
Bibliothek |
Dwrite.lib |
DLL |
Dwrite.dll |