Função DrawFocusRect (winuser.h)

  • Artigo

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

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 winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll
Conjunto de APIs ext-ms-win-ntuser-draw-l1-1-0 (introduzido em Windows 8)

Confira também

Framerect

Funções de pintura e desenho

Visão geral de pintura e desenho

RECT