Classe CMFCCaptionButton
La CMFCCaptionButton classe implementa un pulsante visualizzato sulla barra della didascalia per un riquadro di ancoraggio o una finestra con mini frame. In genere, il framework crea automaticamente pulsanti della barra del titolo.
Sintassi
class CMFCCaptionButton : public CObject
Membri
Costruttori
| Nome | Descrizione |
|---|---|
| CMFCCaptionButton::CMFCCaptionButton | Costruisce un oggetto CMFCCaptionButton. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CMFCCaptionButton::GetHit | Restituisce il comando rappresentato dal pulsante . |
| CMFCCaptionButton::GetIconID | Restituisce l'ID immagine associato al pulsante. |
| CMFCCaptionButton::GetRect | Restituisce il rettangolo occupato dal pulsante. |
| CMFCCaptionButton::GetSize | Restituisce la larghezza e l'altezza del pulsante. |
| CMFCCaptionButton::IsMiniFrameButton | Indica se l'altezza della barra del titolo è impostata su dimensioni mini. |
| CMFCCaptionButton::Move | Imposta il percorso di disegno del pulsante e lo stato della finestra. |
| CMFCCaptionButton::OnDraw | Disegna il pulsante della didascalia. |
| CMFCCaptionButton::SetMiniFrameButton | Imposta le dimensioni mini della barra del titolo. |
Osservazioni:
È possibile derivare una classe dalla classe CPaneFrameWnd e usare il metodo protetto, AddButton, per aggiungere pulsanti di didascalia a una finestra con mini frame.
CPaneFrameWnd.h definisce gli ID comando per due tipi di pulsanti didascalia:
AFX_CAPTION_BTN_PIN, che visualizza un pulsante di aggiunta quando il riquadro di ancoraggio supporta la modalità nascondi automaticamente.
AFX_CAPTION_BTN_CLOSE, che visualizza un pulsante Chiudi quando il riquadro può essere chiuso o nascosto.
Esempio
Nell'esempio seguente viene illustrato come costruire un CMFCCaptionButton oggetto e impostare le mini dimensioni della barra del titolo.
CMFCCaptionButton *captionButton = new CMFCCaptionButton(AFX_HTCLOSE);
captionButton->SetMiniFrameButton(true);
Gerarchia di ereditarietà
Requisiti
Intestazione: afxcaptionbutton.h
CMFCCaptionButton::CMFCCaptionButton
Costruisce un oggetto CMFCCaptionButton.
CMFCCaptionButton();
CMFCCaptionButton(
UINT nHit,
BOOL bLeftAlign = FALSE);
Parametri
nHit
[in] Comando associato al pulsante.
bLeftAlign
[in] Specifica se il pulsante è allineato a sinistra.
Nella tabella seguente sono elencati i valori possibili per il parametro nHit .
| Valore | Comando |
|---|---|
| AFX_HTCLOSE | Pulsante Chiudi. |
| HTMINBUTTON | Pulsante Riduci a icona. |
| HTMAXBUTTON | Pulsante Ingrandisci. |
| AFX_HTLEFTBUTTON | Pulsante freccia sinistra. |
| AFX_HTRIGHTBUTTON | Pulsante freccia destra. |
| AFX_HTMENU | Pulsante di menu freccia giù. |
| HTNOWHERE | Valore predefinito; non rappresenta alcun comando. |
Osservazioni:
Per impostazione predefinita, i pulsanti della didascalia non sono associati a un comando.
I pulsanti didascalia sono allineati a destra o a sinistra.
CMFCCaptionButton::GetHit
Restituisce il comando rappresentato dal pulsante .
UINT GetHit() const;
Valore restituito
Comando rappresentato dal pulsante .
Nella tabella seguente sono elencati i possibili valori restituiti.
| Valore | Comando |
|---|---|
| AFX_HTCLOSE | Pulsante Chiudi. |
| HTMINBUTTON | Pulsante Riduci a icona. |
| HTMAXBUTTON | Pulsante Ingrandisci. |
| AFX_HTLEFTBUTTON | Pulsante freccia sinistra. |
| AFX_HTRIGHTBUTTON | Pulsante freccia destra. |
| AFX_HTMENU | Pulsante di menu freccia giù. |
| HTNOWHERE | Valore predefinito; non rappresenta alcun comando. |
CMFCCaptionButton::GetIconID
Restituisce l'ID immagine associato al pulsante.
virtual CMenuImages::IMAGES_IDS GetIconID(
BOOL bHorz,
BOOL bMaximized = FALSE) const;
Parametri
bHorz
[in] TRUE per ID immagine freccia sinistra o destra; FALSE per gli ID immagine freccia su o giù.
bMaximized
[in] TRUE per un ID immagine ingrandisci; FALSE per un ID immagine ridotto a icona.
Valore restituito
ID immagine.
Osservazioni:
I parametri specificano gli ID immagine per ridurre o ingrandire i pulsanti di didascalia.
CMFCCaptionButton::GetRect
Restituisce il rettangolo occupato dal pulsante.
virtual CRect GetRect() const;
Valore restituito
Rettangolo che rappresenta la posizione del pulsante.
Osservazioni:
Se non è possibile visualizzare il pulsante, la dimensione restituita è 0.
CMFCCaptionButton::GetSize
Restituisce la larghezza e l'altezza del pulsante.
static CSize GetSize();
Valore restituito
Dimensioni esterne del pulsante.
Osservazioni:
Le dimensioni restituite includono margine pulsante e bordo.
CMFCCaptionButton::IsMiniFrameButton
Indica se l'altezza della barra del titolo è impostata su dimensioni mini.
BOOL IsMiniFrameButton() const;
Valore restituito
TRUE se la didascalia è impostata su dimensioni mini; in caso contrario FALSE.
Osservazioni:
CMFCCaptionButton::Move
Imposta il percorso di disegno del pulsante e lo stato della finestra.
void Move(
const CPoint& ptTo,
BOOL bHide = FALSE);
Parametri
ptTo
[in] Nuova posizione.
bHide
[in] Indica se visualizzare il pulsante.
CMFCCaptionButton::OnDraw
Disegna il pulsante della didascalia.
virtual void OnDraw(
CDC* pDC,
BOOL bActive,
BOOL bHorz = TRUE,
BOOL bMaximized = TRUE,
BOOL bDisabled = FALSE);
Parametri
pDC
[in] Puntatore a un contesto di dispositivo per il pulsante.
bActive
[in] Indica se disegnare un'immagine del pulsante attiva.
bHorz
[in] Riservato per l'uso in una classe derivata.
bMaximized
[in] Indica se disegnare un'immagine di pulsante ingrandita.
bDisabled
[in] Indica se disegnare un'immagine del pulsante abilitata.
Osservazioni:
Il parametro bMaximized viene usato quando il pulsante è un pulsante ingrandisce o riduce a icona.
CMFCCaptionButton::SetMiniFrameButton
Imposta le dimensioni mini della barra del titolo.
void SetMiniFramebutton(BOOL bSet = TRUE);
Parametri
bSet
[in] TRUE per l'altezza della barra del titolo mini; FALSE per l'altezza predefinita della barra del titolo.
Vedi anche
Grafico della gerarchia
Classi
Classe CPaneFrameWnd
Classe CDockablePane