Classe di CButton

Articolo
03/05/2013

Fornisce funzionalità dei pulsanti di Windows.

class CButton : public CWnd

Membri

Costruttori pubblici

Nome	Descrizione
CButton::CButton	Costruisce un oggetto CButton.

Metodi pubblici

Nome	Descrizione
CButton::Create	Crea il pulsante di Windows e lo aggiunge all'oggetto CButton.
CButton::DrawItem	Override per disegnare un oggetto creato dal proprietario CButton.
CButton::GetBitmap	Recupera l'handle della bitmap precedentemente impostata con SetBitmap.
CButton::GetButtonStyle	Recupera le informazioni sullo stile del pulsante.
CButton::GetCheck	Recupera lo stato di selezione di un pulsante.
CButton::GetCursor	Recupera l'handle di un'immagine del cursore già impostata con SetCursor.
CButton::GetIcon	Recupera l'handle icona precedentemente impostata con SetIcon.
CButton::GetIdealSize	Recupera la dimensione ideale del pulsante.
CButton::GetImageList	Recupera l'elenco delle immagini del pulsante.
CButton::GetNote	Recupera il componente della nota del controllo di collegamento corrente del comando.
CButton::GetNoteLength	Recupera la lunghezza del testo della nota per il controllo di collegamento corrente del comando.
CButton::GetSplitGlyph	Recupera il glifo associato al controllo corrente pulsante di menu combinato.
CButton::GetSplitImageList	Recupera l'elenco di immagini per il controllo corrente pulsante di menu combinato.
CButton::GetSplitInfo	Recupera le informazioni che definiscono il controllo corrente pulsante di menu combinato.
CButton::GetSplitSize	Recupera il rettangolo di delimitazione della parte a discesa del controllo corrente pulsante di menu combinato.
CButton::GetSplitStyle	Recupera gli stili pulsante di menu combinato che definiscono il controllo corrente pulsante di menu combinato.
CButton::GetState	Recupera lo stato di selezione, lo stato di evidenziazione e lo stato attivo di un pulsante.
CButton::GetTextMargin	Recupera il margine del testo del pulsante.
CButton::SetBitmap	Specifica una bitmap da visualizzare sul pulsante.
CButton::SetButtonStyle	Modificare lo stile di un pulsante.
CButton::SetCheck	Imposta lo stato di selezione di un pulsante.
CButton::SetCursor	Specifica un'immagine del cursore da visualizzare sul pulsante.
CButton::SetDropDownState	Imposta lo stato a discesa del controllo corrente pulsante di menu combinato.
CButton::SetIcon	Specificare l'icona da visualizzare sul pulsante.
CButton::SetImageList	Imposta l'elenco delle immagini del pulsante.
CButton::SetNote	Imposta la nota sul controllo di collegamento corrente del comando.
CButton::SetSplitGlyph	Associa un glifo specificato con il controllo corrente pulsante di menu combinato.
CButton::SetSplitImageList	Associa un elenco immagini con il controllo corrente pulsante di menu combinato.
CButton::SetSplitInfo	Specifica le informazioni che definiscono il controllo corrente pulsante di menu combinato.
CButton::SetSplitSize	Imposta il rettangolo di delimitazione della parte a discesa del controllo corrente pulsante di menu combinato.
CButton::SetSplitStyle	Imposta lo stile del controllo corrente pulsante di menu combinato.
CButton::SetState	Imposta lo stato dell'evidenziazione di un pulsante.
CButton::SetTextMargin	Imposta il margine del testo del pulsante.

Note

Un pulsante è una piccola, finestra figlio rettangolare che può essere selezionato e chiuderlo.I pulsanti possono essere utilizzati da solo o in gruppi e possono essere contrassegnati o senza visualizzare testo.Un pulsante in genere modifica l'aspetto quando l'utente fa clic su.

I tipici pulsanti sono la casella di controllo, il pulsante di opzione e il pulsante.Un oggetto CButton può rappresentare uno di questi, come specificato nella stile del pulsante inizializzazione dalla funzione membro Crea.

Inoltre, la classe CBitmapButton derivata da CButton supporta la creazione di pulsanti contrassegnati con immagini bitmap anziché testo.CBitmapButton può avere bitmap separate per un pulsante su, il basso, con gli stati e disabilitati.

È possibile creare un pulsante da un modello di finestra di dialogo o direttamente nel codice.In entrambi i casi, chiamare prima il costruttore CButton per costruire l'oggetto CButton ; chiamare la funzione membro Crea per creare il pulsante di Windows e per associarlo all'oggetto CButton.

La costruzione può essere un processo una fase in una classe derivata da CButton.Scrivere un costruttore per la classe derivata e chiamare Crea dal costruttore.

Se si desidera gestire i messaggi di notifica di Windows inviati da un pulsante al controllo padre (in genere una classe derivata da CDialog), aggiungere una voce della mappa messaggi e una funzione membro per la gestione dei messaggi nella classe padre per ogni messaggio.

Ogni voce della mappa messaggi accetta il formato seguente:

Notifica**(id, memberFxn)diON_**

dove specifica id la finestra figlio ID del controllo che invia una notifica e memberFxn è il nome della funzione membro che padre è stato scritto per gestire la notifica.

Il prototipo del padre è la seguente:

afx_msgvoidmemberFxn**( );**

Le voci della mappa messaggi possibili sono:

Voce di mapping	Inviato al padre quando…
ON_BN_CLICKED	L'utente fa clic su un pulsante.
ON_BN_DOUBLECLICKED	L'utente fa doppio clic su un pulsante.

Se si crea un oggetto CButton da una risorsa finestra di dialogo, l'oggetto CButton automaticamente eliminato quando l'utente chiude la finestra di dialogo.

Se si crea un oggetto CButton interno di una finestra, potrebbe essere necessario distruggerla.Se si crea l'oggetto CButton nell'heap mediante la funzione new, è necessario chiamare delete sull'oggetto per distruggerlo quando l'utente chiude il pulsante di Windows.Se si crea l'oggetto CButton nello stack, o è incorporato nell'oggetto finestra di dialogo padre, verrà automaticamente eliminato.