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

  • Artigo

Fornece um contexto de dispositivo para a fonte que descreve o modo de mapeamento lógico.

Sintaxe

HRESULT SetHdc(
  [in] HDC hDC
);

Parâmetros

[in] hDC

Um identificador para o contexto do dispositivo no qual selecionar a fonte.

Retornar valor

O método dá suporte ao valor de retorno padrão E_INVALIDARG, bem como aos valores a seguir.

Código de retorno Descrição
S_OK
 A fonte foi selecionada com êxito.
E_NOTIMPL
 Não há suporte para a seleção de fonte por meio desse objeto de fonte.

Comentários

O modo de mapeamento lógico afeta a computação interna da fonte de seu tamanho de ponto para que, quando o chamador solicita um identificador de fonte chamando IFont::get_hFont, a fonte já esteja dimensionada corretamente para o contexto do dispositivo.

Anotações para chamadores

O chamador mantém a propriedade desse contexto de dispositivo que deve permanecer válido durante o tempo de vida do objeto de fonte. Portanto, o contexto do dispositivo passado deve ser um contexto de dispositivo de memória (da função CreateCompatibleDC) e não um contexto de dispositivo de tela (de CreateDC, GetDC ou BeginPaint) porque os contextos do dispositivo de tela são um recurso de sistema limitado.

Requisitos

Requisito Valor
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