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


функция STROBJ_bGetAdvanceWidths (winddi.h)

Функция STROBJ_bGetAdvanceWidths извлекает массив векторов, указывающих вероятную ширину глифов, составляющих указанную строку.

Синтаксис

ENGAPI BOOL STROBJ_bGetAdvanceWidths(
       STROBJ  *pso,
  [in] ULONG   iFirst,
       ULONG   c,
       POINTQF *pptqD
);

Параметры

pso

Предоставленный вызывающим объектом указатель на структуру STROBJ , описывающую текстовую строку. Обычно это структура STROBJ, полученная функцией DrvTextOut драйвера.

[in] iFirst

Отсчитываемый от нуля индекс вызывающего объекта в текстовой строке, предоставленной структурой STROBJ. Этот индекс представляет первый символ строки, для которой возвращается ширина.

c

Указанное вызывающим объектом число смежных символов, начиная и символов, указанных в iFirst, для которых возвращаются значения ширины.

pptqD

Указатель на массив C-размера структур POINTQF для получения ширины символов в формате (28,36, 28,36). Описание этого типа данных см. в разделе Типы данных GDI.

Возвращаемое значение

Если операция выполнена успешно, функция возвращает значение TRUE; В противном случае возвращается значение FALSE.

Комментарии

Функция STROBJ_bGetAdvanceWidths полезна для драйверов принтера, вызывающих STROBJ_bEnumPositionsOnly , а не STROBJ_bEnum. Функция заполняет массив pptqD вероятными значениями ширины глифов строки и может использоваться для вычисления положения принтера после строки, отображаемой принтером, если оборудование отрисовки глифов принтера не возвращает точную ширину символов.

Обратите внимание, что позиции глифов, возвращаемые STROBJ_bEnumPositionsOnly , не обязательно точно соответствуют ширине, возвращаемой STROBJ_bGetAdvanceWidths.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
Целевая платформа Универсальное
Верхняя часть winddi.h (включая Winddi.h)
Библиотека Win32k.lib
DLL Win32k.sys

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

DrvTextOut

STROBJ

STROBJ_bEnum

STROBJ_bEnumPositionsOnly