DrawFocusRect-Funktion (winuser.h)

Die DrawFocusRect-Funktion zeichnet ein Rechteck im Format, das verwendet wird, um anzugeben, dass das Rechteck den Fokus hat.

Syntax

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

Parameter

[in] hDC

Ein Handle für den Gerätekontext.

[in] lprc

Ein Zeiger auf eine RECT-Struktur , die die logischen Koordinaten des Rechtecks angibt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

DrawFocusRect funktioniert nur im MM_TEXT Modus.

Da Es sich bei DrawFocusRect um eine XOR-Funktion handelt, wird das Rechteck, wenn sie ein zweites Mal mit demselben Rechteck aufgerufen wird, vom Bildschirm entfernt.

Diese Funktion zeichnet ein Rechteck, das nicht scrollen kann. Um einen Bereich zu scrollen, der ein rechteck enthält, das von dieser Funktion gezeichnet wurde, rufen Sie DrawFocusRect auf, um das Rechteck vom Bildschirm zu entfernen, scrollen Sie den Bereich, und rufen Sie dann DrawFocusRect erneut auf, um das Rechteck an der neuen Position zu zeichnen.

Windows XP: Das Fokusrechteck kann jetzt dicker als 1 Pixel sein, sodass es für hochauflösende Displays mit hoher Dichte und Barrierefreiheit besser sichtbar ist. Dies wird vom SPI_SETFOCUSBORDERWIDTH und SPI_SETFOCUSBORDERHEIGHT in SystemParametersInfo behandelt.

Beispiele

Ein Beispiel finden Sie unter Erstellen eines Owner-Drawn Listenfelds unter Verwenden von Listenfeldern.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-draw-l1-1-0 (eingeführt in Windows 8)

Weitere Informationen

FrameRect

Mal- und Zeichenfunktionen

Übersicht über Malerei und Zeichnung

RECT