Função STROBJ_bGetAdvanceWidths (winddi.h)
A função STROBJ_bGetAdvanceWidths recupera uma matriz de vetores especificando as larguras prováveis de glifos que compõem uma cadeia de caracteres especificada.
Sintaxe
ENGAPI BOOL STROBJ_bGetAdvanceWidths(
STROBJ *pso,
[in] ULONG iFirst,
ULONG c,
POINTQF *pptqD
);
Parâmetros
pso
É um ponteiro fornecido pelo chamador para uma estrutura STROBJ que descreve uma cadeia de caracteres de texto. Normalmente, essa é a estrutura STROBJ recebida pela função DrvTextOut do driver.
[in] iFirst
É um índice baseado em zero fornecido pelo chamador na cadeia de caracteres de texto fornecida pela estrutura STROBJ. Esse índice representa o primeiro caractere da cadeia de caracteres para o qual uma largura deve ser retornada.
c
É uma contagem fornecida pelo chamador do número de caracteres contíguos, inicial e o caractere especificado por iFirst, para o qual os valores de largura devem ser retornados.
pptqD
É um ponteiro fornecido pelo chamador para uma matriz do tamanho C de estruturas POINTQF para receber larguras de caractere no formato (28.36, 28.36). Para obter uma descrição desse tipo de dados, consulte Tipos de dados GDI.
Retornar valor
Se a operação for bem-sucedida, a função retornará TRUE; caso contrário, retornará FALSE.
Comentários
A função STROBJ_bGetAdvanceWidths é útil para drivers de impressora que chamam STROBJ_bEnumPositionsOnly em vez de STROBJ_bEnum. A função preenche a matriz pptqD com as larguras prováveis dos glifos de uma cadeia de caracteres e pode ser usada para calcular a posição da impressora após uma cadeia de caracteres, como foi renderizada pela impressora, se o hardware de renderização de glifo da impressora não retornar as larguras exatas do caractere.
Observe que as posições de glifo retornadas por STROBJ_bEnumPositionsOnly não correspondem necessariamente exatamente às larguras retornadas por STROBJ_bGetAdvanceWidths.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows. |
| Plataforma de Destino | Universal |
| Cabeçalho | winddi.h (inclua Winddi.h) |
| Biblioteca | Win32k.lib |
| DLL | Win32k.sys |