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) |