IXpsOMGlyphsEditor::GetGlyphIndices method

Gets an array of XPS_GLYPH_INDEX structures that describe the specific glyph indices in the font.

Syntax

HRESULT GetGlyphIndices(
  [in, out] UINT32          *indexCount,
  [out]     XPS_GLYPH_INDEX *glyphIndices
);

Parameters

  • indexCount [in, out]
    The number of elements that will fit in the array referenced by the glyphIndices parameter. When the method returns, indexCount will contain the number of XPS_GLYPH_INDEX structures that are returned in the array referenced by glyphIndices.

  • glyphIndices [out]
    The XPS_GLYPH_INDEX structure array that receives the glyph indices.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the table that follows. For information about XPS document API return values that are not listed in this table, see XPS Document Errors.

Return code Description
S_OK

The method succeeded.

E_POINTER

indexCount or glyphIndices is NULL, or both are NULL.

ERROR_MORE_DATA

glyphIndices is not large enough to receive the glyph index data. indexCount contains the required number of elements.

 

Remarks

The glyph indices that are returned in glyphIndices override the default cmap mapping from the UnicodeString property to the glyph index. Each XPS_GLYPH_INDEX structure also contains advance width and vertical and horizontal offset information.

GetGlyphIndexCount gets the number of elements in the glyph index array.

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]

Header

Xpsobjectmodel.h

IDL

XpsObjectModel.idl

See also

IXpsOMGlyphsEditor

XPS_GLYPH_INDEX

XPS Document Errors

XML Paper Specification