DrawFrameControl-Funktion (winuser.h)

Artikel
03/07/2024

Die DrawFrameControl-Funktion zeichnet ein Rahmensteuerelement des angegebenen Typs und Stils.

Syntax

BOOL DrawFrameControl(
  [in] HDC    hdc,
  [in] LPRECT lprc,
  [in] UINT   uType,
  [in] UINT   uState
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext des Fensters, in dem das Steuerelement gezeichnet werden soll.

[in] lprc

Ein Zeiger auf eine RECT-Struktur , die die logischen Koordinaten des umgebenden Rechtecks für das Framesteuerelement enthält.

[in] uType

Der Typ des zu zeichnenden Framesteuerelements. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
DFC_BUTTON	Schaltfläche "Standard"
DFC_CAPTION	Titelleiste
DFC_MENU	Menüleiste
DFC_POPUPMENU	Popupmenüelement
DFC_SCROLL	Bildlaufleiste

[in] uState

Der Anfangszustand des Framesteuerelements. Wenn uType DFC_BUTTON ist, kann uState einer der folgenden Werte sein.

Wert	Bedeutung
DFCS_BUTTON3STATE	Schaltfläche mit drei Status
DFCS_BUTTONCHECK	Kontrollkästchen
DFCS_BUTTONPUSH	Schaltfläche drücken
DFCS_BUTTONRADIO	Optionsfeld
DFCS_BUTTONRADIOIMAGE	Bild für Optionsfeld (nonsquare benötigt Bild)
DFCS_BUTTONRADIOMASK	Maske für Optionsfeld (nonsquare needs mask)

Wenn uType DFC_CAPTION ist, kann uState einer der folgenden Werte sein.

Wert	Bedeutung
DFCS_CAPTIONCLOSE	Schaltfläche Schließen
DFCS_CAPTIONHELP	Schaltfläche "Hilfe "
DFCS_CAPTIONMAX	Schaltfläche "Maximieren"
DFCS_CAPTIONMIN	Schaltfläche "Minimieren"
DFCS_CAPTIONRESTORE	Schaltfläche "Wiederherstellen "

Wenn uType DFC_MENU ist, kann uState einer der folgenden Werte sein.

Wert	Bedeutung
DFCS_MENUARROW	Untermenüpfeil
DFCS_MENUARROWRIGHT	Untermenüpfeil, der nach links zeigt. Dies wird für die kaskadierenden Menüs von rechts nach links verwendet, die mit Sprachen von rechts nach links wie Arabisch oder Hebräisch verwendet werden.
DFCS_MENUBULLET	Kugel
DFCS_MENUCHECK	Häkchen

Wenn uType DFC_SCROLL ist, kann uState einer der folgenden Werte sein.

Wert	Bedeutung
DFCS_SCROLLCOMBOBOX	Kombinationsfeld-Scrollleiste
DFCS_SCROLLDOWN	Pfeil nach unten der Bildlaufleiste
DFCS_SCROLLLEFT	Pfeil nach links der Bildlaufleiste
DFCS_SCROLLRIGHT	Pfeil nach rechts der Bildlaufleiste
DFCS_SCROLLSIZEGRIP	Größengriff in der unteren rechten Ecke des Fensters
DFCS_SCROLLSIZEGRIPRIGHT	Größengriff in der unteren linken Ecke des Fensters. Dies wird mit Rechts-nach-links-Sprachen wie Arabisch oder Hebräisch verwendet.
DFCS_SCROLLUP	Pfeil nach oben der Bildlaufleiste

Der folgende Stil kann verwendet werden, um das umgebende Rechteck der Schaltfläche anzupassen.

Wert	Bedeutung
DFCS_ADJUSTRECT	Das umgebende Rechteck wird so eingestellt, dass der umgebende Rand der Schaltfläche ausgeschlossen wird.

Mindestens einer der folgenden Werte kann verwendet werden, um den Zustand des zu zeichnenden Steuerelements festzulegen.

Wert	Bedeutung
DFCS_CHECKED	Schaltfläche ist aktiviert.
DFCS_FLAT	Die Schaltfläche hat einen flachen Rahmen.
DFCS_HOT	Die Schaltfläche wird heiß nachverfolgt.
DFCS_INACTIVE	Die Schaltfläche ist inaktiv (abgeblendet).
DFCS_MONO	Schaltfläche hat einen monochromen Rahmen.
DFCS_PUSHED	Taste wird gedrückt.
DFCS_TRANSPARENT	Der Hintergrund bleibt unverändert. Dieses Flag kann nur mit DFCS_MENUARROWUP oder DFCS_MENUARROWDOWN kombiniert werden.

Rückgabewert

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

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

Hinweise

Wenn uType entweder DFC_MENU oder DFC_BUTTON und uState nicht DFCS_BUTTONPUSH ist, ist das Frame-Steuerelement eine Schwarz-Weiß-Maske (d.a. ein schwarzes Frame-Steuerelement auf weißem Hintergrund). In solchen Fällen muss die Anwendung ein Handle an ein Bitmapspeichergerätesteuerelement übergeben. Die Anwendung kann dann die zugeordnete Bitmap als hbmMask-Parameter für die MaskBlt-Funktion verwenden oder den Gerätekontext als Parameter für die BitBlt-Funktion mithilfe von ROPs wie SRCAND und SRCINVERT verwenden.

DPI-Virtualisierung

Diese API ist nicht an der DPI-Virtualisierung beteiligt. Die angegebene Eingabe bezieht sich immer auf physische Pixel und ist nicht mit dem aufrufenden Kontext verknüpft.

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-2 (eingeführt in Windows 10, Version 10.0.10240)

Weitere Informationen

Mal- und Zeichenfunktionen

Übersicht über Malerei und Zeichnung

RECT

Freigeben über