Metodo IDWriteFontFace::TryGetFontTable (dwrite.h)

Articolo
07/16/2024

Trova la tabella dei tipi di carattere OpenType specificata, se esistente e restituisce un puntatore. La funzione accede ai dati del tipo di carattere sottostanti tramite l'interfaccia IDWriteFontFileStream implementata dal caricatore di file di tipo di carattere.

Sintassi

HRESULT TryGetFontTable(
  [in]  UINT32     openTypeTableTag,
  [out] const void **tableData,
  [out] UINT32     *tableSize,
  [out] void       **tableContext,
  [out] BOOL       *exists
);

Parametri

[in] openTypeTableTag

Tipo: UINT32

Tag a quattro caratteri di una tabella dei tipi di carattere OpenType da trovare. Utilizzare la macro DWRITE_MAKE_OPENTYPE_TAG per crearla come UINT32. A differenza di GDI, non supporta i tag speciali TTCF e Null per accedere all'intero tipo di carattere.

[out] tableData

Tipo: const void**

Quando termina, questo metodo contiene l'indirizzo di un puntatore alla base della tabella in memoria. Il puntatore è valido solo se il tipo di carattere utilizzato per ottenere la tabella dei caratteri esiste ancora; (non qualsiasi altro tipo di carattere, anche se si riferisce effettivamente allo stesso tipo di carattere fisico). Questo parametro viene passato non inizializzato.

[out] tableSize

Tipo: UINT32*

Quando termina, questo metodo contiene un puntatore alla dimensione, espressa in byte, della tabella dei tipi di carattere.

[out] tableContext

Tipo: void**

Quando termina, l'indirizzo di un puntatore al contesto opaco, che deve essere liberato chiamando ReleaseFontTable. Il contesto proviene effettivamente dal IDWriteFontFileStream, che può essere implementato dall'applicazione o da DWrite stessa. È possibile che venga restituito un NULLtableContext, soprattutto se l'implementazione esegue il mapping diretto della memoria sull'intero file. Tuttavia, rilasciarlo sempre in un secondo momento e non usarlo come test per il successo della funzione. È possibile eseguire più query sulla stessa tabella, ma poiché ogni contesto restituito può essere diverso, è necessario rilasciare ogni contesto separatamente.

[out] exists

Tipo: BOOL*

Quando termina, questo metodo TRUE se la tabella dei tipi di carattere esiste; in caso contrario, FALSE.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT.

Osservazioni

Il contesto per lo stesso tag può essere diverso per ogni chiamata, quindi ognuno deve essere mantenuto e rilasciato separatamente.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Aggiornamento della piattaforma per Windows Server 2008 [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	dwrite.h
libreria	Dwrite.lib
dll	Dwrite.dll

Vedere anche

IDWriteFontFace

Condividi tramite