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

Obtém os arquivos de fonte que representam uma face de fonte.

Sintaxe

HRESULT GetFiles(
  [in, out]       UINT32          *numberOfFiles,
  [out, optional] IDWriteFontFile **fontFiles
);

Parâmetros

[in, out] numberOfFiles

Tipo: UINT32*

Se fontFiles for NULL, receberá o número de arquivos que representam a face da fonte. Caso contrário, o número de arquivos de fonte que estão sendo solicitados deve ser passado. Confira a seção Comentários abaixo para obter mais informações.

[out, optional] fontFiles

Tipo: IDWriteFontFile**

Quando esse método retorna, contém um ponteiro para uma matriz fornecida pelo usuário que armazena ponteiros para arquivos de fonte que representam a face da fonte. Esse parâmetro poderá ser NULL se o usuário quiser apenas o número de arquivos que representam a face da fonte. Essa API incrementa a contagem de referência dos ponteiros de arquivo de fonte retornados de acordo com as convenções COM e o cliente deve liberá-los quando terminar.

Valor retornado

Tipo: HRESULT

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

Comentários

O método IDWriteFontFace::GetFiles deve ser chamado duas vezes. A primeira vez que você chamar GetFilesfontFiles deve ser NULL. Quando o método retorna, numberOfFiles recebe o número de arquivos de fonte que representam a face da fonte.

Em seguida, chame o método uma segunda vez, passando o valor numberOfFiles que foi gerado na primeira chamada e um buffer não nulo do tamanho correto para armazenar os ponteiros IDWriteFontFile .

Requisitos

Confira também

IDWriteFontFace