estrutura GETINFO_GLYPHSTRING (printoem.h)

Artigo
02/07/2025

A estrutura GETINFO_GLYPHSTRING é usada como entrada para a função de retorno de chamada UNIFONTOBJ_GetInfo.

Sintaxe

typedef struct _GETINFO_GLYPHSTRING {
  DWORD dwSize;
  DWORD dwCount;
  DWORD dwTypeIn;
  PVOID pGlyphIn;
  DWORD dwTypeOut;
  PVOID pGlyphOut;
  DWORD dwGlyphOutSize;
} GETINFO_GLYPHSTRING, *PGETINFO_GLYPHSTRING;

Membros

dwSize

Especifica o tamanho, em bytes, da estrutura GETINFO_GLYPHSTRING. Esse valor é fornecido pelo chamador UNIFONTOBJ_GetInfo.

dwCount

Especifica o número de elementos nas matrizes apontadas por pGlyphIn e pGlyphOut. Esse valor é fornecido pelo chamador UNIFONTOBJ_GetInfo.

dwTypeIn

Especifica o tipo de matriz do especificador de glifo apontado por pGlyphIn. Os valores válidos são os seguintes:

Valor	Definição
TYPE_GLYPHHANDLE	TpGlyphIn elementos de matriz são do tipo HGLYPH ou identificadores para um glifo de fonte de dispositivo. Para esse valor de dwTypeIn, os valores válidos para dwTypeOut são TYPE_UNICODE ou TYPE_TRANSDATA.
TYPE_GLYPHID	Os elementos de matriz pGlyphIn são do tipo DWORD e contêm identificadores de glifo para glifos de fonte TrueType baixados. Para esse valor de dwTypeIn, os valores válidos para dwTypeOut são TYPE_UNICODE ou TYPE_GLYPHHANDLE.

Fornecido pelo chamador UNIFONTOBJ_GetInfo.

pGlyphIn

Ponteiro para uma matriz de especificadores de glifo. O tipo de elemento de matriz é indicado por dwTypeIn. Esse valor é fornecido pelo chamador UNIFONTOBJ_GetInfo.

dwTypeOut

Especifica o tipo de matriz do especificador de glifo apontado por pGlyphOut. Os valores válidos são os seguintes:

Valor	Definição
TYPE_GLYPHHANDLE	Os elementos de matriz pGlyphOut são do tipo HGLYPH ou identificadores para um glifo de fonte de dispositivo. Esse valor é válido somente quando dwTypeIn foi definido como TYPE_GLYPHID.
TYPE_TRANSDATA	Os elementos da matriz pGlyphOut são do tipo TRANSDATA. Esse valor é válido somente quando dwTypeIn foi definido como TYPE_GLYPHHANDLE.
TYPE_UNICODE	Os elementos da matriz de pGlyph são do tipo WCHAR. Esse valor é válido quando dwTypeIn foi definido como TYPE_GLYPHHANDLE ou TYPE_GLYPHID.

Fornecido pelo chamador UNIFONTOBJ_GetInfo.

pGlyphOut

Ponteiro fornecido pelo chamador para uma matriz vazia de especificadores de glifo. A matriz é preenchida pela função de retorno de chamada UNIFONTOBJ_GetInfo do Unidrv. O tipo de elemento de matriz é indicado por dwTypeOut. Esse ponteiro é fornecido pelo chamador UNIFONTOBJ_GetInfo.

dwGlyphOutSize

Especifica o tamanho, em bytes, do buffer apontado por pGlyphOut. Esse membro é usado somente quando dwTypeIn foi definido como TYPE_GLYPHHANDLE e dwTypeOut foi definido como TYPE_TRANSDATA. Consulte a seção Comentários a seguir para obter mais informações.

Observações

Para converter uma matriz de especificadores de glifo de um tipo para outro, um plug-in de renderização pode fornecer o endereço de uma estrutura de GETINFO_GLYPHSTRING ao chamar a função de retorno de chamada UNIFONTOBJ_GetInfo do Unidrv.

Se a conversão for de TYPE_GLYPHHANDLE para TYPE_TRANSDATA, UNIFONTOBJ_GetInfo deverá ser chamado duas vezes.

Antes da primeira chamada para UNIFONTOBJ_GetInfo, o plug-in de renderização preenche os membros dwSize, dwCount, dwTypeIne membros do pGlyphIn e define membro dwGlyphOutSize como zero.

Depois que UNIFONTOBJ_GetInfo retorna, o membro dwGlyphOutSize contém o tamanho, em bytes, do buffer necessário para armazenar a cadeia de caracteres convertida.
O plug-in aloca um bloco de memória do tamanho recebido no membro dwGlyphOutSize, define o membro pGlyphOut para apontar para esse bloco de memória e chama UNIFONTOBJ_GetInfo mais uma vez. O UNIDRV converte a cadeia de caracteres de TYPE_GLYPHHANDLE em TYPE_TRANSDATA.

Os valores que um plug-in de renderização especifica para os membros dwTypeIne pGlyphIn normalmente são aqueles que foram recebidos anteriormente como os parâmetros dwTypee pGlyph para o método IPrintOemUni::OutputCharStr.

Requisitos

Requisito	Valor
cabeçalho	printoem.h (inclua Printoem.h)

Consulte também

IPrintOemUni::OutputCharStr

UNIFONTOBJ_GetInfo

Partilhar via