Metodo IDWriteFontFace::TryGetFontTable (dwrite.h)

Articolo
02/29/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 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 tipi di carattere esiste ancora; (non qualsiasi altro tipo di carattere, anche se effettivamente fa riferimento 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, 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 deriva effettivamente dall'IDWriteFontFileStream di livello inferiore, che può essere implementato dall'applicazione o da DWrite stessa. È possibile che venga restituito un oggetto tableContextNULL, 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 l'esito positivo 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 questo metodo viene restituito, 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 .

Commenti

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

Requisiti

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 Platform Update per Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	dwrite.h
Libreria	Dwrite.lib
DLL	Dwrite.dll

Vedi anche

IDWriteFontFace