Función FrameRect (winuser.h)

Artículo
03/04/2024

La función FrameRect dibuja un borde alrededor del rectángulo especificado mediante el pincel especificado. El ancho y el alto del borde siempre son una unidad lógica.

Sintaxis

int FrameRect(
  [in] HDC        hDC,
  [in] const RECT *lprc,
  [in] HBRUSH     hbr
);

Parámetros

[in] hDC

Identificador del contexto del dispositivo en el que se dibuja el borde.

[in] lprc

Puntero a una estructura RECT que contiene las coordenadas lógicas de las esquinas superior izquierda e inferior derecha del rectángulo.

[in] hbr

Identificador del pincel usado para dibujar el borde.

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

El pincel identificado por el parámetro hbr debe haberse creado mediante la función CreateHatchBrush, CreatePatternBrush o CreateSolidBrush , o recuperada mediante la función GetStockObject .

Si el miembro inferior de la estructura RECT es menor que el miembro superior , o si el miembro derecho es menor que el miembro izquierdo , la función no dibuja el rectángulo.

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-gui-l1-1-1 (introducido en Windows 8.1)