Classe CMFCRibbonCheckBox
La classe CMFCRibbonCheckBox implementa una casella di controllo che è possibile aggiungere a un pannello della barra multifunzione, a una barra di accesso rapido o a un menu di scelta rapida.
Sintassi
class CMFCRibbonCheckBox : public CMFCRibbonButton
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
| CMFCRibbonCheckBox::CMFCRibbonCheckBox | Costruttore. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CMFCRibbonCheckBox::GetCompactSize | (sostituzioni )CMFCRibbonButton::GetCompactSize. |
| CMFCRibbonCheckBox::GetIntermediateSize | (sostituzioni )CMFCRibbonButton::GetIntermediateSize. |
| CMFCRibbonCheckBox::GetRegularSize | (sostituzioni )CMFCRibbonButton::GetRegularSize. |
| CMFCRibbonCheckBox::IsDrawTooltipImage | Esegue l'override di CMFCRibbonButton::IsDrawTooltipImage. |
| CMFCRibbonCheckBox::OnDraw | (sostituzioni )CMFCRibbonButton::OnDraw. |
| CMFCRibbonCheckBox::OnDrawMenuImage | (sostituzioni )CMFCRibbonBaseElement::OnDrawMenuImage. |
| CMFCRibbonCheckBox::OnDrawOnList | Esegue l'override di CMFCRibbonButton::OnDrawOnList. |
| CMFCRibbonCheckBox::SetACCData | (sostituzioni )CMFCRibbonButton::SetACCData. |
Osservazioni:
Per usare un CMFCRibbonCheckBox nell'applicazione, aggiungere il seguente costruttore al codice:
CMFCRibbonCheckBox (UINT nID, LPCTSTR lpszText)
dove nID è l'ID comando della casella di controllo e lpszText è l'etichetta di testo della casella di controllo.
È possibile aggiungere una casella di controllo a un pannello della barra multifunzione usando CMFCRibbonPanel::Add.
Gerarchia di ereditarietà
Requisiti
Intestazione: afxribboncheckbox.h
CMFCRibbonCheckBox::CMFCRibbonCheckBox
Costruttore di un oggetto casella di controllo della barra multifunzione
CMFCRibbonCheckBox(
UINT nID,
LPCTSTR lpszText);
Parametri
nID
[in] Specifica l'ID comando.
lpszText
[in] Specifica l'etichetta di testo.
Valore restituito
Costruisce un oggetto casella di controllo della barra multifunzione.
Esempio
Nell'esempio seguente viene illustrato come costruire un oggetto della CMFCRibbonCheckBox classe .
strTemp.LoadString(IDS_RIBBON_STATUSBAR);
CMFCRibbonButton *pBtnStatusBar = new CMFCRibbonCheckBox(ID_VIEW_STATUS_BAR, strTemp);
CMFCRibbonCheckBox::GetCompactSize
In caso di override, ottiene la dimensione compatta della casella di controllo.
virtual CSize GetCompactSize(CDC* pDC);
Parametri
pDC
[in] Puntatore al CDC associato alla casella di controllo.
Valore restituito
Restituisce un CSize oggetto contenente la dimensione compatta della casella di controllo.
Osservazioni:
Se non ne viene eseguito l'override, restituisce le dimensioni intermedie della casella di controllo.
CMFCRibbonCheckBox::GetIntermediateSize
Ottiene le dimensioni intermedie della casella di controllo.
virtual CSize GetIntermediateSize(CDC* pDC);
Parametri
pDC
[in] Puntatore al CDC associato a questa casella di controllo.
Valore restituito
Oggetto CSize contenente le dimensioni intermedie della casella di controllo.
Osservazioni:
Se non ne viene eseguito l'override, calcola le dimensioni intermedie come dimensione predefinita della casella di controllo ( AFX_CHECK_BOX_DEFAULT_SIZE) più le dimensioni del testo, più i margini.
CMFCRibbonCheckBox::GetRegularSize
Ottiene le dimensioni regolari della casella di controllo.
virtual CSize GetRegularSize(CDC* pDC);
Parametri
pDC
[in] Puntatore all'oggetto CDC associato a questa casella di controllo.
Valore restituito
Restituisce un CSize oggetto contenente le dimensioni regolari della casella di controllo.
Osservazioni:
Se non ne viene eseguito l'override, restituisce le dimensioni intermedie della casella di controllo.
CMFCRibbonCheckBox::IsDrawTooltipImage
Indica se è presente un'immagine della descrizione comando associata alla casella di controllo.
virtual BOOL IsDrawTooltipImage() const;
Valore restituito
Restituisce TRUE se è presente un'immagine della descrizione comando associata alla casella di controllo oppure FALSE in caso contrario.
Osservazioni:
CMFCRibbonCheckBox::OnDraw
Chiamato dal framework per disegnare la casella di controllo usando un contesto di dispositivo specificato.
virtual void OnDraw(CDC* pDC);
Parametri
pDC
[in] Puntatore a CDC in cui disegnare la casella di controllo.
Osservazioni:
CMFCRibbonCheckBox::OnDrawMenuImage
Chiamato dal framework per disegnare un'immagine di menu per la casella di controllo.
virtual BOOL OnDrawMenuImage(CDC*, CRect);
Parametri
[in] CDC*
Puntatore al CDC associato alla casella di controllo.
CRect
[in] Oggetto CRect che specifica il rettangolo in cui disegnare l'immagine del menu.
Valore restituito
Restituisce TRUE se l'immagine è stata disegnata o FALSE in caso contrario.
Osservazioni:
Se non ne viene eseguito l'override, restituisce FALSE.
CMFCRibbonCheckBox::OnDrawOnList
Chiamato dal framework per disegnare la casella di controllo in una casella di riepilogo comandi.
virtual void OnDrawOnList(
CDC* pDC,
CString strText,
int nTextOffset,
CRect rect,
BOOL bIsSelected,
BOOL bHighlighted);
Parametri
pDC
[in] Puntatore al contesto del dispositivo in cui disegnare la casella di controllo.
strText
[in] Testo visualizzato.
nTextOffset
[in] Distanza, in pixel, dal lato sinistro della casella di riepilogo al testo visualizzato.
rect
[in] Rettangolo di visualizzazione per la casella di controllo.
bIsSelected
[in] TRUE se la casella di controllo è selezionata o FALSE in caso contrario.
bHighlighted
[in] TRUE se la casella di controllo è evidenziata o FALSE in caso contrario.
Osservazioni:
CMFCRibbonCheckBox::SetACCData
Imposta i dati di accessibilità per la casella di controllo.
virtual BOOL SetACCData(
CWnd* pParent,
CAccessibilityData& data);
Parametri
pParent
Finestra padre della casella di controllo.
data
Dati di accessibilità per la casella di controllo.
Valore restituito
Restituisce sempre TRUE.
Osservazioni:
Per impostazione predefinita, questo metodo imposta i dati di accessibilità per la casella di controllo e restituisce sempre TRUE. Eseguire l'override di questo metodo per impostare i dati di accessibilità e restituire un valore che indica l'esito positivo o negativo.