Condividi tramite


Funzione DrawFrameControl (winuser.h)

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