Método IFont::get_hFont (ocidl.h)

  • Artigo

Recupera um identificador para a fonte descrita por este objeto de fonte.

Sintaxe

HRESULT get_hFont(
  [out] HFONT *phFont
);

Parâmetros

[out] phFont

Um ponteiro para a variável alocada pelo chamador que recebe o identificador de fonte. O chamador não possui esse recurso e não deve tentar destruir a fonte.

Valor retornado

O método dá suporte aos valores retornados padrão E_UNEXPECTED e E_OUTOFMEMORY, bem como aos valores a seguir.

Código de retorno Descrição
S_OK
 O identificador de fonte foi recuperado com êxito.
E_POINTER
 O endereço no parâmetro phFont não é válido. Por exemplo, pode ser NULL.

Comentários

Anotações para chamadores

O objeto font mantém a propriedade do HFONT e pode destruí-lo a qualquer momento sem notificação prévia. Se o chamador precisar proteger essa fonte por um período limitado de tempo, ele poderá chamar IFont::AddRefHfont e IFont::ReleaseHfont.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ocidl.h

Confira também

Ifont

IFont::AddRefHfont

IFont::ReleaseHfont