勇芳软件工作室.汉化:  Fonts and Text > Fonts and Text Functions >

GetGlyphIndices

Previous pageReturn to chapter overviewNext page

描述

 

GetGlyphIndices函数将字符串转换为字形索引数组。该函数可用于确定字形中是否存在字形。

 

C++ 语法

 

DWORD GetGlyphIndices(

__in  HDC hdc,

__in  LPCTSTR lpstr,

__in  int c,

__out LPWORD pgi,

__in  DWORD fl

);

 

PowerBASIC 语法

 

FUNCTION GetGlyphIndicesA ( _

BYVAL hdc AS DWORD, _

BYREF lpstr AS ASCIIZ, _

BYVAL c AS LONG, _

BYREF pgi AS WORD, _

BYVAL fl ASS DWORD _

) AS DWORD

 

Unicode版本:

 

FUNCTION GetGlyphIndicesW ( _

BYVAL hdc AS DWORD, _

BYREF lpstr AS WSTRINGZ, _

BYVAL c AS LONG, _

BYREF pgi AS WORD, _

BYVAL fl ASS DWORD _

) AS DWORD

 

参数

 

hdc

 

[in]处理设备上下文。

 

lpstr

 

[in]指向要转换的字符串的指针。

 

c

 

[in]由LPSTR指向的字符串的长度和PGI指向的缓冲区的大小(以WORDs为单位)的长度。

 

pgi

 

[out]此缓冲区的大小必须为c.成功返回时,包含与字符串中的字符相对应的字形索引数组。

 

fl

 

[in]指定不支持如何处理字形。该参数可以是以下值。

 

含义

GGI_MARK_NONEXISTING_GLYPHS

标记不支持的十六进制值字形&Hffff。

 

返回值

 

如果函数成功,它返回转换的字节数(对于ANSI函数)或WORDs(对于Unicode函数)。

 

如果函数失败,返回值为GDI_ERROR。

 

备注

 

此函数尝试为LPSTR指向的字符串中的每个字符标识单字形表示。虽然这对于某些低级目的(例如操纵字体文件)很有用,但希望将字符串映射到字形的更高级别的应用程序通常希望使用Uniscribe功能。

 

Windows NT / 2000 / XP / Vista / Windows 7:要获取扩展错误信息,请调用GetLastError.

 

引用文件 #INCLUDE Once

 

WinGdi.inc(包括Windows.inc)