Funzione TTEmbedFont (t2embapi.h)

  • Articolo

Crea una struttura del tipo di carattere contenente il carattere wide-character (16 bit) subsetted. Il tipo di carattere corrente del contesto del dispositivo (hDC) fornisce le informazioni sul tipo di carattere.

Questa funzione passa i dati a una routine di callback definita dal client per l'inserimento nel flusso di documenti.

Sintassi

LONG TTEmbedFont(
  [in]           HDC            hDC,
  [in]           ULONG          ulFlags,
  [in]           ULONG          ulCharSet,
  [out]          ULONG          *pulPrivStatus,
  [out]          ULONG          *pulStatus,
                 WRITEEMBEDPROC lpfnWriteToStream,
  [in]           LPVOID         lpvWriteStream,
  [in]           USHORT         *pusCharCodeSet,
  [in]           USHORT         usCharCodeCount,
  [in]           USHORT         usLanguage,
  [in, optional] TTEMBEDINFO    *pTTEmbedInfo
);

Parametri

[in] hDC

Handle di contesto del dispositivo.

[in] ulFlags

Contrassegno che specifica la richiesta di incorporamento. Questo flag può avere zero o più dei valori seguenti.

Valore Significato
TTEMBED_EMBEDEUDC
 Includere i dati del file di carattere EUDC associati con la struttura del tipo di carattere.
TTEMBED_RAW
 Restituisce una struttura di tipo carattere contenente il set di caratteri completo, non compresso. Si tratta del comportamento predefinito della funzione.
TTEMBED_SUBSET
 Restituisce un carattere subsetto contenente solo i glifi indicati dal parametro pusCharCodeSet o pulCharCodeSet . Questi codici di carattere devono essere denotati come caratteri a 16 bit o UCS-4, come appropriato per il parametro.
TTEMBED_TTCOMPRESSED
 Restituisce una struttura di carattere compressa.

[in] ulCharSet

Contrassegno che specifica il set di caratteri del tipo di carattere da incorporare. Questo flag può avere uno dei valori seguenti.

Valore Significato
CHARSET_UNICODE
 Set di caratteri Unicode, che richiede la codifica dei caratteri a 16 bit.
CHARSET_SYMBOL
 Set di caratteri dei simboli, che richiede la codifica dei caratteri a 16 bit.

[out] pulPrivStatus

Puntatore al flag che indica i privilegi di incorporamento del tipo di carattere. Questo flag può avere uno dei valori seguenti. Questa funzione restituisce la licenza meno restrittiva concessa.

Valore Significato
EMBED_PREVIEWPRINT
 Anteprima e incorporamento di stampa.
EMBED_EDITABLE
 Incorporamento modificabile.
EMBED_INSTALLABLE
 Incorporamento installabile.
EMBED_NOEMBEDDING
 Incorporamento delle licenze con restrizioni.

[out] pulStatus

Puntatore a un campo di bit contenente informazioni sullo stato sulla richiesta di incorporamento. Questo campo viene compilato al termine di questa funzione. Non sono attualmente definiti bit per questo parametro.

lpfnWriteToStream

Puntatore alla funzione di callback definita dal client, che scrive la struttura del tipo di carattere nel flusso del documento. Vedere WRITEEMBEDPROC.

[in] lpvWriteStream

Token per rappresentare il flusso di output.

[in] pusCharCodeSet

Puntatore al buffer contenente i codici di carattere Unicode facoltativi per la sottoinsieme. Questo campo viene usato solo per la sottoinsieme di un carattere e viene ignorato se il campo ulFlags non specifica TTEMBED_SUBSET.

[in] usCharCodeCount

Numero di caratteri nell'elenco di caratteri indicati da pusCharCodeSet. Questo campo viene usato solo per la sottoinsieme di un carattere e viene ignorato se il campo ulFlags non specifica TTEMBED_SUBSET.

[in] usLanguage

Specifica la lingua nella tabella dei nomi da mantenere durante la sottoimpostazioni. Impostare su 0 per mantenere tutte le lingue. Questo campo viene usato solo per la sottoinsieme di un carattere e viene ignorato se il campo ulFlags non specifica TTEMBED_SUBSET.

[in, optional] pTTEmbedInfo

Puntatore a una struttura TTEMBEDINFO contenente gli URL da cui può essere fatto riferimento legittimamente l'oggetto carattere incorporato. Se pTTEmbedInfo è NULL, non verranno aggiunti URL all'oggetto carattere incorporato e non verrà eseguito alcun controllo URL quando il client chiama TTLoadEmbeddFont.

Valore restituito

Se l'incorporamento ha esito positivo, restituisce E_NONE.

La struttura del tipo di carattere è incorporata nel flusso del documento dal client. pulPrivStatus è impostato, che indica i privilegi di incorporamento del tipo di carattere; e pulStatus è impostato per fornire risultati dell'operazione di incorporamento.

In caso contrario, restituisce un codice di errore descritto in Messaggi di errore di incorporamento della funzione.

Commenti

I client sono responsabili della determinazione e dell'indicazione del set di caratteri del tipo di carattere.

Per informazioni sull'incorporamento di caratteri UCS-4, vedere TTEmbedFontEx. Per informazioni sull'incorporamento dei caratteri di carattere da un file, vedere TTEmbedFontFromFileA.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione t2embapi.h
Libreria T2embed.lib
DLL T2embed.dll

Vedi anche

TTEMBEDINFO

TTEmbedFontEx

TTEmbedFontFromFileA

TTLoadEmbeddedFont