Classe CMFCTasksPane

Articolo
08/04/2024

Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.

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

Sintassi

class CMFCTasksPane : public CDockablePane

Membri

Costruttori pubblici

Nome	Descrizione
CMFCTasksPane::CMFCTasksPane	Costruisce un oggetto `CMFCTasksPane`.

Metodi pubblici

Nome	Descrizione
CMFCTasksPane::AddGroup	Aggiunge 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	Aggiunge una nuova attività al gruppo di attività specificato.
CMFCTasksPane::AddWindow	Aggiunge una finestra figlio al riquadro attività.
CMFCTasksPane::CollapseAllGroups
CMFCTasksPane::CollapseGroup	Comprime un gruppo a livello di codice.
CMFCTasksPane::CreateDefaultMiniframe	(sostituzioni )CPane::CreateDefaultMiniframe.
CMFCTasksPane::CreateMenu	Chiamato dal framework per creare un menu per il pulsante di menu Altri riquadri 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 compressi.
CMFCTasksPane::EnableHistoryMenuButtons	Abilita o disabilita i menu a discesa nei pulsanti di spostamento Avanti e 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 l'a capo automatico per le etichette.
CMFCTasksPane::EnableWrapTasks	Abilita o disabilita l'a capo automatico 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 didascalia del gruppo dai bordi sinistro e destro del riquadro attività.
CMFCTasksPane::GetGroupCaptionVertOffset	Restituisce l'offset corrente di una didascalia 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	(sostituzioni )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	Esegue l'override di `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 spostamento Avanti e Precedente dispongono di menu a discesa.
CMFCTasksPane::IsNavigationToolbarEnabled	Indica se la barra degli strumenti di navigazione è abilitata.
CMFCTasksPane::IsToolBox
CMFCTasksPane::IsWrapLabelsEnabled	Indica se il riquadro attività esegue l'a capo automatico nelle etichette.
CMFCTasksPane::IsWrapTasksEnabled	Indica se il riquadro attività esegue l'a capo automatico nelle attività.
CMFCTasksPane::LoadState	(sostituzioni )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 Avanti.
CMFCTasksPane::OnPressHomeButton	Chiamato dal framework quando l'utente fa clic sul pulsante di navigazione home.
CMFCTasksPane::OnPressOtherButton
CMFCTasksPane::OnSetAccData	(sostituzioni )CBasePane::OnSetAccData.
CMFCTasksPane::OnUpdateCmdUI	(sostituzioni )CDockablePane::OnUpdateCmdUI.
CMFCTasksPane::P reTranslateMessage	(sostituzioni )CDockablePane::P reTranslateMessage.
CMFCTasksPane::RecalcLayout	(sostituzioni )CPane::RecalcLayout.
CMFCTasksPane::RemoveAllGroups	Rimuove tutti i gruppi nella pagina specificata.
CMFCTasksPane::RemoveAllPages	Rimuove tutte le pagine dal riquadro attività tranne 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	Rimuove un'attività da un gruppo di attività.
CMFCTasksPane::SaveState	(sostituzioni )CDockablePane::SaveState.
CMFCTasksPane::Serialize	(sostituzioni )CDockablePane::Serialize.
CMFCTasksPane::SetActivePage	Attiva una pagina specificata nel riquadro attività.
CMFCTasksPane::SetCaption	Imposta il nome della didascalia del riquadro attività.
CMFCTasksPane::SetGroupCaptionHeight	Imposta l'altezza di una didascalia del gruppo.
CMFCTasksPane::SetGroupCaptionHorzOffset	Impostare l'offset orizzontale di una didascalia del gruppo.
CMFCTasksPane::SetGroupCaptionVertOffset	Imposta l'offset verticale di didascalia del gruppo.
CMFCTasksPane::SetGroupName	Imposta un nome di gruppo.
CMFCTasksPane::SetGroupTextColor	Imposta il colore del testo per una didascalia del gruppo.
CMFCTasksPane::SetGroupVertOffset	Imposta 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	Imposta 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	Imposta 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.

Osservazioni:

La classe CMFCTasksPane implementa la funzionalità seguenti:

Gli elementi possono essere raggruppati e ogni raggruppamento di elementi può avere una didascalia collegata.
I raggruppamenti di elementi possono essere compressi 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 eseguito quando un utente fa clic sull'elemento. Quando si verifica il clic, il messaggio di WM_COMMAND viene inviato al proprietario del controllo del riquadro attività.

Per usare i controlli CMFCTasksPane nell'applicazione, attenersi alla procedura seguente:

Importare un oggetto CMFCTasksPane nella classe della finestra cornice principale.
Quando si elabora il messaggio WM_CREATE, chiamare il Create metodo . È possibile usare gli stili CControlBar normali. 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 possono comprimere.

Nella figura seguente viene illustrato un tipico controllo del riquadro attività. Il primo gruppo è un gruppo speciale e la relativa didascalia è un colore più scuro. Il terzo gruppo è compresso. L'ultimo gruppo viene allineato al bordo inferiore del riquadro attività e non ha didascalia 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

L'esempio seguente illustra come costruire un oggetto CMFCTasksPane e usare i vari metodi nella classe CMFCTasksPane. Nell'esempio viene illustrato come abilitare la compressione dei gruppi di attività, abilitare i menu a discesa nei pulsanti di spostamento Avanti e Indietro, abilitare i pulsanti di scorrimento anziché una barra di scorrimento, abilitare il ritorno a capo automatico per il testo nelle etichette, impostare il nome della didascalia del riquadro attività, impostare il colore del testo per una didascalia di gruppo, e imposta 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();

Gerarchia di ereditarietà

CObject
└ CCmdTarget
└ CWnd
└ CBasePane
└ CPane
└ CDockablePane
└ CMFCTasksPane

Requisiti

Intestazione: afxTasksPane.h

CMFCTasksPane::AddGroup

Aggiunge un nuovo gruppo di attività al controllo del riquadro attività.

int AddGroup(
    int nPageIdx,
    LPCTSTR lpszGroupName,
    BOOL bBottomLocation = FALSE,
    BOOL bSpecial = FALSE,
    HICON hIcon = NULL);

int AddGroup(
    LPCTSTR lpszGroupName,
    BOOL bBottomLocation = FALSE,
    BOOL bSpecial = FALSE,
    HICON hIcon = NULL);

Parametri

nPageIdx
[in] Specifica l'indice di pagina in base zero.

lpszGroupName
[in] Specifica il nome del gruppo.

bBottomLocation
[in] TRUE per creare il gruppo nella parte inferiore del controllo del riquadro attività; in caso contrario, FALSE.

bSpecial
[in] TRUE per contrassegnare questo gruppo come gruppo speciale ; in caso contrario, FALSE. Per altre informazioni sui gruppi speciali, vedere la sezione Osservazioni di CMFCTasksPane.

hIcon
[in] Specifica l'icona da visualizzare nella didascalia del gruppo.

Valore restituito

Indice in base zero del gruppo nell'elenco interno di gruppi gestito dalla classe .

Osservazioni:

Chiamare questo metodo per creare un gruppo di attività e aggiungere tale gruppo al controllo del riquadro attività.

Il framework visualizza i gruppi di attività nella parte superiore del controllo del riquadro attività o nella parte inferiore. Il framework può visualizzare un solo gruppo nella parte inferiore; questo gruppo deve essere aggiunto per ultimo.

CMFCTasksPane::AddLabel

Aggiunge un'etichetta al gruppo di attività specificato.

int AddLabel(
    int nGroup,
    LPCTSTR lpszLabelName,
    int nTaskIcon = -1,
    BOOL bIsBold = FALSE);

Parametri

nGroup
[in] Specifica l'indice del gruppo in cui viene aggiunta l'etichetta.

lpszLabelName
[in] Specifica il nome dell'etichetta.

nTaskIcon
[in] Specifica l'icona da visualizzare accanto all'etichetta. Il framework archivia le icone in un elenco di immagini. Questo parametro è un indice nell'elenco.

bIsBold
[in] TRUE per visualizzare l'etichetta in grassetto; in caso contrario, FALSE.

Valore restituito

Indice in base zero del gruppo in cui è stata aggiunta l'etichetta oppure -1 se il gruppo specificato da nGroup non esiste.

Osservazioni:

Il framework gestisce le attività e le etichette in modo diverso. Quando un utente fa clic su un'attività, il framework esegue un comando. Quando un utente fa clic su un'etichetta, non viene eseguito alcun comando. Per altre informazioni, vedere CMFCTasksPane::AddTask.

CMFCTasksPane::AddMRUFilesList

Aggiunge un'attività per ogni file archiviato in un elenco di file usati più di recente (MRU) in un gruppo.

int AddMRUFilesList(
    int nGroup,
    int nMaxFiles = 4);

Parametri

nGroup
[in] Specifica l'indice di un gruppo. Questo metodo aggiunge l'elenco dei file MRU al gruppo specificato da questo parametro.

nMaxFiles
[in] Specifica il numero di file da visualizzare nell'elenco dei file MRU.

Valore restituito

Indice in base zero del gruppo in cui è stato aggiunto l'elenco dei file MRU oppure -1 se il gruppo specificato da nGroup non esiste.

CMFCTasksPane::AddPage

Aggiunge una pagina al riquadro attività.

int AddPage(LPCTSTR lpszPageLabel);

Parametri

lpszPageLabel
[in] Specifica l'etichetta per la pagina.

Valore restituito

Indice in base zero della nuova pagina.

CMFCTasksPane::AddSeparator

int AddSeparator(int nGroup);

Parametri

[in] nGroup

Valore restituito

Osservazioni:

CMFCTasksPane::AddTask

Aggiunge un'attività al gruppo di attività specificato.

int AddTask(
    int nGroup,
    LPCTSTR lpszTaskName,
    int nTaskIcon = -1,
    UINT uiCommandID = 0,
    DWORD dwUserData = 0);

Parametri

nGroup
[in] Specifica l'indice di gruppo in cui viene aggiunta l'attività.

lpszTaskName
[in] Specifica il nome dell'attività.

nTaskIcon
[in] Specifica l'icona da visualizzare accanto all'attività. Il framework archivia le icone in un elenco di immagini. Questo parametro è un indice nell'elenco.

uiCommandID
[in] Specifica l'ID comando del comando da eseguire quando l'utente fa clic sull'attività. L'attività viene considerata come un'etichetta se uiCommandID è 0.

dwUserData
[in] Specifica i dati definiti dall'utente da associare all'attività.

Valore restituito

Indice in base zero del gruppo in cui è stata aggiunta l'attività oppure -1 se il gruppo specificato da nGroup non esiste.

CMFCTasksPane::AddWindow

Aggiunge una finestra figlio al riquadro attività.

int AddWindow(
    int nGroup,
    HWND hwndTask,
    int nWndHeight,
    BOOL bAutoDestroyWindow = FALSE,
    DWORD dwUserData = 0);

Parametri

nGroup
[in] Specifica l'indice del gruppo in cui viene aggiunta la finestra.

hwndTask
[in] Specifica l'handle della finestra da aggiungere.

nWndHeight
[in] Specifica l'altezza della finestra.

bAutoDestroyWindow
[in] TRUE per eliminare definitivamente la finestra quando l'attività viene rimossa; in caso contrario, FALSE.

dwUserData
[in] Specifica i dati definiti dall'utente associati all'attività.

Valore restituito

Indice in base zero del gruppo in cui è stata aggiunta la finestra oppure -1 se il gruppo specificato da nGroup non esiste.

Osservazioni:

Chiamare questo metodo per aggiungere un controllo a un riquadro attività. Ad esempio, è possibile aggiungere un controllo di modifica che funzioni come una barra di ricerca.

CMFCTasksPane::CMFCTasksPane

Costruisce un oggetto CMFCTasksPane .

CMFCTasksPane();

CMFCTasksPane::CollapseAllGroups

void CollapseAllGroups(BOOL bCollapse = TRUE);

void CollapseAllGroups(
    int nPageIdx,
    BOOL bCollapse);

Parametri

[in] bCollapse
[in] nPageIdx

Osservazioni:

CMFCTasksPane::CollapseGroup

Comprime o espande un gruppo.

BOOL CollapseGroup(
    CMFCTasksPaneTaskGroup* pGroup,
    BOOL bCollapse = TRUE);

BOOL CollapseGroup(
    int nGroup,
    BOOL bCollapse = TRUE);

Parametri

pGroup
[in] Specifica il gruppo da comprimere.

bCollapse
[in] TRUE per comprimere il gruppo; FALSE per espandere il gruppo.

nGroup
[in] Specifica l'indice in base zero del gruppo da comprimere nell'elenco interno di gruppi.

Valore restituito

TRUE se il gruppo si comprime o si espande correttamente; in caso contrario, FALSE.

Osservazioni:

Un gruppo compresso mostra solo la didascalia del gruppo; l'elenco delle attività è nascosto.

CMFCTasksPane::CreateDefaultMiniframe

virtual CPaneFrameWnd* CreateDefaultMiniframe(CRect rectInitial);

Parametri

[in] rectInitial

Valore restituito

Osservazioni:

CMFCTasksPane::CreateMenu

Crea un menu visualizzato quando un utente fa clic sul pulsante di menu Altri riquadri attività.

HMENU CreateMenu() const;

Valore restituito

Handle per il nuovo menu.

Osservazioni:

Eseguire l'override di questo metodo in una classe derivata per personalizzare il menu per un riquadro attività.

Il menu a comparsa creato da questo metodo contiene l'elenco di pagine nel riquadro attività. Il menu visualizza un segno di spunta accanto alla pagina attiva.

CMFCTasksPane::EnableAnimation

Abilita o disabilita l'animazione che si verifica quando un gruppo di attività si espande o comprime.

void EnableAnimation(BOOL bEnable = TRUE);

Parametri

bEnable
[in] TRUE per abilitare l'animazione che si verifica quando un gruppo di attività si espande o comprime; in caso contrario, FALSE.

Osservazioni:

Per impostazione predefinita, l'animazione che si verifica quando un gruppo di attività si espande o comprime è abilitato.

CMFCTasksPane::EnableGroupCollapse

Specifica se un utente può comprimere i gruppi di attività.

void EnableGroupCollapse(BOOL bEnable);

Parametri

bEnable
[in] TRUE se gli utenti possono comprimere i gruppi di attività; in caso contrario, FALSE.

Osservazioni:

Un gruppo di attività compresso visualizza solo la didascalia del gruppo; l'elenco delle attività è nascosto.

CMFCTasksPane::EnableHistoryMenuButtons

Abilita i menu a discesa nei pulsanti di spostamento Avanti e Indietro .

void EnableHistoryMenuButtons(BOOL bEnable = TRUE);

Parametri

bEnable
[in] TRUE per abilitare i menu a discesa nei pulsanti di spostamento Avanti e Indietro ; in caso contrario, FALSE.

Osservazioni:

Per impostazione predefinita, i menu a discesa nei pulsanti Avanti e Indietro sono disabilitati.

I menu contengono la cronologia delle pagine delle attività usate dall'utente.

CMFCTasksPane::EnableNavigationToolbar

Abilita o disabilita la barra degli strumenti di navigazione.

void EnableNavigationToolbar(
    BOOL bEnable = TRUE,
    UINT uiToolbarBmpRes = 0,
    CSize sizeToolbarImage = CSize(0,
    0),
    CSize sizeToolbarButton = CSize(0,
    0));

Parametri

bEnable
[in] TRUE per abilitare la barra degli strumenti di spostamento; in caso contrario, FALSE.

uiToolbarBmpRes
[in] Specifica l'ID risorsa della bitmap che contiene le immagini da visualizzare sulla barra degli strumenti.

sizeToolbarImage
[in] Specifica le dimensioni di un'immagine della barra degli strumenti.

sizeToolbarButton
[in] Specifica le dimensioni di un pulsante della barra degli strumenti.

Osservazioni:

La barra degli strumenti di spostamento è una barra degli strumenti visualizzata dal framework nella parte superiore del riquadro attività. La barra degli strumenti di spostamento contiene i pulsanti di spostamento Indietro, Avanti e Home e un pulsante di menu che contiene l'elenco delle pagine disponibili.

Per impostazione predefinita, il framework non visualizza la barra degli strumenti di spostamento. Se la barra degli strumenti di spostamento non viene visualizzata, i pulsanti di spostamento si trovano nella didascalia della barra di ancoraggio.

CMFCTasksPane::EnableOffsetCustomControls

void EnableOffsetCustomControls(BOOL bEnable);

Parametri

[in] bEnable

Osservazioni:

CMFCTasksPane::EnableScrollButtons

Abilita i pulsanti di scorrimento anziché una barra di scorrimento.

void EnableScrollButtons(BOOL bEnable = TRUE);

Parametri

bEnable
[in] TRUE per visualizzare i pulsanti di scorrimento nel riquadro attività anziché una barra di scorrimento; in caso contrario, FALSE.

Osservazioni:

Per impostazione predefinita, il framework visualizza i pulsanti di scorrimento nel riquadro attività.

CMFCTasksPane::EnableWrapLabels

Abilita o disabilita il ritorno a capo automatico per il testo nelle etichette.

void EnableWrapLabels(BOOL bEnable = TRUE);

Parametri

bEnable
[in] TRUE per eseguire il wrapping del testo nelle etichette visualizzate nel riquadro attività; in caso contrario, FALSE.

Osservazioni:

Per impostazione predefinita, il framework non esegue il wrapping del testo nelle etichette. Quando il ritorno a capo automatico è abilitato, il testo nelle etichette può essere visualizzato in più righe. L'etichetta può includere indicatori di interruzione della riga, ad \n esempio e l'indicatore di sottolineatura &.

CMFCTasksPane::EnableWrapTasks

Abilita o disabilita il ritorno a capo automatico per il testo nelle attività.

void EnableWrapTasks(BOOL bEnable = TRUE);

Parametri

bEnable
[in] TRUE per eseguire il wrapping delle attività nel riquadro attività; in caso contrario, FALSE.

Osservazioni:

Per impostazione predefinita, il ritorno a capo automatico per le attività è disabilitato.

CMFCTasksPane::GetActivePage

Restituisce l'indice in base zero per la pagina attiva.

int GetActivePage() const;

Valore restituito

Indice in base zero della pagina attiva.

CMFCTasksPane::GetGroupCaptionHeight

Restituisce l'altezza della didascalia del gruppo.

int GetGroupCaptionHeight() const;

Valore restituito

Altezza della didascalia del gruppo, in pixel.

CMFCTasksPane::GetGroupCaptionHorzOffset

Restituisce l'offset orizzontale di una didascalia di gruppo.

int GetGroupCaptionHorzOffset() const;

Valore restituito

Offset orizzontale di una didascalia di gruppo. L'offset orizzontale è la distanza in pixel dal bordo sinistro o destro del riquadro attività.

CMFCTasksPane::GetGroupCaptionVertOffset

Restituisce l'offset verticale di una didascalia di gruppo.

int GetGroupCaptionVertOffset() const;

Valore restituito

Offset verticale di una didascalia di gruppo dai bordi superiore e inferiore del riquadro attività.

Osservazioni:

Il valore predefinito per l'offset verticale è di 7 pixel.

CMFCTasksPane::GetGroupCount

Restituisce il numero totale di gruppi.

int GetGroupCount() const;

Valore restituito

Numero totale di gruppi nel riquadro attività.

CMFCTasksPane::GetGroupLocation

Restituisce l'indice del gruppo interno per il gruppo specificato.

BOOL GetGroupLocation(
    CMFCTasksPaneTaskGroup* pGroup,
    int& nGroup) const;

Parametri

pGroup
[in] Specifica il gruppo di attività il cui percorso viene recuperato.

nGroup
[out] Contiene l'indice in base zero del gruppo di attività.

Valore restituito

TRUE se il gruppo di attività è stato trovato; in caso contrario, FALSE.

CMFCTasksPane::GetGroupVertOffset

Restituisce l'offset verticale di un gruppo.

int GetGroupVertOffset() const;

Valore restituito

Offset verticale di un gruppo, in pixel.

CMFCTasksPane::GetHorzMargin

Restituisce la spaziatura orizzontale tra un riquadro attività e il bordo dell'area client.

int GetHorzMargin() const;

Valore restituito

Spaziatura orizzontale tra un riquadro attività e il bordo dell'area client.

Osservazioni:

La spaziatura predefinita tra un riquadro attività e il bordo dell'area client è di 12 pixel.

CMFCTasksPane::GetNextPages

void GetNextPages(CStringList& lstNextPages) const;

Parametri

[in] lstNextPages

Osservazioni:

CMFCTasksPane::GetPageByGroup

Recupera l'indice della pagina per un gruppo specificato.

BOOL GetPageByGroup(
    int nGroup,
    int& nPage) const;

Parametri

nGroup
[in] Specifica l'indice in base zero del gruppo di attività.

nPage
[out] Contiene l'indice di pagina per il gruppo specificato. Se il gruppo di attività contiene solo una pagina predefinita, il valore restituito è 0.

Valore restituito

TRUE se il gruppo nGroup esiste; in caso contrario, FALSE.

CMFCTasksPane::GetPagesCount

Restituisce il numero di pagine.

int GetPagesCount() const;

Valore restituito

Numero di pagine nel riquadro attività.

CMFCTasksPane::GetPreviousPages

void GetPreviousPages(CStringList& lstPrevPages) const;

Parametri

[in] lstPrevPages

Osservazioni:

CMFCTasksPane::GetScrollBarCtrl

virtual CScrollBar* GetScrollBarCtrl(int nBar) const;

Parametri

[in] nBar

Valore restituito

Osservazioni:

CMFCTasksPane::GetTask

Recupera un'attività.

CMFCTasksPaneTask* GetTask(
    int nGroup,
    int nTask) const;

Parametri

nGroup
[in] Specifica l'indice in base zero del gruppo che contiene l'attività.

nTask
[in] Specifica l'indice in base zero dell'attività nell'elenco specificato da nGroup.

Valore restituito

Attività in corrispondenza dell'indice specificato.

CMFCTasksPane::GetTaskCount

Restituisce il numero di attività in un gruppo specificato.

int GetTaskCount(int nGroup) const;

Parametri

nGroup
[in] Specifica l'indice del gruppo di attività.

Valore restituito

Numero di attività nel gruppo specificato o 0 se nGroup non è valido.

CMFCTasksPane::GetTaskGroup

Restituisce un gruppo di attività per un indice di gruppo specificato.

CMFCTasksPaneTaskGroup* GetTaskGroup(int nGroup) const;

Parametri

nGroup
[in] Specifica l'indice in base zero del gruppo da recuperare.

Valore restituito

Gruppo di attività in corrispondenza dell'indice specificato.

CMFCTasksPane::GetTaskLocation

Restituisce il gruppo e l'indice per un'attività specificata.

BOOL GetTaskLocation(
    UINT uiCommandID,
    int& nGroup,
    int& nTask) const;

BOOL GetTaskLocation(
    HWND hwndTask,
    int& nGroup,
    int& nTask) const;

BOOL GetTaskLocation(
    CMFCTasksPaneTask* pTask,
    int& nGroup,
    int& nTask) const;

Parametri

uiCommandID
[in] Specifica l'ID comando dell'attività da trovare.

nGroup
[out] Contiene l'indice di gruppo dell'attività.

nTask
[out] Contiene l'indice dell'attività nel gruppo di attività.

hwndTask
[in] Specifica la finestra associata all'attività.

pTask
[in] Specifica l'attività da trovare.

Valore restituito

TRUE se la posizione dell'attività è stata trovata; FALSE se l'attività specificata non esiste.

Osservazioni:

Questo metodo recupera l'indice del gruppo e l'indice delle attività per l'attività specificata. Se il metodo restituisce FALSE, nGroup e nTask sono impostati su -1.

CMFCTasksPane::GetTasksHorzOffset

Restituisce l'offset orizzontale delle attività.

int GetTasksHorzOffset() const;

Valore restituito

Offset orizzontale delle attività dai bordi sinistro e destro dei gruppi padre.

Osservazioni:

L'offset orizzontale predefinito delle attività è 12 pixel.

CMFCTasksPane::GetTasksIconHorzOffset

int GetTasksIconHorzOffset() const;

Valore restituito

Osservazioni:

CMFCTasksPane::GetTasksIconVertOffset

int GetTasksIconVertOffset() const;

Valore restituito

Osservazioni:

CMFCTasksPane::GetVertMargin

Restituisce il margine verticale tra un riquadro attività e i bordi dell'area client.

int GetVertMargin() const;

Valore restituito

Margine verticale tra un riquadro attività e i bordi dell'area client.

Osservazioni:

Il margine verticale è lo spazio tra un riquadro attività e i bordi dell'area client. Il valore predefinito del margine verticale è 12 pixel.

CMFCTasksPane::IsAccessibilityCompatible

virtual BOOL IsAccessibilityCompatible();

Valore restituito

Osservazioni:

CMFCTasksPane::IsAnimationEnabled

Indica se l'animazione è abilitata.

BOOL IsAnimationEnabled() const;

Valore restituito

TRUE se l'animazione che si verifica quando un utente espande o comprime un gruppo è abilitato; in caso contrario, FALSE.

Osservazioni:

Chiama CMFCTasksPane::EnableAnimation per abilitare o disabilitare l'animazione.

CMFCTasksPane::IsBackButtonEnabled

Indica se il pulsante Indietro è abilitato.

BOOL IsBackButtonEnabled() const;

Valore restituito

TRUE se il pulsante Indietro è abilitato; in caso contrario, FALSE.

Osservazioni:

Quando un utente fa clic sul pulsante Indietro, il framework visualizza la pagina attività precedente.

CMFCTasksPane::IsForwardButtonEnabled

Indica se il pulsante Avanti è abilitato.

BOOL IsForwardButtonEnabled() const;

Valore restituito

TRUE se il pulsante di inoltro è abilitato; in caso contrario, FALSE.

Osservazioni:

Il pulsante avanti abilita lo spostamento avanti nella cronologia delle pagine delle attività.

CMFCTasksPane::IsGroupCollapseEnabled

BOOL IsGroupCollapseEnabled() const;

Valore restituito

Osservazioni:

CMFCTasksPane::IsHistoryMenuButtonsEnabled

Indica se i pulsanti di spostamento Avanti e Precedente dispongono di menu a discesa.

BOOL IsHistoryMenuButtonsEnabled() const;

Valore restituito

TRUE se i pulsanti di spostamento Avanti e Precedente dispongono di menu a discesa; in caso contrario, FALSE.

CMFCTasksPane::IsNavigationToolbarEnabled

Indica se la barra degli strumenti di navigazione è abilitata.

BOOL IsNavigationToolbarEnabled() const;

Valore restituito

TRUE se la barra degli strumenti di spostamento è abilitata; in caso contrario, FALSE.

CMFCTasksPane::IsToolBox

virtual BOOL IsToolBox() const;

Valore restituito

Osservazioni:

CMFCTasksPane::IsWrapLabelsEnabled

Indica se il riquadro attività esegue l'a capo automatico nelle etichette.

BOOL IsWrapLabelsEnabled() const;

Valore restituito

TRUE se le parole nelle etichette vengono racchiuse; in caso contrario, FALSE.

CMFCTasksPane::IsWrapTasksEnabled

Specifica se il framework esegue il wrapping della stringa di attività.

BOOL IsWrapTasksEnabled() const;

Valore restituito

TRUE se la stringa di attività è sottoposta a wrapping; in caso contrario, FALSE.

CMFCTasksPane::LoadState

virtual BOOL LoadState(
    LPCTSTR lpszProfileName = NULL,
    int nIndex = -1,
    UINT uiID = (UINT) -1);

Parametri

[in] lpszProfileName
[in] nIndex
[in] uiID

Valore restituito

Osservazioni:

CMFCTasksPane::OnActivateTasksPanePage

Chiamato dal framework quando rende attiva una pagina del riquadro attività.

virtual void OnActivateTasksPanePage();

Osservazioni:

Eseguire l'override di questo metodo in una classe derivata per personalizzare l'aspetto della pagina del riquadro attività.

CMFCTasksPane::OnCancel

virtual void OnCancel();

Osservazioni:

CMFCTasksPane::OnClickTask

Chiamato dal framework quando l'utente fa clic su un elemento nel riquadro attività.

virtual void OnClickTask(
    int nGroupNumber,
    int nTaskNumber,
    UINT uiCommandID,
    DWORD dwUserData);

Parametri

nGroupNumber
[in] Specifica l'indice in base zero del gruppo che contiene l'attività selezionata.

nTaskNumber
[in] Specifica l'indice in base zero dell'attività selezionata.

uiCommandID
[in] Specifica l'ID comando associato all'attività.

dwUserData
[in] Contiene dati definiti dall'utente associati all'attività selezionata.

Osservazioni:

Il framework chiama questo metodo quando un utente fa clic su un'attività. Per impostazione predefinita, il framework controlla l'ID comando associato all'attività selezionata e, se non è zero, invia il messaggio di WM_COMMAND al proprietario del controllo riquadro attività.

Eseguire l'override di questo metodo in una classe derivata per eseguire codice personalizzato quando si fa clic su un'attività.

CMFCTasksPane::OnOK

virtual void OnOK();

Osservazioni:

CMFCTasksPane::OnPressBackButton

Chiamato dal framework quando l'utente fa clic sul pulsante Indietro.

virtual void OnPressBackButton();

Osservazioni:

Per impostazione predefinita, il framework visualizza la pagina visualizzata in precedenza.

Eseguire l'override di questo metodo in una classe derivata per eseguire codice personalizzato quando l'utente fa clic sul pulsante Indietro.

CMFCTasksPane::OnPressForwardButton

Chiamato dal framework quando l'utente fa clic sul pulsante di navigazione Avanti.

virtual void OnPressForwardButton();

Osservazioni:

Per impostazione predefinita, il framework visualizza la pagina visualizzata dall'utente prima di fare clic sul pulsante Indietro .

Eseguire l'override di questo metodo in una classe derivata per eseguire codice personalizzato quando l'utente fa clic sul pulsante di inoltro.

CMFCTasksPane::OnPressHomeButton

Chiamato dal framework quando l'utente fa clic sul pulsante di spostamento principale.

virtual void OnPressHomeButton();

Osservazioni:

Per impostazione predefinita, il framework visualizza la pagina predefinita per il gruppo di attività.

Eseguire l'override di questo metodo in una classe derivata per eseguire codice personalizzato quando l'utente fa clic sul pulsante di spostamento principale.

CMFCTasksPane::OnPressOtherButton

virtual void OnPressOtherButton(
    CMFCCaptionMenuButton* pbtn,
    CWnd* pWndOwner);

Parametri

[in] pbtn
[in] pWndOwner

Osservazioni:

CMFCTasksPane::OnSetAccData

virtual BOOL OnSetAccData(long lVal);

Parametri

[in] lVal

Valore restituito

Osservazioni:

CMFCTasksPane::OnUpdateCmdUI

virtual void OnUpdateCmdUI(
    CFrameWnd* pTarget,
    BOOL bDisableIfNoHndler);

Parametri

[in] pTarget
[in] bDisableIfNoHndler

Osservazioni:

CMFCTasksPane::P reTranslateMessage

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parametri

[in] pMsg

Valore restituito

Osservazioni:

CMFCTasksPane::RecalcLayout

void RecalcLayout(BOOL bRedraw = TRUE);

Parametri

[in] bRedraw

Osservazioni:

CMFCTasksPane::RemoveAllGroups

Rimuove tutti i gruppi nella pagina specificata.

void RemoveAllGroups(int nPageIdx = 0);

Parametri

nPageIdx
[in] Specifica l'indice in base zero della pagina.

Osservazioni:

Rimuove tutti i gruppi nella pagina specificata da nPageIdx o tutti i gruppi se è presente solo una pagina predefinita.

CMFCTasksPane::RemoveAllPages

Rimuove tutte le pagine dal riquadro attività tranne che nella (prima) pagina predefinita.

void RemoveAllPages();

CMFCTasksPane::RemoveAllTasks

Rimuove tutte le attività dal gruppo specificato.

void RemoveAllTasks(int nGroup);

Parametri

nGroup
[in] Specifica l'indice in base zero del gruppo.

CMFCTasksPane::RemoveGroup

Rimuove un gruppo.

void RemoveGroup(int nGroup);

Parametri

nGroup
[in] Specifica l'indice in base zero del gruppo da rimuovere.

Osservazioni:

Questo metodo rimuove un singolo gruppo. Per rimuovere tutti i gruppi, chiamare invece CMFCTasksPane::RemoveAllGroups .

Quando il framework rimuove un gruppo, tutte le attività e le finestre utente associate vengono eliminate definitivamente.

CMFCTasksPane::RemovePage

Rimuove una pagina specifica dal riquadro attività.

void RemovePage(int nPageIdx);

Parametri

nPageIdx
[in] Specifica l'indice in base zero della pagina da rimuovere.

CMFCTasksPane::RemoveTask

Rimuove un'attività da un gruppo di attività.

BOOL RemoveTask(
    int nGroup,
    int nTask,
    BOOL bRedraw = TRUE);

Parametri

nGroup
[in] Specifica l'indice in base zero del gruppo di attività che contiene l'attività da rimuovere.

nTask
[in] Specifica l'indice in base zero dell'attività da rimuovere.

bRedraw
[in] TRUE per ridisegnare il riquadro attività; in caso contrario, FALSE.

Valore restituito

TRUE se la funzione ha esito positivo; FALSE se nGroup o nTask non è valido.

CMFCTasksPane::SaveState

virtual BOOL SaveState(
    LPCTSTR lpszProfileName = NULL,
    int nIndex = -1,
    UINT uiID = (UINT) -1);

Parametri

[in] lpszProfileName
[in] nIndex
[in] uiID

Valore restituito

Osservazioni:

CMFCTasksPane::Serialize

virtual void Serialize(CArchive& ar);

Parametri

[in] ar

Osservazioni:

CMFCTasksPane::SetActivePage

Rende attiva la pagina specificata nel riquadro attività.

void SetActivePage(int nPageIdx);

Parametri

nPageIdx
[in] Specifica l'indice in base zero della pagina da visualizzare.

Osservazioni:

Questo metodo asserisce se nPageIdx non è valido.

CMFCTasksPane::SetCaption

Imposta il nome della didascalia del riquadro attività.

void SetCaption(LPCTSTR lpszName);

Parametri

lpszName
[in] Specifica il nome della didascalia.

Osservazioni:

Se un riquadro attività ha più pagine, la pagina predefinita include la didascalia impostata usando questa funzione.

CMFCTasksPane::SetGroupCaptionHeight

Imposta l'altezza di una didascalia del gruppo.

void SetGroupCaptionHeight(int n = -1);

Parametri

n
[in] Specifica l'altezza della didascalia.

Osservazioni:

Chiamare questo metodo per personalizzare i margini degli elementi del riquadro attività.

Se n è -1, il framework determina il valore del margine usando visual manager ( CMFCVisualManager::GetTasksPaneGroupCaptionHeight). L'altezza predefinita della didascalia è di 25 pixel.

CMFCTasksPane::SetGroupCaptionHorzOffset

Impostare l'offset orizzontale di una didascalia del gruppo.

void SetGroupCaptionHorzOffset(int n = -1);

Parametri

n
[in] Specifica l'offset orizzontale della didascalia del gruppo.

CMFCTasksPane::SetGroupCaptionVertOffset

Imposta l'offset verticale di didascalia del gruppo.

void SetGroupCaptionVertOffset(int n = -1);

Parametri

n
[in] Specifica l'offset verticale, in pixel, della didascalia del gruppo.

CMFCTasksPane::SetGroupName

Imposta un nome di gruppo.

BOOL SetGroupName(
    int nGroup,
    LPCTSTR lpszGroupName);

Parametri

nGroup
[in] Specifica l'indice in base zero del gruppo.

lpszGroupName
[in] Specifica il nome del gruppo.

Valore restituito

TRUE se il nome del gruppo è stato impostato correttamente; in caso contrario, FALSE.

CMFCTasksPane::SetGroupTextColor

Imposta il colore del testo per una didascalia del gruppo.

BOOL SetGroupTextColor(
    int nGroup,
    COLORREF color,
    COLORREF colorHot = (COLORREF)-1);

Parametri

nGroup
[in] Specifica l'indice in base zero del gruppo.

color
[in] Specifica il colore del testo.

colorHot
[in] Specifica il colore del testo per il gruppo evidenziato. Se -1, viene usato il colore di evidenziazione predefinito.

Valore restituito

TRUE se il colore del testo del gruppo è stato modificato correttamente; in caso contrario, FALSE.

CMFCTasksPane::SetGroupVertOffset

Imposta l'offset verticale per un gruppo.

void SetGroupVertOffset(int n = -1);

Parametri

n
[in] Specifica l'offset verticale.

Osservazioni:

L'offset verticale è la distanza tra un gruppo di attività e il bordo del riquadro attività.

Chiamare questo metodo per personalizzare i margini degli elementi del riquadro attività. Se n è -1, il framework determina il valore del margine usando gestione oggetti visivi (CMFCVisualManager::GetTasksPaneGroupVertOffset). L'offset predefinito è 15 pixel.

CMFCTasksPane::SetHorzMargin

Imposta il margine orizzontale.

void SetHorzMargin(int n = -1);

Parametri

n
[in] Specifica il margine, in pixel.

Osservazioni:

Il margine orizzontale è la distanza tra un riquadro attività e il bordo superiore o inferiore dell'area client.

Se n è -1 e il framework determina il valore del margine usando visual manager (CMFCVisualManager::GetTasksPaneHorzMargin). Il margine orizzontale predefinito è 12 pixel.

CMFCTasksPane::SetIconsList

Imposta l'elenco di immagini.

BOOL SetIconsList(
    UINT uiImageListResID,
    int cx,
    COLORREF clrTransparent = RGB(255, 0, 255));

void SetIconsList(HIMAGELIST hIcons);

Parametri

uiImageListResID
[in] Specifica l'ID risorsa dell'elenco di immagini.

cx
[in] Specifica le dimensioni delle icone nell'elenco di immagini.

clrTransparent
[in] Specifica il colore trasparente.

hIcons
[in] Specifica l'elenco di immagini che contiene le icone per il riquadro attività.

Osservazioni:

Il framework archivia le icone in un elenco di immagini. Le attività sono associate alle icone archiviate in tale elenco.

Questo metodo associa un elenco di immagini al controllo riquadro attività. Per impostare l'icona per un'attività quando si chiama CMFCTasksPane::AddTask, impostare nTaskIcon sull'indice in base zero appropriato in questo elenco di immagini.

CMFCTasksPane::SetPageCaption

Imposta il testo della didascalia per una pagina del riquadro attività.

void SetPageCaption(
    int nPageIdx,
    LPCTSTR lpszName);

Parametri

nPageIdx
[in] Specifica l'indice in base zero della pagina.

lpszName
[in] Specifica il testo della didascalia da visualizzare nella pagina.

Osservazioni:

Se un riquadro attività ha più pagine, la pagina predefinita include la didascalia impostata usando questo metodo.

CMFCTasksPane::SetTaskName

Imposta il nome per un'attività.

BOOL SetTaskName(
    int nGroup,
    int nTask,
    LPCTSTR lpszTaskName);

Parametri

nGroup
[in] Specifica l'indice in base zero del gruppo di attività.

nTask
[in] Specifica l'indice in base zero dell'attività.

lpszTaskName
[in] Specifica il nome dell'attività.

Valore restituito

TRUE se il nome dell'attività è stato impostato correttamente; in caso contrario, FALSE.

CMFCTasksPane::SetTasksHorzOffset

Imposta l'offset orizzontale per le attività.

void SetTasksHorzOffset(int n = -1);

Parametri

n
[in] Specifica l'offset orizzontale.

Osservazioni:

L'offset orizzontale è la distanza in pixel dai bordi sinistro e destro di un gruppo.

Se n è -1, questo metodo imposta l'offset orizzontale sul valore restituito dal CMFCVisualManager::GetTasksPaneTaskHorzOffset metodo .

L'offset orizzontale predefinito è 12 pixel.

CMFCTasksPane::SetTasksIconHorzOffset

void SetTasksIconHorzOffset(int n = -1);

Parametri

[in] n

Osservazioni:

CMFCTasksPane::SetTasksIconVertOffset

void SetTasksIconVertOffset(int n = -1);

Parametri

[in] n

Osservazioni:

CMFCTasksPane::SetTaskTextColor

Imposta il colore del testo per un'attività.

BOOL SetTaskTextColor(
    int nGroup,
    int nTask,
    COLORREF color,
    COLORREF colorHot = (COLORREF)-1);

Parametri

nGroup
[in] Specifica l'indice in base zero del gruppo di attività che contiene l'attività.

nTask
[in] Specifica l'indice in base zero dell'attività.

color
[in] Specifica il colore del testo per l'attività.

colorHot
[in] Specifica il colore del testo per il gruppo evidenziato. Se -1, questo metodo usa il colore di evidenziazione predefinito.

Valore restituito

TRUE se il colore del testo per l'attività è stato impostato correttamente; in caso contrario, FALSE.

CMFCTasksPane::SetVertMargin

Imposta il margine verticale.

void SetVertMargin(int n = -1);

Parametri

n
[in] Specifica il margine verticale da impostare.

Osservazioni:

Il margine verticale è la distanza tra un riquadro attività e i bordi verticali dell'area client.

Se n è -1, il framework determina il valore del margine usando gestione oggetti visivi (CMFCVisualManager::GetTasksPaneVertMargin). Il margine predefinito è 12 pixel.

CMFCTasksPane::SetWindowHeight

Imposta l'altezza di un controllo finestra.

BOOL SetWindowHeight(
    int nGroup,
    HWND hwndTask,
    int nWndHeight);

BOOL SetWindowHeight(
    HWND hwndTask,
    int nWndHeight);

Parametri

nGroup
[in] Specifica l'indice in base zero del gruppo che contiene il controllo finestra.

hwndTask
[in] Specifica l'handle per il controllo finestra.

nWndHeight
[in] Specifica l'altezza da impostare.

Valore restituito

TRUE se l'altezza del controllo finestra è stata impostata correttamente; FALSE se nGroup non è valido o se hwndTask non esiste.

Osservazioni:

Chiama CMFCTasksPane::AddWindow per aggiungere attività con controlli finestra.

CMFCTasksPane::ShowCommandMessageString

virtual void ShowCommandMessageString(UINT uiCmdId);

Parametri

[in] uiCmdId

Osservazioni:

CMFCTasksPane::ShowTask

Mostra o nasconde un'attività.

BOOL ShowTask(
    int nGroup,
    int nTask,
    BOOL bShow = TRUE,
    BOOL bRedraw = TRUE);

Parametri

nGroup
[in] Specifica l'indice in base zero del gruppo.

nTask
[in] Specifica l'indice in base zero dell'attività da visualizzare o nascondere.

bShow
[in] TRUE per mostrare l'attività; FALSE per nascondere l'attività.

bRedraw
[in] TRUE per ridisegnare il riquadro attività; in caso contrario, FALSE.

Valore restituito

TRUE se l'attività è stata visualizzata o nascosta correttamente; FALSE se il gruppo o l'attività specificati non esiste.

Osservazioni:

Usare CMFCTasksPane::ShowTaskByCmdId per visualizzare o nascondere un'attività in base al relativo ID comando.

CMFCTasksPane::ShowTaskByCmdId

Mostra o nasconde un'attività in base all'ID di comando.

BOOL ShowTaskByCmdId(
    UINT uiCommandID,
    BOOL bShow = TRUE,
    BOOL bRedraw = TRUE);

Parametri

uiCommandID
[in] Specifica l'ID comando dell'attività da visualizzare o nascondere.

bShow
[in] TRUE per mostrare l'attività; FALSE per nascondere l'attività.

bRedraw
[in] TRUE per ridisegnare il riquadro attività; in caso contrario, FALSE.

Valore restituito

TRUE se l'attività è stata visualizzata o nascosta correttamente; FALSE se un'attività con l'ID di comando specificato non esiste.

Osservazioni:

Usare CMFCTasksPane::ShowTask per visualizzare o nascondere un'attività in base al relativo ID comando.

CMFCTasksPane::Update

Aggiorna tutti i controlli in un riquadro attività.

virtual void Update();

Osservazioni:

Questo metodo aggiorna la didascalia del riquadro attività, regola la barra di scorrimento, riposiziona tutte le attività e ridisegna tutti i controlli del riquadro attività.

Eseguire l'override di questo metodo in una classe derivata per eseguire codice personalizzato quando il framework aggiorna il riquadro attività.

Vedi anche

Grafico della gerarchia
Classi
Classe CMFCTasksPaneTaskGroup
Classe CMFCTasksPaneTask
Classe CMFCOutlookBar
Classe CMFCVisualManager

Condividi tramite

Classe CMFCTasksPane

Sintassi

Membri

Costruttori pubblici

Metodi pubblici

Metodi protetti

Osservazioni:

Esempio

Gerarchia di ereditarietà

Requisiti

CMFCTasksPane::AddGroup

Parametri

Valore restituito

Osservazioni:

CMFCTasksPane::AddLabel

Parametri

Valore restituito

Osservazioni:

CMFCTasksPane::AddMRUFilesList

Parametri

Valore restituito

CMFCTasksPane::AddPage

Parametri

Valore restituito

CMFCTasksPane::AddSeparator

Parametri

Valore restituito

Osservazioni:

CMFCTasksPane::AddTask

Parametri

Valore restituito

CMFCTasksPane::AddWindow

Parametri

Valore restituito

Osservazioni:

CMFCTasksPane::CMFCTasksPane

CMFCTasksPane::CollapseAllGroups

Parametri

Osservazioni:

CMFCTasksPane::CollapseGroup

Parametri

Valore restituito

Osservazioni:

CMFCTasksPane::CreateDefaultMiniframe

Parametri

Valore restituito

Osservazioni:

CMFCTasksPane::CreateMenu

Valore restituito

Osservazioni:

CMFCTasksPane::EnableAnimation

Parametri

Osservazioni:

CMFCTasksPane::EnableGroupCollapse

Parametri

Osservazioni:

CMFCTasksPane::EnableHistoryMenuButtons

Parametri

Osservazioni:

CMFCTasksPane::EnableNavigationToolbar

Parametri

Osservazioni:

CMFCTasksPane::EnableOffsetCustomControls

Parametri

Osservazioni:

CMFCTasksPane::EnableScrollButtons

Parametri

Osservazioni:

CMFCTasksPane::EnableWrapLabels

Parametri

Osservazioni:

CMFCTasksPane::EnableWrapTasks

Parametri

Osservazioni:

CMFCTasksPane::GetActivePage

Valore restituito

CMFCTasksPane::GetGroupCaptionHeight

Valore restituito

CMFCTasksPane::GetGroupCaptionHorzOffset