Condividi tramite

Classe CMFCCaptionButton

  • Articolo

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à

CObject

CMFCCaptionButton

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