Classe CMFCRibbonSeparator
Implementa il separatore della barra multifunzione.
Sintassi
class CMFCRibbonSeparator : public CMFCRibbonBaseElement
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
| CMFCRibbonSeparator::CMFCRibbonSeparator | Costruisce un oggetto CMFCRibbonSeparator. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CMFCRibbonSeparator::AddToListBox | Aggiunge un separatore all'elenco Comandi nella finestra di dialogo Personalizza . (sostituzioni )CMFCRibbonBaseElement::AddToListBox. |
CMFCRibbonSeparator::CreateObject |
Usato dal framework per creare un'istanza dinamica di questo tipo di classe. |
CMFCRibbonSeparator::GetThisClass |
Usato dal framework per ottenere un puntatore all'oggetto CRuntimeClass associato a questo tipo di classe. |
Metodi protetti
| Nome | Descrizione |
|---|---|
| CMFCRibbonSeparator::CopyFrom | Metodo di copia che imposta le variabili membro di un separatore da un altro oggetto. |
| CMFCRibbonSeparator::GetRegularSize | Restituisce le dimensioni di un separatore. |
| CMFCRibbonSeparator::IsSeparator | Indica se si tratta di un separatore. |
| CMFCRibbonSeparator::IsTabStop | Indica se si tratta di una tabulazione. |
| CMFCRibbonSeparator::OnDraw | Chiamato dal sistema per disegnare il separatore sulla barra multifunzione o sulla barra di accesso rapido. |
| CMFCRibbonSeparator::OnDrawOnList | Chiamato dal sistema per disegnare il separatore nell'elenco Comandi . |
Osservazioni:
Un separatore della barra multifunzione è una linea verticale o orizzontale che separa logicamente gli elementi della barra multifunzione. È possibile disegnare un separatore sul controllo barra multifunzione, sul menu principale dell'applicazione, sulla barra di stato della barra multifunzione e sulla barra di accesso rapido.
Per usare un separatore nell'applicazione, costruire il nuovo oggetto e aggiungerlo al menu principale dell'applicazione, come illustrato di seguito:
CMFCRibbonMainPanel* pMainPanel = m_wndRibbonBar.AddMainCategory(_T("Main Menu"),
IDB_FILESMALL,
IDB_FILELARGE);
...
pMainPanel->Add(new CMFCRibbonSeparator(TRUE));
Chiama CMFCRibbonPanel::AddSeparator per aggiungere separatori ai pannelli della barra multifunzione. I separatori vengono allocati e aggiunti internamente dal AddSeparator metodo .
Gerarchia di ereditarietà
Requisiti
Intestazione: afxbaseribbonelement.h
CMFCRibbonSeparator::AddToListBox
Aggiunge un separatore all'elenco Comandi nella finestra di dialogo Personalizza .
virtual int AddToListBox(
CMFCRibbonCommandsListBox* pWndListBox,
BOOL bDeep);
Parametri
pWndListBox
[in] Puntatore all'elenco Comandi in cui viene aggiunto il separatore.
bDeep
[in] Ignorato.
Valore restituito
Indice in base zero alla stringa nella casella di riepilogo specificata da pWndListBox.
CMFCRibbonSeparator::CMFCRibbonSeparator
Costruisce un oggetto CMFCRibbonSeparator.
CMFCRibbonSeparator(BOOL bIsHoriz = FALSE);
Parametri
bIsHoriz
[in] Se TRUE, il separatore è orizzontale; se FALSE, il separatore è verticale.
Osservazioni:
I separatori orizzontali vengono usati nei menu dell'applicazione. I separatori verticali vengono usati nelle barre degli strumenti.
Esempio
Nell'esempio seguente viene illustrato come costruire un oggetto della CMFCRibbonSeparator classe .
// CMFCRibbonMainPanel* pMainPanel
pMainPanel->Add(new CMFCRibbonSeparator(TRUE));
CMFCRibbonSeparator::CopyFrom
Metodo di copia che imposta le variabili membro di un separatore da un altro oggetto.
virtual void CopyFrom(const CMFCRibbonBaseElement& src);
Parametri
Src
[in] Elemento della barra multifunzione di origine da cui copiare.
CMFCRibbonSeparator::GetRegularSize
Restituisce le dimensioni di un separatore.
virtual CSize GetRegularSize(CDC* pDC);
Parametri
pDC
[in] Puntatore a un contenuto del dispositivo.
Valore restituito
Dimensioni del separatore nel contesto di dispositivo specificato.
CMFCRibbonSeparator::IsSeparator
Indica se si tratta di un separatore.
virtual BOOL IsSeparator() const;
Valore restituito
Sempre TRUE per questa classe.
CMFCRibbonSeparator::IsTabStop
Indica se si tratta di una tabulazione.
virtual BOOL IsTabStop() const;
Valore restituito
Sempre FALSE per questa classe.
Osservazioni:
Un separatore della barra multifunzione non è una tabulazione.
CMFCRibbonSeparator::OnDraw
Chiamato dal sistema per disegnare il separatore sulla barra multifunzione o sulla barra di accesso rapido.
virtual void OnDraw(CDC* pDC);
Parametri
pDC
[in] Puntatore a un contesto di dispositivo.
CMFCRibbonSeparator::OnDrawOnList
Chiamato dal sistema per disegnare il separatore nell'elenco Comandi .
virtual void OnDrawOnList(
CDC* pDC,
CString strText,
int nTextOffset,
CRect rect,
BOOL bIsSelected,
BOOL bHighlighted);
Parametri
pDC
[in] Puntatore a un contesto di dispositivo.
strText
[in] Testo visualizzato nell'elenco.
nTextOffset
[in] Spaziatura tra il testo e il lato sinistro del rettangolo di delimitazione.
rect
[in] Specifica il rettangolo di delimitazione.
bIsSelected
[in] Ignorato.
bHighlighted
[in] Ignorato.