Classe CMFCTasksPane

Articolo
06/10/2015

Questo argomento è incluso per motivi di completezza. Per informazioni dettagliate, vedere il codice sorgente disponibile nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.

La classe CMFCTasksPane implementa un elenco di elementi selezionabili (attività).

class CMFCTasksPane : public CDockablePane

Membri

Costruttori pubblici

Nome	Descrizione
CMFCTasksPane::CMFCTasksPane	Costruisce un oggetto CMFCTasksPane.

Metodi pubblici

Nome	Descrizione
CMFCTasksPane::AddGroup	Aggiungere un nuovo gruppo di attività al controllo del riquadro attività.
CMFCTasksPane::AddLabel	Aggiunge una nuova etichetta statica nel gruppo di attività specificato.
CMFCTasksPane::AddMRUFilesList	Aggiunge le attività specificate da un elenco dei file aperti più di recente (MRU) in un gruppo.
CMFCTasksPane::AddPage	Aggiunge una nuova pagina al riquadro attività.
CMFCTasksPane::AddSeparator
CMFCTasksPane::AddTask	Aggiungere una nuova attività al gruppo di attività specificato.
CMFCTasksPane::AddWindow	Aggiunge una finestra figlio al riquadro attività.
CMFCTasksPane::CollapseAllGroups
CMFCTasksPane::CollapseGroup	A livello di codice consente di comprimere un gruppo.
CMFCTasksPane::CreateDefaultMiniframe	(Override CPane::CreateDefaultMiniframe).
CMFCTasksPane::CreateMenu	Chiamato dal framework per creare un menu sul pulsante del menu Riquadri altre attività.
CMFCTasksPane::EnableAnimation	Abilita o disabilita l'animazione come pacchetto o per espandere i gruppi di attività.
CMFCTasksPane::EnableGroupCollapse	Specifica se i gruppi di attività possono essere compresse.
CMFCTasksPane::EnableHistoryMenuButtons	Abilita o disabilita i menu a discesa in Avanti e pulsanti di navigazione Indietro.
CMFCTasksPane::EnableNavigationToolbar	Abilita o disabilita la barra degli strumenti di navigazione.
CMFCTasksPane::EnableOffsetCustomControls
CMFCTasksPane::EnableScrollButtons	Abilita i pulsanti di scorrimento anziché una barra di scorrimento.
CMFCTasksPane::EnableWrapLabels	Abilita o disabilita il wrapping della parola delle etichette.
CMFCTasksPane::EnableWrapTasks	Abilita o disabilita il wrapping delle parole per le attività.
CMFCTasksPane::GetActivePage	Restituisce l'indice in base zero per la pagina attiva.
CMFCTasksPane::GetGroupCaptionHeight	Restituisce l'altezza delle didascalie di gruppo.
CMFCTasksPane::GetGroupCaptionHorzOffset	Restituisce l'offset corrente di una barra del titolo del gruppo dai bordi sinistro e destro del riquadro attività.
CMFCTasksPane::GetGroupCaptionVertOffset	Restituisce l'offset corrente di una barra del titolo del gruppo di distanza dai bordi inferiore del riquadro attività.
CMFCTasksPane::GetGroupCount	Restituisce il numero totale di gruppi.
CMFCTasksPane::GetGroupLocation	Restituisce l'indice di gruppo interno di un gruppo specificato.
CMFCTasksPane::GetGroupVertOffset	Restituisce l'offset verticale di un gruppo.
CMFCTasksPane::GetHorzMargin	Restituisce la spaziatura orizzontale tra un riquadro attività e i bordi dell'area client.
CMFCTasksPane::GetNextPages
CMFCTasksPane::GetPageByGroup	Recupera l'indice della pagina per un gruppo specificato.
CMFCTasksPane::GetPagesCount	Restituisce il numero di pagine.
CMFCTasksPane::GetPreviousPages
CMFCTasksPane::GetScrollBarCtrl	(Override CWnd::GetScrollBarCtrl).
CMFCTasksPane::GetTask	Recupera un'attività.
CMFCTasksPane::GetTaskCount	Restituisce il numero di elementi attività in un gruppo specificato.
CMFCTasksPane::GetTaskGroup	Restituisce un gruppo di attività per un indice di gruppo specificato.
CMFCTasksPane::GetTaskLocation	Restituisce il gruppo e indice per un'attività specifica.
CMFCTasksPane::GetTasksHorzOffset	Restituisce l'offset orizzontale di attività dai bordi sinistro e destro dei gruppi padre.
CMFCTasksPane::GetTasksIconHorzOffset
CMFCTasksPane::GetTasksIconVertOffset
CMFCTasksPane::GetVertMargin	Restituisce la spaziatura verticale tra un riquadro attività e i bordi dell'area client.
CMFCTasksPane::IsAccessibilityCompatible	(Override CDockablePane::IsAccessibilityCompatible).
CMFCTasksPane::IsAnimationEnabled	Indica se l'animazione è abilitata.
CMFCTasksPane::IsBackButtonEnabled	Indica se il pulsante indietro è abilitato.
CMFCTasksPane::IsForwardButtonEnabled	Indica se il pulsante avanti è abilitato.
CMFCTasksPane::IsGroupCollapseEnabled
CMFCTasksPane::IsHistoryMenuButtonsEnabled	Indica se i pulsanti di navigazione Indietro e Avanti hanno menu a discesa.
CMFCTasksPane::IsNavigationToolbarEnabled	Indica se la barra degli strumenti di navigazione è abilitata.
CMFCTasksPane::IsToolBox
CMFCTasksPane::IsWrapLabelsEnabled	Indica se il riquadro attività esegue il wrapping delle parole nelle etichette.
CMFCTasksPane::IsWrapTasksEnabled	Indica se il riquadro attività esegue il wrapping delle parole in attività.
CMFCTasksPane::LoadState	(Override CDockablePane::LoadState).
CMFCTasksPane::OnCancel
CMFCTasksPane::OnClickTask	Chiamato dal framework quando l'utente fa clic su un elemento nel riquadro attività.
CMFCTasksPane::OnOK
CMFCTasksPane::OnPressBackButton	Chiamato dal framework quando l'utente fa clic sul pulsante indietro.
CMFCTasksPane::OnPressForwardButton	Chiamato dal framework quando l'utente fa clic sul pulsante di navigazione in avanti.
CMFCTasksPane::OnPressHomeButton	Chiamato dal framework quando l'utente fa clic sul pulsante di navigazione home
CMFCTasksPane::OnPressOtherButton
CMFCTasksPane::OnSetAccData	(Override CBasePane::OnSetAccData).
CMFCTasksPane::OnUpdateCmdUI	(Override CDockablePane::OnUpdateCmdUI).
CMFCTasksPane::PreTranslateMessage	(Override CDockablePane::PreTranslateMessage).
CMFCTasksPane::RecalcLayout	(Override CPane::RecalcLayout).
CMFCTasksPane::RemoveAllGroups	Rimuove tutti i gruppi nella pagina specificata.
CMFCTasksPane::RemoveAllPages	Rimuove tutte le pagine dal riquadro attività a meno che nella prima pagina predefinita).
CMFCTasksPane::RemoveAllTasks	Rimuove tutte le attività dal gruppo.
CMFCTasksPane::RemoveGroup	Rimuove un gruppo.
CMFCTasksPane::RemovePage	Rimuove una pagina specifica dal riquadro attività.
CMFCTasksPane::RemoveTask	Elimina un'attività da un gruppo di attività.
CMFCTasksPane::SaveState	(Override CDockablePane::SaveState).
CMFCTasksPane::Serialize	(Override CDockablePane::Serialize).
CMFCTasksPane::SetActivePage	Attiva una pagina specificata nel riquadro attività.
CMFCTasksPane::SetCaption	Imposta il nome della didascalia del riquadro attività.
CMFCTasksPane::SetGroupCaptionHeight	L'altezza di una barra del titolo del gruppo.
CMFCTasksPane::SetGroupCaptionHorzOffset	Impostare l'offset orizzontale di una barra del titolo del gruppo.
CMFCTasksPane::SetGroupCaptionVertOffset	Impostare l'offset verticale di una barra del titolo del gruppo.
CMFCTasksPane::SetGroupName	Imposta un nome di gruppo.
CMFCTasksPane::SetGroupTextColor	Imposta il colore del testo per una didascalia del gruppo.
CMFCTasksPane::SetGroupVertOffset	Impostare l'offset verticale per un gruppo.
CMFCTasksPane::SetHorzMargin	Imposta la spaziatura orizzontale tra un riquadro attività e i bordi dell'area client.
CMFCTasksPane::SetIconsList	Imposta l'elenco di immagine associato alle attività.
CMFCTasksPane::SetPageCaption	Imposta il testo della didascalia per una pagina del riquadro attività.
CMFCTasksPane::SetTaskName	Imposta il nome per un'attività.
CMFCTasksPane::SetTasksIconHorzOffset
CMFCTasksPane::SetTasksIconVertOffset
CMFCTasksPane::SetTaskTextColor	Imposta il colore del testo per un'attività.
CMFCTasksPane::SetTasksHorzOffset	Impostare l'offset orizzontale di attività dai bordi sinistro e destro dei gruppi padre.
CMFCTasksPane::SetVertMargin	Imposta la spaziatura verticale tra un riquadro attività e i bordi dell'area client.
CMFCTasksPane::SetWindowHeight	L'altezza di una finestra.
CMFCTasksPane::ShowCommandMessageString
CMFCTasksPane::ShowTask	Mostra o nasconde un'attività.
CMFCTasksPane::ShowTaskByCmdId	Mostra o nasconde un'attività in base all'ID di comando
CMFCTasksPane::Update	Aggiorna gli elementi GUI appartenenti a un riquadro attività.

Metodi protetti

Nome	Descrizione
CMFCTasksPane::OnActivateTasksPanePage	Chiamato dal framework quando una nuova pagina del riquadro attività è attivata.

Note

La classe CMFCTasksPane implementa la funzionalità seguenti:

Gli elementi possono essere raggruppati e ogni raggruppamento di elementi può avere una didascalia collegata.
I raggruppamenti dell'elemento possono essere compresse o espansi.
Un'icona può essere assegnata a ciascun elemento del riquadro attività.
I singoli elementi possono essere associati a un ID di comando che viene eseguita quando un utente fa clic sull'elemento. Quando il clic si verifica, il messaggio WM_COMMAND viene inviato al proprietario del controllo del riquadro attività.

Per utilizzare CMFCTasksPane controlli nell'applicazione, seguire questi passaggi:

Importare un oggetto CMFCTasksPane nella classe della finestra cornice principale.
Nell'elaborare il messaggio WM_CREATE, chiamare il metodo Create. È possibile utilizzare stili normale CControlBar. Per ulteriori informazioni, vedere CControlBar::Create.
Chiamare il metodo CMFCTasksPane::AddGroup per aggiungere vari gruppi.
Chiamare le funzioni membro CMFCTasksPane::AddTask, CMFCTasksPane::AddLabel o CMFCTasksPane::AddMRUFilesList per aggiungere nuovi elementi (attività) a ogni gruppo.
Chiamare CMFCTasksPane::EnableGroupCollapse per specificare se i gruppi di elementi è compresso.

Nella figura seguente viene illustrato un tipico controllo del riquadro attività. Il primo gruppo è un gruppo speciale e la barra del titolo è un colore più scuro. Il terzo gruppo è compresso. L'ultimo gruppo viene allineato al bordo inferiore del riquadro attività e non ha barra del titolo e l'ultima attività nel gruppo è un'etichetta semplice:

Esempio di riquadro attività

È possibile personalizzare l'aspetto del riquadro attività regolando i vari margini e offset. La figura seguente illustra l'importanza di queste variabili:

Gruppo di attività personalizzato

Esempio

Nell'esempio seguente viene illustrato come costruire un oggetto CMFCTasksPane e utilizzare i vari metodi in CMFCTasksPane classe. L'esempio mostra come abilitare comprimere i gruppi di attività, abilitare i menu a discesa sui pulsanti di navigazione Indietro e Avanti, abilitare i pulsanti di scorrimento anziché una barra di scorrimento, abilitare il wrapping della parola del testo nelle etichette, impostare il nome della barra del titolo del riquadro attività, impostare il colore del testo per una didascalia del gruppo e impostare i margini orizzontali e verticali.

 CMFCTasksPane* tPane = new CMFCTasksPane();
    tPane->EnableGroupCollapse(true);
    tPane->EnableHistoryMenuButtons(true);
    tPane->EnableScrollButtons(true);
    tPane->EnableWrapLabels(true);
    tPane->SetCaption(_T("Task Pane"));
    tPane->SetGroupTextColor(0,RGB(0,0,128));
    tPane->SetHorzMargin(15);
    tPane->SetVertMargin(15);
    tPane->Update();