Поделиться через

структура 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)

См. также раздел

IPrintOemUni::OutputCharStr

UNIFONTOBJ_GetInfo