Método IDWriteFontFace::TryGetFontTable (dwrite.h)

Artigo
07/16/2024

Localiza a tabela de fontes OpenType especificada se ela existir e retorna um ponteiro para ela. A função acessa os dados de fonte subjacentes por meio da interface de IDWriteFontFileStream implementada pelo carregador de arquivo de fonte.

Sintaxe

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

Parâmetros

[in] openTypeTableTag

Tipo: UINT32

A marca de quatro caracteres de uma tabela de fontes OpenType a ser encontrada. Use a macro DWRITE_MAKE_OPENTYPE_TAG para criá-la como umUINT32 . Ao contrário do GDI, ele não dá suporte ao TTCF especial e às marcas nulas para acessar toda a fonte.

[out] tableData

Tipo: const void**

Quando esse método é retornado, contém o endereço de um ponteiro para a base da tabela na memória. O ponteiro é válido apenas desde que a face da fonte usada para obter a tabela de fontes ainda exista; (não qualquer outro rosto de fonte, mesmo que ele realmente se refira à mesma fonte física). Esse parâmetro é passado sem inicialização.

[out] tableSize

Tipo: UINT32*

Quando esse método é retornado, contém um ponteiro para o tamanho, em bytes, da tabela de fontes.

[out] tableContext

Tipo: void**

Quando esse método retorna, o endereço de um ponteiro para o contexto opaco, que deve ser liberado chamando ReleaseFontTable. O contexto, na verdade, vem do IDWriteFontFileStream de nível inferior, que pode ser implementado pelo aplicativo ou pelo próprio DWrite. É possível que um tableContext NULL seja retornado, especialmente se a implementação executar o mapeamento de memória direta em todo o arquivo. No entanto, sempre libere-o mais tarde e não o use como um teste para o sucesso da função. A mesma tabela pode ser consultada várias vezes, mas como cada contexto retornado pode ser diferente, você deve liberar cada contexto separadamente.

[out] exists

Tipo: bool*

Quando esse método retornar, VERDADEIRO se a tabela de fontes existir; caso contrário, FALSE .

Valor de retorno

Tipo: HRESULT

Se esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Observações

O contexto para a mesma marca pode ser diferente para cada chamada, portanto, cada uma deve ser mantida e liberada separadamente.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
servidor com suporte mínimo	Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
da Plataforma de Destino	Windows
cabeçalho	dwrite.h
biblioteca	Dwrite.lib
de DLL	Dwrite.dll

Consulte também

IDWriteFontFace

Compartilhar via