Compartilhar via


estrutura GETINFO_GLYPHSTRING (printoem.h)

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. Estes são os valores válidos:

Valor Definição
TYPE_GLYPHHANDLE Os elementos da matriz TpGlyphIn são do tipo HGLYPH ou identificadores para um glifo de fonte do dispositivo. Para esse valor de dwTypeIn, os valores válidos para dwTypeOut são TYPE_UNICODE ou TYPE_TRANSDATA.
TYPE_GLYPHID Os elementos da 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. Estes são os valores válidos:

Valor Definição
TYPE_GLYPHHANDLE Os elementos da matriz pGlyphOut são do tipo HGLYPH ou identificador para um glifo de fonte do 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 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 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.

Comentários

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 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, dwTypeIn e pGlyphIn e define o 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. 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)

Confira também

IPrintOemUni::OutputCharStr

UNIFONTOBJ_GetInfo