Metodo IPrintOemUni::D ownloadCharGlyph (prcomoem.h)

Il IPrintOemUni::DownloadCharGlyph metodo consente a un plug-in di rendering per Unidrv di inviare un glifo di carattere per un carattere soft specificato alla stampante.

Sintassi

HRESULT DownloadCharGlyph(
        PDEVOBJ     pdevobj,
        PUNIFONTOBJ pUFObj,
        HGLYPH      hGlyph,
        PDWORD      pdwWidth,
  [out] OUT DWORD   *pdwResult
);

Parametri

pdevobj

Puntatore fornito dal chiamante a una struttura DEVOBJ .

pUFObj

Puntatore fornito dal chiamante a una struttura UNIFONTOBJ .

hGlyph

Handle del glifo fornito dal chiamante.

pdwWidth

Puntatore fornito dal chiamante per ricevere la larghezza fornita dal metodo del carattere.

[out] pdwResult

Riceve un valore fornito dal metodo che rappresenta la quantità di memoria della stampante, in byte, necessaria per archiviare il glifo del carattere. Se l'operazione ha esito negativo, il valore restituito deve essere zero.

Valore restituito

Il metodo deve restituire uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_FAIL	Operazione non riuscita
E_NOTIMPL	Il metodo non è implementato.

Commenti

Il IPrintOemUni::DownloadCharGlyph metodo viene usato per supportare tipi di carattere soft sulle stampanti che non accettano comandi PCL . Lo scopo è quello di abilitare un plug-in di rendering per inviare un glifo di carattere alla stampante.

Se un plug-in di rendering implementa il metodo, Unidrv chiama il IPrintOemUni::DownloadCharGlyph metodo immediatamente dopo l'invio della stringa di comando specificata dalla voce di comando CmdSetCharCode, contenuta nel file GPD della stampante. I file GPD sono descritti in Microsoft Universal Printer Driver. Il metodo deve eseguire le operazioni seguenti:

• Chiamare la funzione UNIFONTOBJ_GetInfo per ottenere l'immagine del glifo specificata da hGlyph.
• Chiamare IPrintOemDriverUni::D rvWriteSpoolBuf per inviare il glifo alla stampante.
• Chiamare nuovamente la funzione UNIFONTOBJ_GetInfo per ottenere la larghezza del glifo, quindi archiviare la larghezza nell'indirizzo a cui punta da pdwWidth.
• Restituire la quantità di memoria della stampante necessaria per archiviare il glifo inserendolo nella posizione specificata da pdwResult.

Il IPrintOemUni::DownloadCharGlyph metodo è facoltativo. Se un plug-in di rendering implementa questo metodo, il metodo IPrintOemUni::GetImplementedMethod deve restituire S_OK quando riceve "DownloadCharGlyph" come input.

Se si implementa il metodo, è necessario implementare anche il IPrintOemUni::DownloadCharGlyph metodo IPrintOemUni::D ownloadFontHeader .

Per altre informazioni, vedere Personalizzazione della gestione dei tipi di carattere.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	prcomoem.h (include Prcomoem.h)