Funzione DrawFocusRect (winuser.h)

La funzione DrawFocusRect disegna un rettangolo nello stile usato per indicare che il rettangolo ha lo stato attivo.

Sintassi

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

Parametri

[in] hDC

Handle nel contesto del dispositivo.

[in] lprc

Puntatore a una struttura RECT che specifica le coordinate logiche del rettangolo.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

DrawFocusRect funziona solo in modalità MM_TEXT.

Poiché DrawFocusRect è una funzione XOR, chiamandola una seconda volta con lo stesso rettangolo rimuove il rettangolo dallo schermo.

Questa funzione disegna un rettangolo che non può essere scorrevole. Per scorrere un'area contenente un rettangolo disegnato da questa funzione, chiamare DrawFocusRect per rimuovere il rettangolo dallo schermo, scorrere l'area e quindi chiamare di nuovo DrawFocusRect per disegnare il rettangolo nella nuova posizione.

Windows XP: Il rettangolo di messa a fuoco può ora essere più spesso di 1 pixel, quindi è più visibile per le esigenze di visualizzazione e accessibilità ad alta risoluzione. Questa operazione viene gestita dal SPI_SETFOCUSBORDERWIDTH e SPI_SETFOCUSBORDERHEIGHT in SystemParametersInfo.

Esempio

Per un esempio, vedere "Creazione di una casella di riepilogo Owner-Drawn" in Uso di caselle di riepilogo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-draw-l1-1-0 (introdotto in Windows 8)

Vedi anche

FrameRect

Funzioni di disegno e disegno

Panoramica di disegno e disegno

RECT