Função DrawFocusRect (winuser.h)

A função DrawFocusRect desenha um retângulo no estilo usado para indicar que o retângulo tem o foco.

Sintaxe

BOOL DrawFocusRect(
  [in] HDC        hDC,
  [in] const RECT *lprc
);

Parâmetros

[in] hDC

Um identificador para o contexto do dispositivo.

[in] lprc

Um ponteiro para uma estrutura RECT que especifica as coordenadas lógicas do retângulo.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

DrawFocusRect funciona apenas no modo MM_TEXT.

Como DrawFocusRect é uma função XOR, chamá-la uma segunda vez com o mesmo retângulo remove o retângulo da tela.

Essa função desenha um retângulo que não pode ser rolado. Para rolar uma área que contém um retângulo desenhado por essa função, chame DrawFocusRect para remover o retângulo da tela, role a área e chame DrawFocusRect novamente para desenhar o retângulo na nova posição.

Windows XP: O retângulo de foco agora pode ser mais grosso do que 1 pixel, portanto, é mais visível para exibições de alta resolução e alta densidade e necessidades de acessibilidade. Isso é tratado pelo SPI_SETFOCUSBORDERWIDTH e SPI_SETFOCUSBORDERHEIGHT em SystemParametersInfo.

Exemplos

Para obter um exemplo, consulte "Criando uma caixa de listagem Owner-Drawn" em Usando caixas de listagem.

Requisitos

Confira também

Framerect

Funções de pintura e desenho

Visão geral de pintura e desenho

RECT