Funzione TTEmbedFontFromFileA (t2embapi.h)

Articolo
08/26/2023

Crea una struttura del tipo di carattere contenente il carattere wide-character (16 bit) subsetted. Un file esterno 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 TTEmbedFontFromFileA(
  [in]           HDC            hDC,
  [in]           LPCSTR         szFontFileName,
  [in]           USHORT         usTTCIndex,
  [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] szFontFileName

Nome del file di carattere e percorso da incorporare. Si tratta di una stringa ANSI.

[in] usTTCIndex

Indice in base zero nel file di carattere (TTC) che identifica il tipo di carattere fisico da incorporare. Se il file contiene un singolo tipo di carattere , ad esempio un file di struttura TTF o OTF, questo parametro deve essere impostato su 0.

[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 tipo di carattere e viene ignorato se il campoulFlagsfield 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 la funzione 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

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 da un contesto di dispositivo, vedere TTEmbedFont; per informazioni sull'incorporamento di caratteri UCS-4 da un contesto del dispositivo, vedere TTEmbedFontEx.

Requisiti


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