Classe CMFCAutoHideButton
Pulsante che visualizza o nasconde una CDockablePane Class configurata per nascondere elementi.
Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.
Sintassi
class CMFCAutoHideButton : public CObject
Membri
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CMFCAutoHideButton::BringToTop | |
| CMFCAutoHideButton::Create | Crea e inizializza il pulsante Nascondi automaticamente. |
| CMFCAutoHideButton::GetAlignment | Recupera l'allineamento del pulsante Nascondi automaticamente. |
| CMFCAutoHideButton::GetAutoHideWindow | Restituisce l'oggetto CDockablePane associato al pulsante nascondi automaticamente. |
| CMFCAutoHideButton::GetParentToolBar | |
| CMFCAutoHideButton::GetRect | |
| CMFCAutoHideButton::GetSize | Determina le dimensioni del pulsante Nascondi automaticamente. |
| CMFCAutoHideButton::GetTextSize | Restituisce le dimensioni dell'etichetta di testo per il pulsante Nascondi automaticamente. |
| CMFCAutoHideButton::HighlightButton | Evidenzia il pulsante Nascondi automaticamente. |
| CMFCAutoHideButton::IsActive | Indica se il pulsante Nascondi automaticamente è attivo. |
| CMFCAutoHideButton::IsHighlighted | Restituisce lo stato di evidenziazione del pulsante Nascondi automaticamente. |
| CMFCAutoHideButton::IsHorizontal | Determina se il pulsante Nascondi automaticamente è orizzontale o verticale. |
| CMFCAutoHideButton::IsTop | |
| CMFCAutoHideButton::IsVisible | Indica se il pulsante è visibile. |
| CMFCAutoHideButton::Move | |
| CMFCAutoHideButton::OnDraw | Il framework chiama questo metodo quando disegna il pulsante Nascondi automaticamente. |
| CMFCAutoHideButton::OnDrawBorder | Il framework chiama questo metodo quando disegna il bordo di un pulsante Nascondi automaticamente. |
| CMFCAutoHideButton::OnFillBackground | Il framework chiama questo metodo quando riempie lo sfondo di un pulsante Nascondi automaticamente. |
| CMFCAutoHideButton::ReplacePane | |
| CMFCAutoHideButton::ShowAttachedWindow | Visualizza o nasconde la classe CDockablePane associata. |
| CMFCAutoHideButton::ShowButton | Mostra o nasconde il pulsante Nascondi automaticamente. |
| CMFCAutoHideButton::UnSetAutoHideMode |
Osservazioni:
Durante la creazione, l'oggetto CMFCAutoHideButton viene associato a una classe CDockablePane. L'oggetto CDockablePane viene nascosto o visualizzato quando l'utente interagisce con l'oggetto CMFCAutoHideButton.
Per impostazione predefinita, il framework crea automaticamente un oggetto CMFCAutoHideButton quando l'utente attiva il pulsante Nascondi automaticamente. Il framework può creare un elemento di una classe di interfaccia utente personalizzata anziché la classe CMFCAutoHideButton. Per specificare la classe dell'interfaccia utente personalizzata che deve essere usata dal framework, impostare la variabile membro statica CMFCAutoHideBar::m_pAutoHideButtonRTS uguale alla classe dell'interfaccia utente personalizzata. Per impostazione predefinita, questa variabile è impostata su CMFCAutoHideButton.
Esempio
L'esempio seguente illustra come costruire un oggetto CMFCAutoHideButton e usare i vari metodi nella classe CMFCAutoHideButton. L'esempio illustra come inizializzare un oggetto CMFCAutoHideButton usando il relativo metodo Create, visualizzare la classe CDockablePane associata e visualizzare il pulsante Nascondi automaticamente.
CMFCAutoHideButton *autoHideButton = new CMFCAutoHideButton();
CDockablePane cPane;
// CMFCAutoHideBar* pParentBar
if (!autoHideButton->Create(pParentBar, &cPane, CBRS_ALIGN_LEFT))
{
return 0;
}
autoHideButton->ShowAttachedWindow(true);
autoHideButton->ShowButton(true);
Gerarchia di ereditarietà
CMFCAutoHideButton
Requisiti
Intestazione: afxautohidebutton.h
CMFCAutoHideButton::BringToTop
void BringToTop();
Osservazioni:
CMFCAutoHideButton::Create
Crea e inizializza un pulsante nascondi automaticamente.
virtual BOOL Create(
CMFCAutoHideBar* pParentBar,
CDockablePane* pAutoHideWnd,
DWORD dwAlignment);
Parametri
pParentBar
[in] Puntatore alla barra degli strumenti padre.
pAutoHideWnd
[in] Puntatore a un oggetto CDockablePane . Questo pulsante nascondi automaticamente nasconde e mostra che CDockablePane.
dwAlignment
[in] Valore che specifica l'allineamento del pulsante con la finestra cornice principale.
Valore restituito
Diverso da zero se ha esito positivo; in caso contrario 0.
Osservazioni:
Quando si crea un CMFCAutoHideButton oggetto, è necessario associare il pulsante nascondi automaticamente a un oggetto specifico CDockablePane. L'utente può usare il pulsante nascondi automaticamente per nascondere e visualizzare l'oggetto associato CDockablePane.
Il parametro dwAlignment indica dove risiede il pulsante nascondi automaticamente nell'applicazione. Il parametro può essere su uno dei valori seguenti:
CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT
CBRS_ALIGN_TOP
CBRS_ALIGN_BOTTOM
CMFCAutoHideButton::GetAlignment
Recupera l'allineamento del pulsante Nascondi automaticamente.
DWORD GetAlignment() const;
Valore restituito
Valore DWORD che contiene l'allineamento corrente del pulsante nascondi automaticamente.
Osservazioni:
L'allineamento del pulsante nascondi automaticamente indica dove risiede il pulsante nell'applicazione. Può essere uno dei valori seguenti:
CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT
CRBS_ALIGN_TOP
CBRS_ALIGN_BOTTOM
CMFCAutoHideButton::GetAutoHideWindow
Restituisce l'oggetto CDockablePane associato al pulsante nascondi automaticamente.
CDockablePane* GetAutoHideWindow() const;
Valore restituito
Puntatore all'oggetto associato CDockablePane .
Osservazioni:
Per associare un pulsante nascondi automaticamente a un CDockablePaneoggetto , passare come CDockablePane parametro al metodo CMFCAutoHideButton::Create .
CMFCAutoHideButton::GetParentToolBar
CMFCAutoHideBar* GetParentToolBar();
Valore restituito
Osservazioni:
CMFCAutoHideButton::GetRect
CRect GetRect() const;
Valore restituito
Osservazioni:
CMFCAutoHideButton::GetSize
Determina le dimensioni del pulsante Nascondi automaticamente.
CSize GetSize() const;
Valore restituito
Oggetto CSize contenente le dimensioni del pulsante.
Osservazioni:
Le dimensioni calcolate includono le dimensioni del bordo del pulsante nascondi automaticamente.
CMFCAutoHideButton::GetTextSize
Restituisce le dimensioni dell'etichetta di testo per il pulsante Nascondi automaticamente.
virtual CSize GetTextSize() const;
Valore restituito
Oggetto CSize che contiene le dimensioni del testo per il pulsante nascondi automaticamente.
CMFCAutoHideButton::IsActive
Indica se il pulsante Nascondi automaticamente è attivo.
BOOL IsActive() const;
Valore restituito
TRUE se il pulsante nascondi automaticamente è attivo; FALSE in caso contrario.
Osservazioni:
Un pulsante nascondi automaticamente è attivo quando viene visualizzata la finestra della classe CDockablePane associata.
CMFCAutoHideButton::IsHorizontal
Determina se il pulsante Nascondi automaticamente è orizzontale o verticale.
BOOL IsHorizontal() const;
Valore restituito
Diverso da zero se il pulsante è orizzontale; 0 in caso contrario.
Osservazioni:
Il framework imposta l'orientamento di un oggetto CMFCAutoHideButton durante la creazione. È possibile controllare l'orientamento usando il parametro dwAlignment nel metodo CMFCAutoHideButton::Create .
CMFCAutoHideButton::IsTop
BOOL IsTop() const;
Valore restituito
Osservazioni:
CMFCAutoHideButton::IsVisible
Indica se il pulsante nascondi automaticamente è visibile.
virtual BOOL IsVisible() const;
Valore restituito
TRUE se il pulsante è visibile; FALSE in caso contrario.
CMFCAutoHideButton::OnDraw
Il framework chiama questo metodo quando disegna il pulsante Nascondi automaticamente.
virtual void OnDraw(CDC* pDC);
Parametri
pDC
[in] Puntatore a un contesto di dispositivo.
Osservazioni:
Se si vuole personalizzare l'aspetto dei pulsanti nascondi automaticamente nell'applicazione, creare una nuova classe derivata da CMFCAutoHideButton. Nella classe derivata eseguire l'override di questo metodo.
CMFCAutoHideButton::OnDrawBorder
Il framework chiama questo metodo quando disegna il bordo di un pulsante Nascondi automaticamente.
virtual void OnDrawBorder(
CDC* pDC,
CRect rectBounds,
CRect rectBorderSize);
Parametri
pDC
[in] Puntatore a un contesto di dispositivo.
rectBounds
[in] Rettangolo di delimitazione del pulsante nascondi automaticamente.
rectBorderSize
[in] Spessore del bordo per ogni lato del pulsante nascondi automaticamente.
Osservazioni:
Se si vuole personalizzare il bordo di ogni pulsante nascondi automaticamente nell'applicazione, creare una nuova classe derivata da CMFCAutoHideButton. Nella classe derivata eseguire l'override di questo metodo.
CMFCAutoHideButton::OnFillBackground
Il framework chiama questo metodo quando riempie lo sfondo di un pulsante Nascondi automaticamente.
virtual void OnFillBackground(
CDC* pDC,
CRect rect);
Parametri
pDC
[in] Puntatore a un contesto di dispositivo.
rect
[in] Rettangolo di delimitazione del pulsante nascondi automaticamente.
Osservazioni:
Se si vuole personalizzare lo sfondo per i pulsanti nascondi automaticamente nell'applicazione, creare una nuova classe derivata da CMFCAutoHideButton. Nella classe derivata eseguire l'override di questo metodo.
CMFCAutoHideButton::ShowAttachedWindow
Visualizza o nasconde la classe CDockablePane associata.
void ShowAttachedWindow(BOOL bShow);
Parametri
bShow
[in] Valore booleano che specifica se questo metodo mostra l'oggetto associato CDockablePane.
CMFCAutoHideButton::ShowButton
Mostra o nasconde il pulsante Nascondi automaticamente.
virtual void ShowButton(BOOL bShow);
Parametri
bShow
[in] Valore booleano che specifica se visualizzare il pulsante nascondi automaticamente.
CMFCAutoHideButton::Move
void Move(int nOffset);
Parametri
[in] nOffset
Osservazioni:
CMFCAutoHideButton::ReplacePane
void ReplacePane(CDockablePane* pNewBar);
Parametri
[in] pNewBar
Osservazioni:
CMFCAutoHideButton::UnSetAutoHideMode
Disabilita la modalità Nascondi automaticamente.
virtual void UnSetAutoHideMode(CDockablePane* pFirstBarInGroup);
Parametri
pFirstBarInGroup
[in] Puntatore alla prima barra del gruppo.
Osservazioni:
CMFCAutoHideButton::HighlightButton
Evidenzia il pulsante Nascondi automaticamente.
virtual void HighlightButton(BOOL bHighlight);
Parametri
bHighlight
Specifica il nuovo stato del pulsante nascondi automaticamente. TRUE indica che il pulsante è evidenziato, FALSE indica che il pulsante non è evidenziato.
Osservazioni:
CMFCAutoHideButton::IsHighlighted
Restituisce lo stato di evidenziazione del pulsante Nascondi automaticamente.
virtual BOOL IsHighlighted() const;
Valore restituito
Restituisce TRUE se il pulsante nascondi automaticamente è evidenziato; in caso contrario FALSE.
Osservazioni:
Vedi anche
Grafico della gerarchia
Classi
Classe CMFCAutoHideBar
Classe CAutoHideDockSite