Funzione TTEmbedFontEx (t2embapi.h)

Articolo
03/13/2024

Crea una struttura del tipo di carattere contenente il tipo di carattere UCS-4 con sottoinsieme (32 bit). Il tipo di carattere corrente del contesto di 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 del documento.

TTEmbedFontEx viene usato allo stesso modo di TTEmbedFont, ma accetta un set di codice carattere specificato in UCS-4 (32 bit).

Sintassi

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

Parametri

[in] hDC

Handle del contesto di dispositivo.

[in] ulFlags

Flag 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 del tipo di carattere contenente il set di caratteri completo, non compresso. Si tratta del comportamento predefinito della funzione.
TTEMBED_SUBSET	Restituisce un tipo di carattere subsetto contenente solo i glifi indicati dal parametro pusCharCodeSet o pulCharCodeSet . Questi codici di carattere devono essere contrassegnati come caratteri a 16 bit o UCS-4 come appropriato per il parametro .
TTEMBED_TTCOMPRESSED	Restituisce una struttura del tipo di carattere compresso.

[in] ulCharSet

Flag 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 di 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 relative alla richiesta di incorporamento. Questo campo viene compilato al completamento 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] pulCharCodeSet

Puntatore al buffer contenente i codici di carattere UCS-4 facoltativi per la sottoimpostazione. Questo campo viene utilizzato solo per la reimpostazione secondaria di un tipo di carattere e viene ignorato se il campo ulFlags non specifica TTEMBED_SUBSET.

[in] usCharCodeCount

Numero di caratteri nell'elenco di caratteri indicati da pulCharCodeSet. Questo campo viene utilizzato solo per la reimpostazione di un tipo di 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 sottoimpostazione. Impostare su 0 per mantenere tutte le lingue. Questo campo viene utilizzato solo per la reimpostazione secondaria di un tipo di carattere e viene ignorato se il campo ulFlags non specifica TTEMBED_SUBSET.

[in, optional] pTTEmbedInfo

Puntatore a una struttura TTEMBEDINFO contenente gli URL a cui è possibile fare riferimento legittimamente all'oggetto carattere incorporato. Se pTTEmbedInfo è NULL, nessun URL verrà aggiunto all'oggetto carattere incorporato e non verrà eseguito alcun controllo URL quando il client chiama TTLoadEmbeddedFont.

Valore restituito

Se l'incorporamento ha esito positivo, restituisce E_NONE.

La struttura del carattere viene incorporata nel flusso del documento dal client.

pulPrivStatus è impostato, che indica i privilegi di incorporamento del tipo di carattere; e pulStatus è impostato per fornire i risultati dell'operazione di incorporamento.

In caso contrario, restituisce un codice di errore descritto in Embedding-Function Error Messages.Otherwise, returns an error code described in Embedding-Function Error Messages.

Commenti

Questa funzione fa riferimento a una routine di callback definita dal client per incorporare la struttura del tipo di carattere nel flusso del documento.

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

Per informazioni sull'incorporamento di caratteri Unicode, vedere TTEmbedFont; per informazioni sull'incorporamento di caratteri Unicode 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

Condividi tramite