Función DrawFocusRect (winuser.h)

La función DrawFocusRect dibuja un rectángulo en el estilo utilizado para indicar que el rectángulo tiene el foco.

Sintaxis

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

Parámetros

[in] hDC

Identificador del contexto del dispositivo.

[in] lprc

Puntero a una estructura RECT que especifica las coordenadas lógicas del rectángulo.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

DrawFocusRect solo funciona en modo MM_TEXT.

Dado que DrawFocusRect es una función XOR, llamándola una segunda vez con el mismo rectángulo quita el rectángulo de la pantalla.

Esta función dibuja un rectángulo que no se puede desplazar. Para desplazarse por un área que contenga un rectángulo dibujado por esta función, llame a DrawFocusRect para quitar el rectángulo de la pantalla, desplazarse por el área y, a continuación, llamar a DrawFocusRect de nuevo para dibujar el rectángulo en la nueva posición.

Windows XP: El rectángulo de foco ahora puede ser más grueso que 1 píxel, por lo que es más visible para las pantallas de alta resolución, alta densidad y las necesidades de accesibilidad. Esto se controla mediante el SPI_SETFOCUSBORDERWIDTH y el SPI_SETFOCUSBORDERHEIGHT en SystemParametersInfo.

Ejemplos

Para obtener un ejemplo, vea "Crear un cuadro de lista Owner-Drawn" en Usar cuadros de lista.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-draw-l1-1-0 (introducido en Windows 8)

Consulte también

FrameRect

Funciones de dibujo y pintura

Información general sobre la pintura y el dibujo

RECT