función STROBJ_bGetAdvanceWidths (winddi.h)
La función STROBJ_bGetAdvanceWidths recupera una matriz de vectores que especifica los anchos probables de glifos que componen una cadena especificada.
Sintaxis
ENGAPI BOOL STROBJ_bGetAdvanceWidths(
STROBJ *pso,
[in] ULONG iFirst,
ULONG c,
POINTQF *pptqD
);
Parámetros
pso
Es un puntero proporcionado por el autor de la llamada a una estructura STROBJ que describe una cadena de texto. Normalmente, esta es la estructura STROBJ recibida por la función DrvTextOut del controlador.
[in] iFirst
Es un índice de base cero proporcionado por el autor de la llamada en la cadena de texto proporcionada por la estructura STROBJ. Este índice representa el primer carácter de la cadena para la que se va a devolver un ancho.
c
Es un recuento proporcionado por el autor de la llamada del número de caracteres contiguos, comenzando y el carácter especificado por iFirst, para el que se van a devolver los valores de ancho.
pptqD
Es un puntero proporcionado por el autor de la llamada a una matriz de tamaño c de estructuras POINTQF para recibir anchos de caracteres en formato (28.36, 28.36). Para obtener una descripción de este tipo de datos, consulte Tipos de datos GDI.
Valor devuelto
Si la operación se realiza correctamente, la función devuelve TRUE; de lo contrario, devuelve FALSE.
Comentarios
La función STROBJ_bGetAdvanceWidths es útil para los controladores de impresora que llaman a STROBJ_bEnumPositionsOnly en lugar de STROBJ_bEnum. La función rellena la matriz pptqD con los anchos probables de los glifos de una cadena y se puede usar para calcular la posición de la impresora después de que la impresora haya representado una cadena, si el hardware de representación del glifo de la impresora no devuelve anchos de caracteres exactos.
Tenga en cuenta que las posiciones del glifo devueltas por STROBJ_bEnumPositionsOnly no corresponden necesariamente exactamente a los anchos devueltos por STROBJ_bGetAdvanceWidths.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows. |
| Plataforma de destino | Universal |
| Encabezado | winddi.h (incluya Winddi.h) |
| Library | Win32k.lib |
| Archivo DLL | Win32k.sys |