IDWriteFactory interface
Used to create all subsequent DirectWrite objects. This interface is the root factory interface for all DirectWrite objects.
Members
The IDWriteFactory interface inherits from the IUnknown interface. IDWriteFactory also has these types of members:
Methods
The IDWriteFactory interface has these methods.
| Method | Description |
|---|---|
| CreateCustomFontCollection |
Creates a font collection using a custom font collection loader. |
| CreateCustomFontFileReference |
Creates a reference to an application-specific font file resource. |
| CreateCustomRenderingParams |
Creates a rendering parameters object with the specified properties. |
| CreateEllipsisTrimmingSign |
Creates an inline object for trimming, using an ellipsis as the omission sign. |
| CreateFontFace |
Creates an object that represents a font face. |
| CreateFontFileReference |
Creates a font file reference object from a local font file. |
| CreateGdiCompatibleTextLayout |
Takes a string, format, and associated constraints, and produces an object representing the result, formatted for a particular display resolution and measuring mode. |
| CreateGlyphRunAnalysis |
Creates a glyph run analysis object, which encapsulates information used to render a glyph run. |
| CreateMonitorRenderingParams |
Creates a rendering parameters object with default settings for the specified monitor. In most cases, this is the preferred way to create a rendering parameters object. |
| CreateNumberSubstitution |
Creates a number substitution object using a locale name, substitution method, and an indicator whether to ignore user overrides (use NLS defaults for the given culture instead). |
| CreateRenderingParams |
Creates a rendering parameters object with default settings for the primary monitor. Different monitors may have different rendering parameters, for more information see the How to Add Support for Multiple Monitors topic. |
| CreateTextAnalyzer |
Returns an interface for performing text analysis. |
| CreateTextFormat |
Creates a text format object used for text layout. |
| CreateTextLayout |
Takes a string, text format, and associated constraints, and produces an object that represents the fully analyzed and formatted result. |
| CreateTypography |
Creates a typography object for use in a text layout. |
| GetGdiInterop |
Creates an object that is used for interoperability with GDI. |
| GetSystemFontCollection |
Gets an object which represents the set of installed fonts. |
| RegisterFontCollectionLoader |
Registers a custom font collection loader with the factory object. |
| RegisterFontFileLoader |
Registers a font file loader with DirectWrite. |
| UnregisterFontCollectionLoader |
Unregisters a custom font collection loader that was previously registered using RegisterFontCollectionLoader. |
| UnregisterFontFileLoader |
Unregisters a font file loader that was previously registered with the DirectWrite font system using RegisterFontFileLoader. |
Remarks
Create an IDWriteFactory object by using the DWriteCreateFactory function.
if (SUCCEEDED(hr)) { hr = DWriteCreateFactory( DWRITE_FACTORY_TYPE_SHARED, __uuidof(IDWriteFactory), reinterpret_cast<IUnknown**>(&pDWriteFactory_) ); }
An IDWriteFactory object holds state information, such as font loader registration and cached font data. This state can be shared or isolated. Shared is recommended for most applications because it saves memory. However, isolated can be useful in situations where you want to have a separate state for some objects.
Requirements
|
Minimum supported client |
Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps | Windows Store apps] |
|---|---|
|
Minimum supported server |
Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps | Windows Store apps] |
|
Minimum supported phone |
Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps] |
|
Header |
|
|
Library |
|
|
DLL |
|