структура GETINFO_GLYPHSTRING (printoem.h)
Структура GETINFO_GLYPHSTRING используется в качестве входных данных функции обратного вызова UNIFONTOBJ_GetInfo .
Синтаксис
typedef struct _GETINFO_GLYPHSTRING {
DWORD dwSize;
DWORD dwCount;
DWORD dwTypeIn;
PVOID pGlyphIn;
DWORD dwTypeOut;
PVOID pGlyphOut;
DWORD dwGlyphOutSize;
} GETINFO_GLYPHSTRING, *PGETINFO_GLYPHSTRING;
Члены
dwSize
Задает размер структуры GETINFO_GLYPHSTRING в байтах. Это значение предоставляется вызывающим UNIFONTOBJ_GetInfo .
dwCount
Указывает количество элементов в массивах, на которые указывают pGlyphIn и pGlyphOut. Это значение предоставляется вызывающим UNIFONTOBJ_GetInfo .
dwTypeIn
Указывает тип массива описателя глифа, на который указывает pGlyphIn. Допустимы следующие значения:
Значение | Определение |
---|---|
TYPE_GLYPHHANDLE | Элементы массива TpGlyphIn имеют тип HGLYPH или обрабатывают глиф шрифта устройства. Для этого значения dwTypeIn допустимыми значениями dwTypeOut являются TYPE_UNICODE или TYPE_TRANSDATA. |
TYPE_GLYPHID | Элементы массива pGlyphIn имеют тип DWORD и содержат идентификаторы глифов для скачанных глифов шрифта TrueType. Для этого значения dwTypeIn допустимыми значениями dwTypeOut являются TYPE_UNICODE или TYPE_GLYPHHANDLE. |
Предоставляется вызывающим UNIFONTOBJ_GetInfo .
pGlyphIn
Указатель на массив описателей глифов. Тип элемента массива обозначается dwTypeIn. Это значение предоставляется вызывающим UNIFONTOBJ_GetInfo .
dwTypeOut
Указывает тип массива описателя глифов, на который указывает pGlyphOut. Допустимы следующие значения:
Значение | Определение |
---|---|
TYPE_GLYPHHANDLE | Элементы массива pGlyphOut имеют тип HGLYPH или обрабатывают глиф шрифта устройства. Это значение допустимо, только если параметру dwTypeIn присвоено значение TYPE_GLYPHID. |
TYPE_TRANSDATA | Элементы массива pGlyphOut имеют тип TRANSDATA. Это значение допустимо, только если параметру dwTypeIn присвоено значение TYPE_GLYPHHANDLE. |
TYPE_UNICODE | Элементы массива pGlyph имеют тип WCHAR. Это значение допустимо, если параметру dwTypeIn присвоено значение TYPE_GLYPHHANDLE или TYPE_GLYPHID. |
Предоставляется вызывающим UNIFONTOBJ_GetInfo .
pGlyphOut
Предоставленный вызывающим указателем на пустой массив описателей глифов. Массив заполняется функцией обратного вызова UNIFONTOBJ_GetInfo Unidrv. Тип элемента массива обозначается dwTypeOut. Этот указатель предоставляется вызывающим UNIFONTOBJ_GetInfo.
dwGlyphOutSize
Задает размер (в байтах) буфера, на который указывает pGlyphOut. Этот элемент используется только в том случае, если параметру dwTypeIn присвоено значение TYPE_GLYPHHANDLE, а dwTypeOut — значение TYPE_TRANSDATA. Дополнительные сведения см. в следующем разделе Примечаний.
Комментарии
Чтобы преобразовать массив описателей глифов из одного типа в другой, подключаемый модуль отрисовки может предоставить адрес структуры GETINFO_GLYPHSTRING при вызове функции обратного вызова UNIFONTOBJ_GetInfo Unidrv.
Если преобразование выполняется из TYPE_GLYPHHANDLE в TYPE_TRANSDATA, UNIFONTOBJ_GetInfo необходимо вызывать дважды.
Перед первым вызовом UNIFONTOBJ_GetInfo подключаемый модуль отрисовки заполняет члены dwSize, dwCount, dwTypeIn и pGlyphIn и устанавливает элемент dwGlyphOutSize равным нулю.
После возврата UNIFONTOBJ_GetInfo член dwGlyphOutSize содержит размер буфера в байтах, необходимый для хранения преобразованной строки.
Подключаемый модуль выделяет блок памяти размера, полученного в элементе dwGlyphOutSize , задает элемент pGlyphOut , указывающий на этот блок памяти, и вызывает UNIFONTOBJ_GetInfo еще раз. Затем UNIDRV преобразует строку из TYPE_GLYPHHANDLE в TYPE_TRANSDATA.
Значения, которые задается подключаемым модулем отрисовки для членов dwTypeInи pGlyphIn , обычно являются значениями, которые ранее были получены в качестве параметров dwTypeи pGlyph для метода IPrintOemUni::OutputCharStr .
Требования
Требование | Значение |
---|---|
Заголовок | printoem.h (включая Printoem.h) |