Метод IDWriteFontFace::GetFiles (dwrite.h)
Получает файлы шрифтов, представляющие лицо шрифта.
Синтаксис
HRESULT GetFiles(
[in, out] UINT32 *numberOfFiles,
[out, optional] IDWriteFontFile **fontFiles
);
Параметры
[in, out] numberOfFiles
Тип: UINT32*
Если fontFiles имеет значение NULL, получает количество файлов, представляющих лицо шрифта. В противном случае необходимо передать количество запрашиваемых файлов шрифтов. Дополнительные сведения см. в разделе Примечания ниже.
[out, optional] fontFiles
Тип: IDWriteFontFile**
При возврате этого метода содержит указатель на предоставленный пользователем массив, в котором хранятся указатели на файлы шрифтов, представляющие лицевой элемент шрифта. Этот параметр может иметь значение NULL , если пользователю требуется только количество файлов, представляющих лицо шрифта. Этот API увеличивает количество ссылок указателей файлов шрифтов, возвращаемых в соответствии с соглашениями COM, и клиент должен освободить их по завершении.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Метод IDWriteFontFace::GetFiles следует вызывать дважды. При первом вызове метода GetFilesfontFiles должно иметь значение NULL. При возврате метода numberOfFiles получает количество файлов шрифта, представляющих лицо шрифта.
Затем вызовите метод во второй раз, передав значение numberOfFiles , которое было выведено при первом вызове, и ненулевого буфера правильного размера для хранения указателей IDWriteFontFile .
Требования
| Минимальная версия клиента | Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | dwrite.h |
| Библиотека | Dwrite.lib |
| DLL | Dwrite.dll |