Método IDWriteFontFile::Analyze (dwrite.h)

  • Artigo

Analisa um arquivo e retorna se ele representa uma fonte e se o tipo de fonte é compatível com o sistema de fontes.

Sintaxe

HRESULT Analyze(
  [out]           BOOL                  *isSupportedFontType,
  [out]           DWRITE_FONT_FILE_TYPE *fontFileType,
  [out, optional] DWRITE_FONT_FACE_TYPE *fontFaceType,
  [out]           UINT32                *numberOfFaces
);

Parâmetros

[out] isSupportedFontType

Tipo: BOOL*

TRUE se o tipo de fonte tiver suporte pelo sistema de fontes; caso contrário, FALSE.

[out] fontFileType

Tipo: DWRITE_FONT_FILE_TYPE*

Quando este método retorna, contém um valor que indica o tipo do arquivo de fonte. Observe que, mesmo que isSupportedFontType seja FALSE, o valor fontFileType poderá ser diferente de DWRITE_FONT_FILE_TYPE_UNKNOWN.

[out, optional] fontFaceType

Tipo: DWRITE_FONT_FACE_TYPE*

Quando este método retorna, contém um valor que indica o tipo da face da fonte. Se fontFileType não for igual a DWRITE_FONT_FILE_TYPE_UNKNOWN, isso poderá ser construído a partir do arquivo de fonte.

[out] numberOfFaces

Tipo: UINT32*

Quando este método retorna, contém o número de faces de fonte contidas no arquivo de fonte.

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

Importante Determinados tipos de arquivo de fonte são reconhecidos, mas não são compatíveis com o sistema de fontes. Por exemplo, o sistema de fontes reconhecerá um arquivo como um arquivo de fonte tipo 1, mas não poderá construir um objeto de face de fonte com base nele. Nessas situações, Analisar definirá o parâmetro de saída isSupportedFontType como FALSE.
 

Requisitos

   
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho dwrite.h
Biblioteca Dwrite.lib
DLL Dwrite.dll

Confira também

IDWriteFontFile