GETINFO_GLYPHSTRING struttura (printoem.h)
La struttura GETINFO_GLYPHSTRING viene usata come input per la funzione di callback UNIFONTOBJ_GetInfo .
Sintassi
typedef struct _GETINFO_GLYPHSTRING {
DWORD dwSize;
DWORD dwCount;
DWORD dwTypeIn;
PVOID pGlyphIn;
DWORD dwTypeOut;
PVOID pGlyphOut;
DWORD dwGlyphOutSize;
} GETINFO_GLYPHSTRING, *PGETINFO_GLYPHSTRING;
Members
dwSize
Specifica le dimensioni, in byte, della struttura GETINFO_GLYPHSTRING . Questo valore viene fornito dal chiamante UNIFONTOBJ_GetInfo .
dwCount
Specifica il numero di elementi nelle matrici a cui punta pGlyphIn e pGlyphOut. Questo valore viene fornito dal chiamante UNIFONTOBJ_GetInfo .
dwTypeIn
Specifica il tipo di matrice di identificatore di glifi a cui fa riferimento pGlyphIn. I valori validi sono i seguenti:
| valore | Definizione |
|---|---|
| TYPE_GLYPHHANDLE | Gli elementi della matrice TpGlyphIn sono di tipo HGLYPH o handle in un glifo del tipo di carattere del dispositivo. Per questo valore di dwTypeIn, i valori validi per dwTypeOut sono TYPE_UNICODE o TYPE_TRANSDATA. |
| TYPE_GLYPHID | Gli elementi della matrice pGlyphIn sono di tipo DWORD e contengono identificatori del glifo per i glifi di tipo TrueType scaricati. Per questo valore di dwTypeIn, i valori validi per dwTypeOut sono TYPE_UNICODE o TYPE_GLYPHHANDLE. |
Fornito dal chiamante UNIFONTOBJ_GetInfo .
pGlyphIn
Puntatore a una matrice di identificatori del glifo. Il tipo di elemento matrice è indicato da dwTypeIn. Questo valore viene fornito dal chiamante UNIFONTOBJ_GetInfo .
dwTypeOut
Specifica il tipo di matrice di identificatore del glifo a cui fa riferimento pGlyphOut. I valori validi sono i seguenti:
| valore | Definizione |
|---|---|
| TYPE_GLYPHHANDLE | Gli elementi della matrice pGlyphOut sono di tipo HGLYPH o handle in un glifo del tipo di carattere del dispositivo. Questo valore è valido solo quando dwTypeIn è stato impostato su TYPE_GLYPHID. |
| TYPE_TRANSDATA | Gli elementi della matrice pGlyphOut sono di tipo TRANSDATA. Questo valore è valido solo quando dwTypeIn è stato impostato su TYPE_GLYPHHANDLE. |
| TYPE_UNICODE | Gli elementi della matrice pGlyph sono di tipo WCHAR. Questo valore è valido quando dwTypeIn è stato impostato su TYPE_GLYPHHANDLE o TYPE_GLYPHID. |
Fornito dal chiamante UNIFONTOBJ_GetInfo .
pGlyphOut
Puntatore fornito dal chiamante a una matrice vuota di identificatori del glifo. La matrice viene compilata dalla funzione di callback di Unidrv UNIFONTOBJ_GetInfo. Il tipo di elemento matrice è indicato da dwTypeOut. Questo puntatore viene fornito dal chiamante UNIFONTOBJ_GetInfo.
dwGlyphOutSize
Specifica le dimensioni, in byte, del buffer a cui fa riferimento pGlyphOut. Questo membro viene usato solo quando dwTypeIn è stato impostato su TYPE_GLYPHHANDLE e dwTypeOut è stato impostato su TYPE_TRANSDATA. Per altre informazioni, vedere la sezione Osservazioni seguenti.
Commenti
Per convertire una matrice di identificatori del glifo da un tipo a un altro, un plug-in di rendering può fornire l'indirizzo di una struttura GETINFO_GLYPHSTRING quando si chiama la funzione di callback di Unidrv UNIFONTOBJ_GetInfo.
Se la conversione proviene da TYPE_GLYPHHANDLE a TYPE_TRANSDATA, UNIFONTOBJ_GetInfo deve essere chiamata due volte.
Prima della prima chiamata a UNIFONTOBJ_GetInfo, il plug-in di rendering inserisce il plug-in dwSize, dwCount, dwTypeIn e pGlyphIn e imposta il membro dwGlyphOutSize su zero.
Dopo che UNIFONTOBJ_GetInfo restituisce, il membro dwGlyphOutSize contiene le dimensioni, in byte, del buffer necessario per archiviare la stringa convertita.
Il plug-in alloca un blocco di memoria delle dimensioni ricevute nel membro dwGlyphOutSize , imposta il membro pGlyphOut per puntare a questo blocco di memoria e chiama UNIFONTOBJ_GetInfo una volta di più. UNIDRV converte quindi la stringa da TYPE_GLYPHHANDLE a TYPE_TRANSDATA.
I valori specificati da un plug-in di rendering per i membri dwTypeIne pGlyphIn in genere sono quelli ricevuti in precedenza come parametri dwTypee pGlyph al metodo IPrintOemUni::OutputCharStr .
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | printoem.h (include Printoem.h) |