Funzione DrawFrameControl (winuser.h)

Articolo
03/09/2024

La funzione DrawFrameControl disegna un controllo frame del tipo e dello stile specificati.

Sintassi

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

Parametri

[in] hdc

Handle per il contesto di dispositivo della finestra in cui disegnare il controllo.

[in] lprc

Puntatore a una struttura RECT contenente le coordinate logiche del rettangolo di delimitazione per il controllo cornice.

[in] uType

Tipo di controllo frame da disegnare. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
DFC_BUTTON	Pulsante Standard
DFC_CAPTION	Barra del titolo
DFC_MENU	Barra dei menu
DFC_POPUPMENU	Voce di menu Popup.
DFC_SCROLL	Barra di scorrimento

[in] uState

Stato iniziale del controllo frame. Se uType è DFC_BUTTON, uState può essere uno dei valori seguenti.

Valore	Significato
DFCS_BUTTON3STATE	Pulsante a tre stati
DFCS_BUTTONCHECK	Casella di controllo
DFCS_BUTTONPUSH	Pulsante
DFCS_BUTTONRADIO	Pulsante di opzione
DFCS_BUTTONRADIOIMAGE	Immagine per il pulsante di opzione (immagine non necessaria)
DFCS_BUTTONRADIOMASK	Maschera per il pulsante di opzione (maschera non necessaria maschera)

Se uType è DFC_CAPTION, uState può essere uno dei valori seguenti.

Valore	Significato
DFCS_CAPTIONCLOSE	Pulsante Chiudi
DFCS_CAPTIONHELP	Pulsante Guida
DFCS_CAPTIONMAX	Pulsante Ingrandisci
DFCS_CAPTIONMIN	Pulsante Riduci a icona
DFCS_CAPTIONRESTORE	Pulsante Ripristina

Se uType è DFC_MENU, uState può essere uno dei valori seguenti.

Valore	Significato
DFCS_MENUARROW	Freccia sottomenu
DFCS_MENUARROWRIGHT	Freccia sottomenu che punta a sinistra. Viene usato per i menu a catena da destra a sinistra usati con lingue da destra a sinistra, ad esempio arabo o ebraico.
DFCS_MENUBULLET	Proiettile
DFCS_MENUCHECK	Segno di spunta

Se uType è DFC_SCROLL, uState può essere uno dei valori seguenti.

Valore	Significato
DFCS_SCROLLCOMBOBOX	Barra di scorrimento casella combinata
DFCS_SCROLLDOWN	Freccia giù della barra di scorrimento
DFCS_SCROLLLEFT	Freccia sinistra della barra di scorrimento
DFCS_SCROLLRIGHT	Freccia destra della barra di scorrimento
DFCS_SCROLLSIZEGRIP	Ridimensionamento nell'angolo inferiore destro della finestra
DFCS_SCROLLSIZEGRIPRIGHT	Ridimensiona il grip nell'angolo inferiore sinistro della finestra. Viene usato con lingue da destra a sinistra, ad esempio arabo o ebraico.
DFCS_SCROLLUP	Freccia su della barra di scorrimento

Lo stile seguente può essere utilizzato per regolare il rettangolo di delimitazione del pulsante di pressione.

Valore	Significato
DFCS_ADJUSTRECT	Il rettangolo di delimitazione viene regolato in modo da escludere il bordo circostante del pulsante di selezione.

È possibile utilizzare uno o più dei valori seguenti per impostare lo stato del controllo da disegnare.

Valore	Significato
DFCS_CHECKED	Il pulsante è selezionato.
DFCS_FLAT	Il pulsante ha un bordo piatto.
DFCS_HOT	Il pulsante viene rilevato a caldo.
DFCS_INACTIVE	Il pulsante è inattivo (disattivato).
DFCS_MONO	Il pulsante ha un bordo monocromatico.
DFCS_PUSHED	Il pulsante viene premuto.
DFCS_TRANSPARENT	Lo sfondo rimane invariato. Questo flag può essere combinato solo con DFCS_MENUARROWUP o DFCS_MENUARROWDOWN.

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

Se uType è DFC_MENU o DFC_BUTTON e uState non è DFCS_BUTTONPUSH, il controllo cornice è una maschera bianca nera, ovvero un controllo cornice nera su uno sfondo bianco. In questi casi, l'applicazione deve passare un handle a un controllo del dispositivo di memoria bitmap. L'applicazione può quindi usare la bitmap associata come parametro hbmMask per la funzione MaskBlt oppure può usare il contesto di dispositivo come parametro per la funzione BitBlt usando ROP, ad esempio SRCAND e SRCINVERT.

Virtualizzazione DPI

Questa API non partecipa alla virtualizzazione DPI. L'input specificato è sempre in termini di pixel fisici e non è correlato al contesto chiamante.

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-2 (introdotto in Windows 10 versione 10.0.10240)

Vedi anche

Funzioni di disegno e disegno

Panoramica di disegno e disegno

RECT

Condividi tramite