Funzione DrawFrameControl (winuser.h)

  • Articolo

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