IXpsOMGlyphs interface (xpsobjectmodel.h)
Describes the text that appears on a page.
The IXpsOMGlyphsEditor interface is used to modify the text that is described by this interface.
Inheritance
The IXpsOMGlyphs interface inherits from IXpsOMVisual. IXpsOMGlyphs also has these types of members:
Methods
The IXpsOMGlyphs interface has these methods.
| IXpsOMGlyphs::Clone Makes a deep copy of the interface. (IXpsOMGlyphs.Clone) |
| IXpsOMGlyphs::GetBidiLevel Gets the level of bidirectional text. |
| IXpsOMGlyphs::GetDeviceFontName Gets the name of the device font. (IXpsOMGlyphs.GetDeviceFontName) |
| IXpsOMGlyphs::GetFillBrush Gets a pointer to the resolved IXpsOMBrush interface of the fill brush to be used for the text. |
| IXpsOMGlyphs::GetFillBrushLocal Gets a pointer to the local, unshared IXpsOMBrush interface of the fill brush to be used for the text. |
| IXpsOMGlyphs::GetFillBrushLookup Gets the lookup key of the IXpsOMBrush interface that is stored in a resource dictionary and will be used as the fill brush. |
| IXpsOMGlyphs::GetFontFaceIndex Gets the index of the font face to be used. |
| IXpsOMGlyphs::GetFontRenderingEmSize Gets the font size. (IXpsOMGlyphs.GetFontRenderingEmSize) |
| IXpsOMGlyphs::GetFontResource Gets a pointer to the IXpsOMFontResource interface of the font resource object required for this text. |
| IXpsOMGlyphs::GetGlyphIndexCount Gets the number of Glyph indices. |
| IXpsOMGlyphs::GetGlyphIndices Gets an array of XPS_GLYPH_INDEX structures that describe the specific glyph indices in the font. (IXpsOMGlyphs.GetGlyphIndices) |
| IXpsOMGlyphs::GetGlyphMappingCount Gets the number of glyph mappings. (IXpsOMGlyphs.GetGlyphMappingCount) |
| IXpsOMGlyphs::GetGlyphMappings Gets an array of XPS_GLYPH_MAPPING structures that describe how to map UTF-16 scalar values to entries in the array of XPS_GLYPH_INDEX structures, which is returned by GetGlyphIndices. (IXpsOMGlyphs.GetGlyphMappings) |
| IXpsOMGlyphs::GetGlyphsEditor Gets a pointer to the IXpsOMGlyphsEditor interface that will be used to edit the glyphs in the object. |
| IXpsOMGlyphs::GetIsSideways Gets a Boolean value that indicates whether the text is to be rendered with the glyphs rotated sideways. (IXpsOMGlyphs.GetIsSideways) |
| IXpsOMGlyphs::GetOrigin Gets the starting position of the text. |
| IXpsOMGlyphs::GetProhibitedCaretStopCount Gets the number of prohibited caret stops. (IXpsOMGlyphs.GetProhibitedCaretStopCount) |
| IXpsOMGlyphs::GetProhibitedCaretStops Gets an array of prohibited caret stop locations. (IXpsOMGlyphs.GetProhibitedCaretStops) |
| IXpsOMGlyphs::GetStyleSimulations Gets the style simulations that will be applied when rendering the glyphs. |
| IXpsOMGlyphs::GetUnicodeString Gets the text in unescaped UTF-16 scalar values. (IXpsOMGlyphs.GetUnicodeString) |
| IXpsOMGlyphs::SetFillBrushLocal Sets the IXpsOMBrush interface pointer to a local, unshared fill brush. |
| IXpsOMGlyphs::SetFillBrushLookup Sets the lookup key name of a shared fill brush. |
| IXpsOMGlyphs::SetFontFaceIndex Sets the index of the font face to be used. |
| IXpsOMGlyphs::SetFontRenderingEmSize Sets the font size of the text. |
| IXpsOMGlyphs::SetFontResource Sets the pointer to the IXpsOMFontResource interface of the font resource object that is required for this text. |
| IXpsOMGlyphs::SetOrigin Sets the starting position of the text. |
| IXpsOMGlyphs::SetStyleSimulations Sets the style simulations that will be applied when the glyphs are rendered. |
Remarks
The code example that follows illustrates how to create an instance of this interface.
IXpsOMGlyphs *newInterface;
// this interface is defined outside of this example
// IXpsOMFontResource *font;
// Note the implicit requirement that CoInitializeEx
// has previously been called from this thread.
hr = CoCreateInstance(
__uuidof(XpsOMObjectFactory),
NULL,
CLSCTX_INPROC_SERVER,
_uuidof(IXpsOMObjectFactory),
reinterpret_cast<LPVOID*>(&xpsFactory)
);
if (SUCCEEDED(hr))
{
hr = xpsFactory->CreateGlyphs (font, &newInterface);
if (SUCCEEDED(hr))
{
// use newInterface
newInterface->Release();
}
xpsFactory->Release();
}
else
{
// evaluate HRESULT error returned in hr
}
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps | UWP apps] |
| Minimum supported server | Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps | UWP apps] |
| Target Platform | Windows |
| Header | xpsobjectmodel.h |