Edit

IXpsOMGlyphs interface (xpsobjectmodel.h)

  • Article

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

See also

IXpsOMBrush

IXpsOMFontResource

IXpsOMGlyphsEditor

IXpsOMObjectFactory::CreateGlyphs

IXpsOMVisual

Interfaces

XML Paper Specification