Metodo IDWriteFontFace::GetFiles (dwrite.h)

Ottiene i file di tipo di carattere che rappresentano un viso del tipo di carattere.

Sintassi

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

Parametri

[in, out] numberOfFiles

Tipo: UINT32*

Se fontFiles è NULL, riceve il numero di file che rappresentano il viso del tipo di carattere. In caso contrario, è necessario passare il numero di file di carattere richiesti. Per altre informazioni, vedere la sezione Osservazioni di seguito.

[out, optional] fontFiles

Tipo: IDWriteFontFile**

Quando termina, questo metodo contiene un puntatore a una matrice fornita dall'utente che archivia i puntatori ai file di tipo di carattere che rappresentano il viso del tipo di carattere. Questo parametro può essere NULL se l'utente desidera solo il numero di file che rappresentano il tipo di carattere. Questa API incrementa il numero di riferimenti dei puntatori ai file di carattere restituiti in base alle convenzioni COM e il client deve rilasciarli al termine.

Valore restituito

Tipo: HRESULT

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

Commenti

Il metodo IDWriteFontFace::GetFiles deve essere chiamato due volte. La prima volta che si chiama GetFilesfontFiles deve essere NULL. Al termine del metodo, numberOfFiles riceve il numero di file di carattere che rappresentano il viso del tipo di carattere.

Chiamare quindi il metodo una seconda volta, passando il valore numberOfFiles che ha restituito la prima chiamata e un buffer non Null delle dimensioni corrette per archiviare i puntatori IDWriteFontFile .

Requisiti

Vedi anche

IDWriteFontFace