Klasa CMFCTasksPane

Artykuł
10/12/2023

Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w folderze VC\atlmfc\src\mfc instalacji programu Visual Studio.

Klasa CMFCTasksPane implementuje listę elementów możliwych do kliknięcia (zadań).

Składnia

class CMFCTasksPane : public CDockablePane

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
CMFCTasksPane::CMFCTasksPane	`CMFCTasksPane` Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko	opis
CMFCTasksPane::AddGroup	Dodaje nową grupę zadań do kontrolki okienka zadań.
CMFCTasksPane::AddLabel	Dodaje nową etykietę statyczną do określonej grupy zadań.
CMFCTasksPane::AddMRUFilesList	Dodaje do grupy zadania określone przez listę plików ostatnio używanych (MRU).
CMFCTasksPane::AddPage	Dodaje nową stronę do okienka zadań.
CMFCTasksPane::AddSeparator
CMFCTasksPane::AddTask	Dodaje nowe zadanie do określonej grupy zadań.
CMFCTasksPane::AddWindow	Dodaje okno podrzędne do okienka zadań.
CMFCTasksPane::CollapseAllGroups
CMFCTasksPane::CollapseGroup	Programowo zwija grupę.
CMFCTasksPane::CreateDefaultMiniframe	(Przesłonięcia) CPane::CreateDefaultMiniframe.)
CMFCTasksPane::CreateMenu	Wywoływana przez platformę w celu utworzenia menu dla przycisku menu Inne zadania okienka .
CMFCTasksPane::EnableAnimation	Włącza lub wyłącza animację podczas zwijania lub rozszerzania grup zadań.
CMFCTasksPane::EnableGroupCollapse	Określa, czy można zwijać grupy zadań.
CMFCTasksPane::EnableHistoryMenuButtons	Włącza lub wyłącza menu rozwijane w przyciskach nawigacji Dalej i Poprzednie .
CMFCTasksPane::EnableNavigationToolbar	Włącza lub wyłącza pasek narzędzi nawigacji.
CMFCTasksPane::EnableOffsetCustomControls
CMFCTasksPane::EnableScrollButtons	Włącza przyciski przewijania zamiast paska przewijania.
CMFCTasksPane::EnableWrapLabels	Włącza lub wyłącza zawijanie wyrazów dla etykiet.
CMFCTasksPane::EnableWrapTasks	Włącza lub wyłącza zawijanie wyrazów dla zadań podrzędnych.
CMFCTasksPane::GetActivePage	Zwraca indeks oparty na zerach dla aktywnej strony.
CMFCTasksPane::GetGroupCaptionHeight	Zwraca wysokość podpisów grup.
CMFCTasksPane::GetGroupCaptionHorzOffset	Zwraca bieżące przesunięcie podpisu grupy z lewej i prawej krawędzi okienka zadań.
CMFCTasksPane::GetGroupCaptionVertOffset	Zwraca bieżące przesunięcie podpisu grupy z górnej i dolnej krawędzi okienka zadań.
CMFCTasksPane::GetGroupCount	Zwraca łączną liczbę grup.
CMFCTasksPane::GetGroupLocation	Zwraca wewnętrzny indeks grupy dla danej grupy.
CMFCTasksPane::GetGroupVertOffset	Zwraca przesunięcie pionowe grupy.
CMFCTasksPane::GetHorzMargin	Zwraca odstęp między okienkiem zadań a krawędziami obszaru klienta.
CMFCTasksPane::GetNextPages
CMFCTasksPane::GetPageByGroup	Pobiera indeks strony dla określonej grupy.
CMFCTasksPane::GetPagesCount	Zwraca liczbę stron.
CMFCTasksPane::GetPreviousPages
CMFCTasksPane::GetScrollBarCtrl	(Przesłonięcia) CWnd::GetScrollBarCtrl.)
CMFCTasksPane::GetTask	Pobiera zadanie.
CMFCTasksPane::GetTaskCount	Zwraca liczbę elementów zadań w określonej grupie.
CMFCTasksPane::GetTaskGroup	Zwraca grupę zadań dla danego indeksu grupy.
CMFCTasksPane::GetTaskLocation	Zwraca grupę i indeks dla danego zadania.
CMFCTasksPane::GetTasksHorzOffset	Zwraca przesunięcie poziome zadań z lewej i prawej krawędzi ich grup nadrzędnych.
CMFCTasksPane::GetTasksIconHorzOffset
CMFCTasksPane::GetTasksIconVertOffset
CMFCTasksPane::GetVertMargin	Zwraca odstępy w pionie między okienkiem zadań a krawędziami obszaru klienta.
CMFCTasksPane::IsAccessibilityCompatible	(Przesłania `CDockablePane::IsAccessibilityCompatible`).
CMFCTasksPane::IsAnimationEnabled	Wskazuje, czy animacja jest włączona.
CMFCTasksPane::IsBackButtonEnabled	Wskazuje, czy przycisk Wstecz jest włączony.
CMFCTasksPane::IsForwardButtonEnabled	Wskazuje, czy przycisk przesyłania dalej jest włączony.
CMFCTasksPane::IsGroupCollapseEnabled
CMFCTasksPane::IsHistoryMenuButtonsEnabled	Wskazuje, czy przyciski nawigacji Dalej i Poprzednie mają menu rozwijane.
CMFCTasksPane::IsNavigationToolbarEnabled	Wskazuje, czy pasek narzędzi nawigacji jest włączony.
CMFCTasksPane::IsToolBox
CMFCTasksPane::IsWrapLabelsEnabled	Wskazuje, czy okienko zadań opakowuje wyrazy w etykietach.
CMFCTasksPane::IsWrapTasksEnabled	Wskazuje, czy okienko zadań opakowuje wyrazy w zadaniach.
CMFCTasksPane::LoadState	(Przesłonięcia) CDockablePane::LoadState.)
CMFCTasksPane::OnCancel
CMFCTasksPane::OnClickTask	Wywoływana przez platformę, gdy użytkownik kliknie element w okienku zadań.
CMFCTasksPane::OnOK
CMFCTasksPane::OnPressBackButton	Wywoływana przez platformę, gdy użytkownik kliknie przycisk Wstecz.
CMFCTasksPane::OnPressForwardButton	Wywoływana przez platformę, gdy użytkownik kliknie przycisk nawigacji do przodu.
CMFCTasksPane::OnPressHomeButton	Wywoływana przez platformę, gdy użytkownik kliknie przycisk nawigacji głównej
CMFCTasksPane::OnPressOtherButton
CMFCTasksPane::OnSetAccData	(Przesłonięcia) CBasePane::OnSetAccData.)
CMFCTasksPane::OnUpdateCmdUI	(Przesłonięcia) CDockablePane::OnUpdateCmdUI.
CMFCTasksPane::P reTranslateMessage	(Przesłonięcia) CDockablePane::P reTranslateMessage).
CMFCTasksPane::RecalcLayout	(Przesłonięcia) CPane::RecalcLayout).
CMFCTasksPane::RemoveAllGroups	Usuwa wszystkie grupy na określonej stronie.
CMFCTasksPane::RemoveAllPages	Usuwa wszystkie strony z okienka zadań z wyjątkiem domyślnej (pierwszej) strony.
CMFCTasksPane::RemoveAllTasks	Usuwa wszystkie zadania z grupy.
CMFCTasksPane::RemoveGroup	Usuwa grupę.
CMFCTasksPane::RemovePage	Usuwa określoną stronę z okienka zadań.
CMFCTasksPane::RemoveTask	Usuwa zadanie z grupy zadań.
CMFCTasksPane::SaveState	(Przesłonięcia) CDockablePane::SaveState.
CMFCTasksPane::Serialize	(Przesłonięcia) CDockablePane::Serialize.)
CMFCTasksPane::SetActivePage	Aktywuje określoną stronę w okienku zadań.
CMFCTasksPane::SetCaption	Ustawia nazwę podpisu okienka zadań.
CMFCTasksPane::SetGroupCaptionHeight	Ustawia wysokość podpisu grupy.
CMFCTasksPane::SetGroupCaptionHorzOffset	Ustawia przesunięcie poziome podpisu grupy.
CMFCTasksPane::SetGroupCaptionVertOffset	Ustawia przesunięcie pionowe podpisu grupy.
CMFCTasksPane::SetGroupName	Ustawia nazwę grupy.
CMFCTasksPane::SetGroupTextColor	Ustawia kolor tekstu dla podpisu grupy.
CMFCTasksPane::SetGroupVertOffset	Ustawia przesunięcie pionowe dla grupy.
CMFCTasksPane::SetHorzMargin	Ustawia odstępy poziome między okienkiem zadań a krawędziami obszaru klienta.
CMFCTasksPane::SetIconsList	Ustawia listę obrazów skojarzona z zadaniami.
CMFCTasksPane::SetPageCaption	Ustawia tekst podpisu dla strony okienka zadań.
CMFCTasksPane::SetTaskName	Ustawia nazwę zadania.
CMFCTasksPane::SetTasksIconHorzOffset
CMFCTasksPane::SetTasksIconVertOffset
CMFCTasksPane::SetTaskTextColor	Ustawia kolor tekstu zadania.
CMFCTasksPane::SetTasksHorzOffset	Ustawia przesunięcie poziome zadań od lewej i prawej krawędzi grup nadrzędnych.
CMFCTasksPane::SetVertMargin	Ustawia odstępy w pionie między okienkiem zadań a krawędziami obszaru klienta.
CMFCTasksPane::SetWindowHeight	Ustawia wysokość okna.
CMFCTasksPane::ShowCommandMessageString
CMFCTasksPane::ShowTask	Pokazuje lub ukrywa zadanie.
CMFCTasksPane::ShowTaskByCmdId	Wyświetla lub ukrywa zadanie na podstawie jego identyfikatora polecenia.
CMFCTasksPane::Update	Aktualizuje elementy graficznego interfejsu użytkownika należące do okienka zadań.

Metody chronione

Nazwa/nazwisko	opis
CMFCTasksPane::OnActivateTasksPanePage	Wywoływana przez platformę po aktywowaniu nowej strony okienka zadań.

Uwagi

Klasa CMFCTasksPane implementuje następujące funkcje:

Elementy można grupować, a każda grupa elementów może mieć skojarzony podpis.
Grupowania elementów można zwinąć lub rozwinąć.
Do każdego elementu w okienku zadań można przypisać ikonę.
Poszczególne elementy można skojarzyć z identyfikatorem polecenia, który jest wykonywany, gdy użytkownik kliknie element. Po kliknięciu komunikat WM_COMMAND jest wysyłany do właściciela kontrolki okienka zadań.

Aby użyć kontrolki CMFCTasksPane w aplikacji, wykonaj następujące kroki:

CMFCTasksPane Osadź obiekt w głównej klasie okien ramowych.
Podczas przetwarzania komunikatu WM_CREATE wywołaj metodę Create . Można użyć zwykłych stylów CControlBar . Aby uzyskać więcej informacji, zobacz CControlBar::Create.
Wywołaj metodę CMFCTasksPane::AddGroup , aby dodać różne grupy.
Wywołaj funkcje członkowskie CMFCTasksPane::AddTask, CMFCTasksPane::AddLabel lub CMFCTasksPane::AddMRUFilesList, aby dodać nowe elementy (zadania) do każdej grupy.
Wywołaj metodę CMFCTasksPane::EnableGroupCollapse , aby określić, czy grupy elementów mogą się zwinąć.

Poniższa ilustracja przedstawia typową kontrolkę okienka zadań. Pierwsza grupa jest grupą specjalną , a jej podpis jest ciemniejszy. Trzecia grupa jest zwinięta. Ostatnia grupa jest wyrównana do dołu okienka zadań i nie ma podpisu, a ostatnie zadanie w grupie jest prostą etykietą:

Przykład okienka zadań.

Wygląd okienka zadań można dostosować, dostosowując różne marginesy i przesunięcia. Poniższa ilustracja wyjaśnia znaczenie tych zmiennych:

Niestandardowa grupa zadań.

Przykład

W poniższym przykładzie pokazano, jak skonstruować CMFCTasksPane obiekt i używać różnych metod w CMFCTasksPane klasie. W przykładzie pokazano, jak włączyć zwijanie grup zadań, włączyć menu rozwijane na przyciskach nawigacji Dalej i Poprzednie , włączyć przyciski przewijania zamiast paska przewijania, włączyć zawijanie wyrazów dla tekstu w etykietach, ustawić nazwę podpisu okienka zadań, ustawić kolor tekstu dla podpisu grupy, i ustaw marginesy poziome i pionowe.

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();

Hierarchia dziedziczenia

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

Wymagania

Nagłówek: afxTasksPane.h

CMFCTasksPane::AddGroup

Dodaje nową grupę zadań do kontrolki okienka zadań.

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);

Parametry

nPageIdx
[in] Określa indeks strony opartej na zera.

lpszGroupName
[in] Określa nazwę grupy.

bBottomLocation
[in] WARTOŚĆ TRUE, aby utworzyć grupę w dolnej części kontrolki okienka zadań; w przeciwnym razie, FAŁSZ.

bSpecial
[in] Wartość TRUE oznaczania tej grupy jako grupy specjalnej; w przeciwnym razie wartość FALSE. Aby uzyskać więcej informacji na temat grup specjalnych, zobacz sekcję Uwagi w temacie CMFCTasksPane.

hIcon
[in] Określa ikonę do wyświetlenia w podpisie grupy.

Wartość zwracana

Indeks grupy na podstawie zera na wewnętrznej liście grup, które są obsługiwane przez klasę.

Uwagi

Wywołaj tę metodę, aby utworzyć grupę zadań i dodać tę grupę do kontrolki okienka zadań.

Platforma wyświetla grupy zadań w górnej części kontrolki okienka zadań lub u dołu. Platforma może wyświetlać tylko jedną grupę u dołu; ta grupa musi zostać dodana ostatnio.

CMFCTasksPane::AddLabel

Dodaje etykietę do określonej grupy zadań.

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

Parametry

nGroup
[in] Określa indeks grupy, w której jest dodawana etykieta.

lpszLabelName
[in] Określa nazwę etykiety.

nTaskIcon
[in] Określa ikonę do wyświetlenia obok etykiety. Platforma przechowuje ikony na liście obrazów. Ten parametr jest indeksem na tej liście.

bIsBold
[in] WARTOŚĆ TRUE, aby wyświetlić etykietę w tekście pogrubiony; w przeciwnym razie, FAŁSZ.

Wartość zwracana

Indeks oparty na zerach grupy, w której została dodana etykieta, lub -1, jeśli grupa określona przez nGroup nie istnieje.

Uwagi

Struktura obsługuje zadania i etykiety w inny sposób. Gdy użytkownik kliknie zadanie, platforma wykonuje polecenie. Gdy użytkownik kliknie etykietę, nie zostanie wykonane żadne polecenie. Aby uzyskać więcej informacji, zobacz CMFCTasksPane::AddTask.

CMFCTasksPane::AddMRUFilesList

Dodaje zadanie dla każdego pliku przechowywanego na liście plików ostatnio używanych (MRU) do grupy.

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

Parametry

nGroup
[in] Określa indeks grupy. Ta metoda dodaje listę plików MRU do grupy określonej przez ten parametr.

nMaxFiles
[in] Określa liczbę plików do wyświetlenia na liście plików MRU.

Wartość zwracana

Zerowy indeks grupy, w której dodano listę plików MRU lub -1, jeśli grupa określona przez nGroup nie istnieje.

CMFCTasksPane::AddPage

Dodaje stronę do okienka zadań.

int AddPage(LPCTSTR lpszPageLabel);

Parametry

lpszPageLabel
[in] Określa etykietę strony.

Wartość zwracana

Indeks nowej strony oparty na zera.

CMFCTasksPane::AddSeparator

int AddSeparator(int nGroup);

Parametry

[in] nGroup

Wartość zwracana

Uwagi

CMFCTasksPane::AddTask

Dodaje zadanie do określonej grupy zadań.

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

Parametry

nGroup
[in] Określa indeks grupy, w którym jest dodawane zadanie.

lpszTaskName
[in] Określa nazwę zadania.

nTaskIcon
[in] Określa ikonę do wyświetlenia obok zadania. Platforma przechowuje ikony na liście obrazów. Ten parametr jest indeksem na tej liście.

uiCommandID
[in] Określa identyfikator polecenia do wykonania, gdy użytkownik kliknie zadanie. Zadanie jest traktowane jako etykieta, jeśli uiCommandID ma wartość 0.

dwUserData
[in] Określa dane zdefiniowane przez użytkownika, które mają być skojarzone z zadaniem.

Wartość zwracana

Indeks zerowy grupy, w której zostało dodane zadanie, lub -1, jeśli grupa określona przez nGroup nie istnieje.

CMFCTasksPane::AddWindow

Dodaje okno podrzędne do okienka zadań.

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

Parametry

nGroup
[in] Określa indeks grupy, w którym jest dodawane okno.

hwndTask
[in] Określa uchwyt okna do dodania.

nWndHeight
[in] Określa wysokość okna.

bAutoDestroyWindow
[in] WARTOŚĆ TRUE, aby zniszczyć okno po usunięciu zadania; w przeciwnym razie, FAŁSZ.

dwUserData
[in] Określa dane zdefiniowane przez użytkownika skojarzone z zadaniem.

Wartość zwracana

Indeks zerowy grupy, w której dodano okno, lub -1, jeśli grupa określona przez nGroup nie istnieje.

Uwagi

Wywołaj tę metodę, aby dodać kontrolkę do okienka zadań. Możesz na przykład dodać kontrolkę edycji, która działa jak pasek wyszukiwania.

CMFCTasksPane::CMFCTasksPane

Tworzy obiekt CMFCTasksPane.

CMFCTasksPane();

CMFCTasksPane::CollapseAllGroups

void CollapseAllGroups(BOOL bCollapse = TRUE);

void CollapseAllGroups(
    int nPageIdx,
    BOOL bCollapse);

Parametry

[in] bCollapse
[in] nPageIdx

Uwagi

CMFCTasksPane::CollapseGroup

Zwija lub rozwija grupę.

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

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

Parametry

PGroup
[in] Określa grupę do zwinięcia.

bCollapse
[in] Wartość TRUE, aby zwinąć grupę; FAŁSZ, aby rozwinąć grupę.

nGroup
[in] Określa indeks zerowy grupy do zwinięcia na wewnętrznej liście grup.

Wartość zwracana

WARTOŚĆ TRUE, jeśli grupa zostanie zwinięta lub rozwija się pomyślnie; w przeciwnym razie, FAŁSZ.

Uwagi

Zwiniętą grupę zawiera tylko podpis grupy; lista zadań jest ukryta.

CMFCTasksPane::CreateDefaultMiniframe

virtual CPaneFrameWnd* CreateDefaultMiniframe(CRect rectInitial);

Parametry

[in] rectInitial

Wartość zwracana

Uwagi

CMFCTasksPane::CreateMenu

Tworzy menu wyświetlane po kliknięciu przez użytkownika przycisku menu Inne zadania .

HMENU CreateMenu() const;

Wartość zwracana

Uchwyt do nowego menu.

Uwagi

Zastąp tę metodę w klasie pochodnej, aby dostosować menu okienka zadań.

Menu podręczne tworzone przez tę metodę zawiera listę stron w okienku zadań. Menu wyświetla znacznik wyboru obok aktywnej strony.

CMFCTasksPane::EnableAnimation

Włącza lub wyłącza animację, która występuje po rozwinięciu lub zwinięciu grupy zadań.

void EnableAnimation(BOOL bEnable = TRUE);

Parametry

bEnable
[in] WARTOŚĆ TRUE, aby włączyć animację, która występuje po rozwinięciu lub zwinięciu grupy zadań; w przeciwnym razie, FAŁSZ.

Uwagi

Domyślnie animacja wykonywana po rozwinięciu lub zwinięciu grupy zadań jest włączona.

CMFCTasksPane::EnableGroupCollapse

Określa, czy użytkownik może zwinąć grupy zadań.

void EnableGroupCollapse(BOOL bEnable);

Parametry

bEnable
[in] WARTOŚĆ TRUE, jeśli użytkownicy mogą zwijać grupy zadań; w przeciwnym razie, FAŁSZ.

Uwagi

Zwiniętą grupę zadań wyświetla tylko podpis grupy; lista zadań jest ukryta.

CMFCTasksPane::EnableHistoryMenuButtons

Włącza menu rozwijane na przyciskach nawigacji Dalej i Poprzednie .

void EnableHistoryMenuButtons(BOOL bEnable = TRUE);

Parametry

bEnable
[in] Wartość TRUE w celu włączenia menu rozwijanych na przyciskach nawigacji Dalej i Poprzednia ; w przeciwnym razie wartość FALSE.

Uwagi

Domyślnie menu rozwijane na przyciskach Dalej i Poprzednie są wyłączone.

Menu zawierają historię stron zadań używanych przez użytkownika.

CMFCTasksPane::EnableNavigationToolbar

Włącza lub wyłącza pasek narzędzi nawigacji.

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

Parametry

bEnable
[in] WARTOŚĆ TRUE, aby włączyć pasek narzędzi nawigacji; w przeciwnym razie, FAŁSZ.

uiToolbarBmpRes
[in] Określa identyfikator zasobu mapy bitowej zawierającej obrazy do wyświetlenia na pasku narzędzi.

sizeToolbarImage
[in] Określa rozmiar obrazu paska narzędzi.

sizeToolbarButton
[in] Określa rozmiar przycisku paska narzędzi.

Uwagi

Pasek narzędzi nawigacji to pasek narzędzi wyświetlany w górnej części okienka zadań. Pasek narzędzi nawigacji zawiera przyciski nawigacji Wstecz, Prześlij dalej i Narzędzia główne oraz przycisk menu zawierający listę dostępnych stron.

Domyślnie platforma nie wyświetla paska narzędzi nawigacji. Jeśli pasek narzędzi nawigacji nie jest wyświetlany, przyciski nawigacji znajdują się na podpisie paska dokowania.

CMFCTasksPane::EnableOffsetCustomControls

void EnableOffsetCustomControls(BOOL bEnable);

Parametry

[in] bEnable

Uwagi

CMFCTasksPane::EnableScrollButtons

Włącza przyciski przewijania zamiast paska przewijania.

void EnableScrollButtons(BOOL bEnable = TRUE);

Parametry

bEnable
[in] Wartość TRUE do wyświetlania przycisków przewijania w okienku zadań zamiast paska przewijania; w przeciwnym razie, FAŁSZ.

Uwagi

Domyślnie platforma wyświetla przyciski przewijania w okienku zadań.

CMFCTasksPane::EnableWrapLabels

Włącza lub wyłącza zawijanie wyrazów dla tekstu w etykietach.

void EnableWrapLabels(BOOL bEnable = TRUE);

Parametry

bEnable
[in] Wartość TRUE, aby opakowować tekst w etykietach wyświetlanych w okienku zadań; w przeciwnym razie, FAŁSZ.

Uwagi

Domyślnie struktura nie opakowuje tekstu w etykietach. Po włączeniu zawijania wyrazów tekst w etykietach może być wyświetlany w wielu wierszach. Etykieta może zawierać znaczniki podziału wierszy, takie jak \n i znacznik &podkreślenia .

CMFCTasksPane::EnableWrapTasks

Włącza lub wyłącza zawijanie wyrazów dla tekstu w zadaniach.

void EnableWrapTasks(BOOL bEnable = TRUE);

Parametry

bEnable
[in] WARTOŚĆ TRUE do zawijania zadań w okienku zadań; w przeciwnym razie, FAŁSZ.

Uwagi

Domyślnie zawijanie wyrazów dla zadań jest wyłączone.

CMFCTasksPane::GetActivePage

Zwraca indeks oparty na zerach dla aktywnej strony.

int GetActivePage() const;

Wartość zwracana

Indeks oparty na zera aktywnej stronie.

CMFCTasksPane::GetGroupCaptionHeight

Zwraca wysokość podpisu grupy.

int GetGroupCaptionHeight() const;

Wartość zwracana

Wysokość podpisu grupy w pikselach.

CMFCTasksPane::GetGroupCaptionHorzOffset

Zwraca przesunięcie poziome podpisu grupy.

int GetGroupCaptionHorzOffset() const;

Wartość zwracana

Przesunięcie poziome podpisu grupy. Przesunięcie poziome to odległość w pikselach od lewej lub prawej krawędzi okienka zadań.

CMFCTasksPane::GetGroupCaptionVertOffset

Zwraca przesunięcie pionowe podpisu grupy.

int GetGroupCaptionVertOffset() const;

Wartość zwracana

Przesunięcie w pionie podpisu grupy z górnej i dolnej krawędzi okienka zadań.

Uwagi

Wartość domyślna przesunięcia pionowego to 7 pikseli.

CMFCTasksPane::GetGroupCount

Zwraca łączną liczbę grup.

int GetGroupCount() const;

Wartość zwracana

Całkowita liczba grup w okienku zadań.

CMFCTasksPane::GetGroupLocation

Zwraca wewnętrzny indeks grupy dla określonej grupy.

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

Parametry

PGroup
[in] Określa grupę zadań, której lokalizacja jest pobierana.

nGroup
[out] Zawiera indeks zerowy grupy zadań.

Wartość zwracana

WARTOŚĆ TRUE, jeśli grupa zadań została znaleziona; w przeciwnym razie, FAŁSZ.

CMFCTasksPane::GetGroupVertOffset

Zwraca przesunięcie pionowe grupy.

int GetGroupVertOffset() const;

Wartość zwracana

Przesunięcie w pionie grupy w pikselach.

CMFCTasksPane::GetHorzMargin

Zwraca odstęp między okienkiem zadań a krawędzią obszaru klienta.

int GetHorzMargin() const;

Wartość zwracana

Odstępy poziome między okienkiem zadań a krawędzią obszaru klienta.

Uwagi

Domyślny odstęp między okienkiem zadań a krawędzią obszaru klienta to 12 pikseli.

CMFCTasksPane::GetNextPages

void GetNextPages(CStringList& lstNextPages) const;

Parametry

[in] lstNextPages

Uwagi

CMFCTasksPane::GetPageByGroup

Pobiera indeks strony dla określonej grupy.

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

Parametry

nGroup
[in] Określa indeks zerowy grupy zadań.

nPage
[out] Zawiera indeks strony dla określonej grupy. Jeśli grupa zadań zawiera tylko stronę domyślną, zwracana wartość to 0.

Wartość zwracana

Wartość TRUE, jeśli grupa nGroup istnieje; w przeciwnym razie wartość FALSE.

CMFCTasksPane::GetPagesCount

Zwraca liczbę stron.

int GetPagesCount() const;

Wartość zwracana

Liczba stron w okienku zadań.

CMFCTasksPane::GetPreviousPages

void GetPreviousPages(CStringList& lstPrevPages) const;

Parametry

[in] lstPrevPages

Uwagi

CMFCTasksPane::GetScrollBarCtrl

virtual CScrollBar* GetScrollBarCtrl(int nBar) const;

Parametry

[in] pasek n

Wartość zwracana

Uwagi

CMFCTasksPane::GetTask

Pobiera zadanie.

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

Parametry

nGroup
[in] Określa indeks zerowy grupy zawierającej zadanie.

nTask
[in] Określa indeks na podstawie zera zadania na liście określonej przez nGroup.

Wartość zwracana

Zadanie w określonym indeksie.

CMFCTasksPane::GetTaskCount

Zwraca liczbę zadań w określonej grupie.

int GetTaskCount(int nGroup) const;

Parametry

nGroup
[in] Określa indeks grupy zadań.

Wartość zwracana

Liczba zadań w określonej grupie lub 0, jeśli nGroup jest nieprawidłowa.

CMFCTasksPane::GetTaskGroup

Zwraca grupę zadań dla określonego indeksu grupy.

CMFCTasksPaneTaskGroup* GetTaskGroup(int nGroup) const;

Parametry

nGroup
[in] Określa indeks zerowy grupy do pobrania.

Wartość zwracana

Grupa zadań w określonym indeksie.

CMFCTasksPane::GetTaskLocation

Zwraca grupę i indeks dla określonego zadania.

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;

Parametry

uiCommandID
[in] Określa identyfikator polecenia zadania do znalezienia.

nGroup
[out] Zawiera indeks grupy zadania.

nTask
[out] Zawiera indeks zadania w grupie zadań.

hwndTask
[in] Określa okno skojarzone z zadaniem.

pTask
[in] Określa zadanie do znalezienia.

Wartość zwracana

WARTOŚĆ TRUE, jeśli lokalizacja zadania została znaleziona; FAŁSZ, jeśli określone zadanie nie istnieje.

Uwagi

Ta metoda pobiera indeks grupy i indeks zadań dla określonego zadania. Jeśli metoda zwraca wartość FALSE, wartości nGroup i nTask są ustawione na -1.

CMFCTasksPane::GetTasksHorzOffset

Zwraca przesunięcie poziome zadań.

int GetTasksHorzOffset() const;

Wartość zwracana

Przesunięcie poziome zadań z lewej i prawej krawędzi ich grup nadrzędnych.

Uwagi

Domyślne przesunięcie w poziomie zadań to 12 pikseli.

CMFCTasksPane::GetTasksIconHorzOffset

int GetTasksIconHorzOffset() const;

Wartość zwracana

Uwagi

CMFCTasksPane::GetTasksIconVertOffset

int GetTasksIconVertOffset() const;

Wartość zwracana

Uwagi

CMFCTasksPane::GetVertMargin

Zwraca pionowy margines między okienkiem zadań a krawędziami obszaru klienta.

int GetVertMargin() const;

Wartość zwracana

Pionowy margines między okienkiem zadań a krawędziami obszaru klienta.

Uwagi

Pionowy margines to przestrzeń między okienkiem zadań a krawędziami obszaru klienta. Wartość domyślna marginesu pionowego to 12 pikseli.

CMFCTasksPane::IsAccessibilityCompatible

virtual BOOL IsAccessibilityCompatible();

Wartość zwracana

Uwagi

CMFCTasksPane::IsAnimationEnabled

Wskazuje, czy animacja jest włączona.

BOOL IsAnimationEnabled() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli animacja wykonywana po rozwinięciu lub zwinięciu grupy jest włączona; w przeciwnym razie, FAŁSZ.

Uwagi

Wywołaj polecenie CMFCTasksPane::EnableAnimation , aby włączyć lub wyłączyć animację.

CMFCTasksPane::IsBackButtonEnabled

Wskazuje, czy przycisk Wstecz jest włączony.

BOOL IsBackButtonEnabled() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli przycisk Wstecz jest włączony; w przeciwnym razie, FAŁSZ.

Uwagi

Gdy użytkownik kliknie przycisk Wstecz, platforma wyświetli poprzednią stronę zadania.

CMFCTasksPane::IsForwardButtonEnabled

Wskazuje, czy przycisk przesyłania dalej jest włączony.

BOOL IsForwardButtonEnabled() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli przycisk przesyłania dalej jest włączony; w przeciwnym razie, FAŁSZ.

Uwagi

Przycisk przesyłania dalej umożliwia nawigację do przodu w historii stron zadań.

CMFCTasksPane::IsGroupCollapseEnabled

BOOL IsGroupCollapseEnabled() const;

Wartość zwracana

Uwagi

CMFCTasksPane::IsHistoryMenuButtonsEnabled

Wskazuje, czy przyciski nawigacji Dalej i Poprzednie mają menu rozwijane.

BOOL IsHistoryMenuButtonsEnabled() const;

Wartość zwracana

Wartość TRUE, jeśli przyciski nawigacji Dalej i Poprzednie mają menu rozwijane; w przeciwnym razie wartość FALSE.

CMFCTasksPane::IsNavigationToolbarEnabled

Wskazuje, czy pasek narzędzi nawigacji jest włączony.

BOOL IsNavigationToolbarEnabled() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli pasek narzędzi nawigacji jest włączony; w przeciwnym razie, FAŁSZ.

CMFCTasksPane::IsToolBox

virtual BOOL IsToolBox() const;

Wartość zwracana

Uwagi

CMFCTasksPane::IsWrapLabelsEnabled

Wskazuje, czy okienko zadań opakowuje wyrazy w etykietach.

BOOL IsWrapLabelsEnabled() const;

Wartość zwracana

PRAWDA, jeśli słowa w etykietach są opakowane; w przeciwnym razie, FAŁSZ.

CMFCTasksPane::IsWrapTasksEnabled

Określa, czy struktura opakowuje ciąg zadania.

BOOL IsWrapTasksEnabled() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli ciąg zadania jest opakowany; w przeciwnym razie, FAŁSZ.

CMFCTasksPane::LoadState

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

Parametry

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

Wartość zwracana

Uwagi

CMFCTasksPane::OnActivateTasksPanePage

Wywoływana przez platformę, gdy powoduje, że strona okienka zadań jest aktywna.

virtual void OnActivateTasksPanePage();

Uwagi

Zastąp tę metodę w klasie pochodnej, aby dostosować wygląd strony okienka zadań.

CMFCTasksPane::OnCancel

virtual void OnCancel();

Uwagi

CMFCTasksPane::OnClickTask

Wywoływana przez platformę, gdy użytkownik kliknie element w okienku zadań.

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

Parametry

nGroupNumber
[in] Określa indeks zerowy grupy zawierającej klikniętego zadania.

nTaskNumber
[in] Określa indeks zerowy klikniętego zadania.

uiCommandID
[in] Określa identyfikator polecenia skojarzony z zadaniem.

dwUserData
[in] Zawiera dane zdefiniowane przez użytkownika skojarzone z klikniętym zadaniem.

Uwagi

Struktura wywołuje tę metodę, gdy użytkownik kliknie zadanie. Domyślnie struktura sprawdza identyfikator polecenia skojarzony z klikniętym zadaniem, a jeśli nie jest zero, wysyła komunikat WM_COMMAND do właściciela kontrolki okienka zadań.

Zastąp tę metodę w klasie pochodnej, aby wykonać kod niestandardowy po kliknięciu zadania.

CMFCTasksPane::OnOK

virtual void OnOK();

Uwagi

CMFCTasksPane::OnPressBackButton

Wywoływana przez platformę, gdy użytkownik kliknie przycisk Wstecz.

virtual void OnPressBackButton();

Uwagi

Domyślnie platforma wyświetla wcześniej wyświetloną stronę.

Zastąp tę metodę w klasie pochodnej, aby wykonać kod niestandardowy, gdy użytkownik kliknie przycisk Wstecz.

CMFCTasksPane::OnPressForwardButton

Wywoływana przez platformę, gdy użytkownik kliknie przycisk nawigacji do przodu.

virtual void OnPressForwardButton();

Uwagi

Domyślnie platforma wyświetla stronę wyświetlaną przez użytkownika przed kliknięciem przycisku Wstecz .

Zastąp tę metodę w klasie pochodnej, aby wykonać kod niestandardowy, gdy użytkownik kliknie przycisk przesyłania dalej.

CMFCTasksPane::OnPressHomeButton

Wywoływana przez platformę, gdy użytkownik kliknie przycisk nawigacji głównej.

virtual void OnPressHomeButton();

Uwagi

Domyślnie platforma wyświetla domyślną stronę grupy zadań.

Zastąp tę metodę w klasie pochodnej, aby wykonać kod niestandardowy, gdy użytkownik kliknie przycisk nawigacji głównej.

CMFCTasksPane::OnPressOtherButton

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

Parametry

[in] pbtn
[in] pWndOwner

Uwagi

CMFCTasksPane::OnSetAccData

virtual BOOL OnSetAccData(long lVal);

Parametry

[in] lVal

Wartość zwracana

Uwagi

CMFCTasksPane::OnUpdateCmdUI

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

Parametry

[in] pTarget
[in] bDisableIfNoHndler

Uwagi

CMFCTasksPane::P reTranslateMessage

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parametry

[in] PMsg

Wartość zwracana

Uwagi

CMFCTasksPane::RecalcLayout

void RecalcLayout(BOOL bRedraw = TRUE);

Parametry

[in] bRedraw

Uwagi

CMFCTasksPane::RemoveAllGroups

Usuwa wszystkie grupy na określonej stronie.

void RemoveAllGroups(int nPageIdx = 0);

Parametry

nPageIdx
[in] Określa indeks na podstawie zera strony.

Uwagi

Usuwa wszystkie grupy na stronie określonej przez nPageIdx lub wszystkie grupy, jeśli istnieje tylko strona domyślna.

CMFCTasksPane::RemoveAllPages

Usuwa wszystkie strony z okienka zadań z wyjątkiem domyślnej (pierwszej) strony.

void RemoveAllPages();

CMFCTasksPane::RemoveAllTasks

Usuwa wszystkie zadania z określonej grupy.

void RemoveAllTasks(int nGroup);

Parametry

nGroup
[in] Określa indeks zerowy grupy.

CMFCTasksPane::RemoveGroup

Usuwa grupę.

void RemoveGroup(int nGroup);

Parametry

nGroup
[in] Określa indeks zerowy grupy do usunięcia.

Uwagi

Ta metoda usuwa pojedynczą grupę. Aby usunąć wszystkie grupy, zamiast tego wywołaj polecenie CMFCTasksPane::RemoveAllGroups .

Gdy platforma usunie grupę, wszystkie skojarzone z nią zadania i okna użytkownika zostaną zniszczone.

CMFCTasksPane::RemovePage

Usuwa określoną stronę z okienka zadań.

void RemovePage(int nPageIdx);

Parametry

nPageIdx
[in] Określa indeks zerowy strony do usunięcia.

CMFCTasksPane::RemoveTask

Usuwa zadanie z grupy zadań.

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

Parametry

nGroup
[in] Określa indeks zerowy grupy zadań, która zawiera zadanie do usunięcia.

nTask
[in] Określa indeks zerowy zadania do usunięcia.

bRedraw
[in] WARTOŚĆ TRUE, aby ponownie wyrysować okienko zadań; w przeciwnym razie, FAŁSZ.

Wartość zwracana

WARTOŚĆ TRUE, jeśli funkcja powiedzie się; FAŁSZ, jeśli parametr nGroup lub nTask jest nieprawidłowy.

CMFCTasksPane::SaveState

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

Parametry

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

Wartość zwracana

Uwagi

CMFCTasksPane::Serialize

virtual void Serialize(CArchive& ar);

Parametry

[in] Ar

Uwagi

CMFCTasksPane::SetActivePage

Powoduje, że określona strona w okienku zadań jest aktywna.

void SetActivePage(int nPageIdx);

Parametry

nPageIdx
[in] Określa indeks zerowy strony do wyświetlenia.

Uwagi

Ta metoda potwierdza, czy nPageIdx jest nieprawidłowy.

CMFCTasksPane::SetCaption

Ustawia nazwę podpisu okienka zadań.

void SetCaption(LPCTSTR lpszName);

Parametry

lpszName
[in] Określa nazwę podpisu.

Uwagi

Jeśli okienko zadań ma wiele stron, domyślna strona zawiera podpis ustawiony przy użyciu tej funkcji.

CMFCTasksPane::SetGroupCaptionHeight

Ustawia wysokość podpisu grupy.

void SetGroupCaptionHeight(int n = -1);

Parametry

n
[in] Określa wysokość podpisu.

Uwagi

Wywołaj tę metodę, aby dostosować marginesy elementów okienka zadań.

Jeśli n ma wartość -1, struktura określa wartość marginesu przy użyciu menedżera wizualizacji ( CMFCVisualManager::GetTasksPaneGroupCaptionHeight). Domyślna wysokość podpisu to 25 pikseli.

CMFCTasksPane::SetGroupCaptionHorzOffset

Ustawia przesunięcie poziome podpisu grupy.

void SetGroupCaptionHorzOffset(int n = -1);

Parametry

n
[in] Określa przesunięcie w poziomie podpisu grupy.

CMFCTasksPane::SetGroupCaptionVertOffset

Ustawia przesunięcie pionowe podpisu grupy.

void SetGroupCaptionVertOffset(int n = -1);

Parametry

n
[in] Określa przesunięcie pionowe w pikselach podpisu grupy.

CMFCTasksPane::SetGroupName

Ustawia nazwę grupy.

BOOL SetGroupName(
    int nGroup,
    LPCTSTR lpszGroupName);

Parametry

nGroup
[in] Określa indeks zerowy grupy.

lpszGroupName
[in] Określa nazwę grupy.

Wartość zwracana

Wartość TRUE, jeśli nazwa grupy została pomyślnie ustawiona; w przeciwnym razie, FAŁSZ.

CMFCTasksPane::SetGroupTextColor

Ustawia kolor tekstu dla podpisu grupy.

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

Parametry

nGroup
[in] Określa indeks zerowy grupy.

Kolor
[in] Określa kolor tekstu.

colorHot
[in] Określa kolor tekstu dla wyróżnionej grupy. Jeśli wartość -1, jest używany domyślny kolor wyróżnienia.

Wartość zwracana

WARTOŚĆ TRUE, jeśli kolor tekstu grupy został pomyślnie zmieniony; w przeciwnym razie, FAŁSZ.

CMFCTasksPane::SetGroupVertOffset

Ustawia przesunięcie pionowe dla grupy.

void SetGroupVertOffset(int n = -1);

Parametry

n
[in] Określa przesunięcie pionowe.

Uwagi

Przesunięcie pionowe to odległość między grupą zadań a obramowaniem okienka zadań.

Wywołaj tę metodę, aby dostosować marginesy elementów okienka zadań. Jeśli n ma wartość -1, struktura określa wartość marginesu przy użyciu menedżera wizualizacji (CMFCVisualManager::GetTasksPaneGroupVertOffset). Domyślne przesunięcie to 15 pikseli.

CMFCTasksPane::SetHorzMargin

Ustawia margines poziomy.

void SetHorzMargin(int n = -1);

Parametry

n
[in] Określa margines w pikselach.

Uwagi

Margines poziomy to odległość między okienkiem zadań a górną lub dolną krawędzią obszaru klienta.

Jeśli n ma wartość -1, a struktura określa wartość marginesu przy użyciu menedżera wizualizacji (CMFCVisualManager::GetTasksPaneHorzMargin). Domyślny margines poziomy to 12 pikseli.

CMFCTasksPane::SetIconsList

Ustawia listę obrazów.

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

void SetIconsList(HIMAGELIST hIcons);

Parametry

uiImageListResID
[in] Określa identyfikator zasobu listy obrazów.

cx
[in] Określa rozmiar ikon na liście obrazów.

clrTransparent
[in] Określa przezroczysty kolor.

hIcons
[in] Określa listę obrazów zawierającą ikony okienka zadań.

Uwagi

Platforma przechowuje ikony na liście obrazów. Zadania są skojarzone z ikonami przechowywanymi na tej liście.

Ta metoda kojarzy listę obrazów z kontrolką okienka zadań. Aby ustawić ikonę zadania podczas wywoływania polecenia CMFCTasksPane::AddTask, ustaw nTaskIcon odpowiedni indeks oparty na zerach na tej liście obrazów.

CMFCTasksPane::SetPageCaption

Ustawia tekst podpisu dla strony okienka zadań.

void SetPageCaption(
    int nPageIdx,
    LPCTSTR lpszName);

Parametry

nPageIdx
[in] Określa indeks na podstawie zera strony.

lpszName
[in] Określa tekst podpisu do wyświetlenia na stronie.

Uwagi

Jeśli okienko zadań ma wiele stron, domyślna strona zawiera podpis ustawiony przy użyciu tej metody.

CMFCTasksPane::SetTaskName

Ustawia nazwę zadania.

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

Parametry

nGroup
[in] Określa indeks zerowy grupy zadań.

nTask
[in] Określa indeks zerowy zadania.

lpszTaskName
[in] Określa nazwę zadania.

Wartość zwracana

WARTOŚĆ TRUE, jeśli nazwa zadania została pomyślnie ustawiona; w przeciwnym razie, FAŁSZ.

CMFCTasksPane::SetTasksHorzOffset

Ustawia przesunięcie poziome dla zadań podrzędnych.

void SetTasksHorzOffset(int n = -1);

Parametry

n
[in] Określa przesunięcie poziome.

Uwagi

Przesunięcie poziome to odległość w pikselach od lewej i prawej krawędzi grupy.

Jeśli n ma wartość -1, ta metoda ustawia przesunięcie poziome na wartość zwracaną przez metodę CMFCVisualManager::GetTasksPaneTaskHorzOffset .

Domyślne przesunięcie poziome to 12 pikseli.

CMFCTasksPane::SetTasksIconHorzOffset

void SetTasksIconHorzOffset(int n = -1);

Parametry

[in] n

Uwagi

CMFCTasksPane::SetTasksIconVertOffset

void SetTasksIconVertOffset(int n = -1);

Parametry

[in] n

Uwagi

CMFCTasksPane::SetTaskTextColor

Ustawia kolor tekstu zadania.

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

Parametry

nGroup
[in] Określa indeks zerowy grupy zadań, która zawiera zadanie.

nTask
[in] Określa indeks zerowy zadania.

Kolor
[in] Określa kolor tekstu zadania.

colorHot
[in] Określa kolor tekstu dla wyróżnionej grupy. Jeśli wartość -1, ta metoda używa domyślnego koloru wyróżnienia.

Wartość zwracana

WARTOŚĆ TRUE, jeśli kolor tekstu zadania został pomyślnie ustawiony; w przeciwnym razie, FAŁSZ.

CMFCTasksPane::SetVertMargin

Ustawia margines pionowy.

void SetVertMargin(int n = -1);

Parametry

n
[in] Określa margines pionowy do ustawienia.

Uwagi

Margines pionowy to odległość między okienkiem zadań a pionowymi krawędziami obszaru klienta.

Jeśli n ma wartość -1, struktura określa wartość marginesu przy użyciu menedżera wizualizacji (CMFCVisualManager::GetTasksPaneVertMargin). Domyślny margines to 12 pikseli.

CMFCTasksPane::SetWindowHeight

Ustawia wysokość kontrolki okna.

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

BOOL SetWindowHeight(
    HWND hwndTask,
    int nWndHeight);

Parametry

nGroup
[in] Określa indeks zerowy grupy zawierającej kontrolkę okna.

hwndTask
[in] Określa dojście do kontrolki okna.

nWndHeight
[in] Określa wysokość do ustawienia.

Wartość zwracana

WARTOŚĆ TRUE, jeśli wysokość kontrolki okna została pomyślnie ustawiona; FAŁSZ, jeśli grupa nGroup jest nieprawidłowa lub jeśli hwndTask nie istnieje.

Uwagi

Wywołaj polecenie CMFCTasksPane::AddWindow , aby dodać zadania z kontrolkami okien.

CMFCTasksPane::ShowCommandMessageString

virtual void ShowCommandMessageString(UINT uiCmdId);

Parametry

[in] uiCmdId

Uwagi

CMFCTasksPane::ShowTask

Pokazuje lub ukrywa zadanie.

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

Parametry

nGroup
[in] Określa indeks zerowy grupy.

nTask
[in] Określa indeks zerowy zadania do pokazania lub ukrycia.

bShow
[in] WARTOŚĆ TRUE, aby wyświetlić zadanie; FAŁSZ, aby ukryć zadanie.

bRedraw
[in] WARTOŚĆ TRUE, aby ponownie wyrysować okienko zadań; w przeciwnym razie, FAŁSZ.

Wartość zwracana

Wartość TRUE, jeśli zadanie zostało pomyślnie wyświetlone lub ukryte; FAŁSZ, jeśli określona grupa lub zadanie nie istnieje.

Uwagi

Użyj polecenia CMFCTasksPane::ShowTaskByCmdId , aby pokazać lub ukryć zadanie na podstawie jego identyfikatora polecenia.

CMFCTasksPane::ShowTaskByCmdId

Wyświetla lub ukrywa zadanie na podstawie jego identyfikatora polecenia.

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

Parametry

uiCommandID
[in] Określa identyfikator polecenia zadania do pokazania lub ukrycia.

bShow
[in] WARTOŚĆ TRUE, aby wyświetlić zadanie; FAŁSZ, aby ukryć zadanie.

bRedraw
[in] WARTOŚĆ TRUE, aby ponownie wyrysować okienko zadań; w przeciwnym razie, FAŁSZ.

Wartość zwracana

Wartość TRUE, jeśli zadanie zostało pomyślnie wyświetlone lub ukryte; FAŁSZ, jeśli zadanie o określonym identyfikatorze polecenia nie istnieje.

Uwagi

Użyj polecenia CMFCTasksPane::ShowTask , aby pokazać lub ukryć zadanie na podstawie jego identyfikatora polecenia.

CMFCTasksPane::Update

Odświeża wszystkie kontrolki w okienku zadań.

virtual void Update();

Uwagi

Ta metoda aktualizuje podpis okienka zadań, dostosowuje pasek przewijania, zmienia położenie wszystkich zadań i ponownie rysuje wszystkie kontrolki okienka zadań.

Zastąp tę metodę w klasie pochodnej, aby wykonać kod niestandardowy, gdy struktura odświeża okienko zadań.

Zobacz też

Wykres hierarchii
Klasy
Klasa CMFCTasksPaneTaskGroup
Klasa CMFCTasksPaneTask
Klasa CMFCOutlookBar
Klasa CMFCVisualManager

Udostępnij za pośrednictwem

Klasa CMFCTasksPane

Składnia

Elementy członkowskie

Konstruktory publiczne

Metody publiczne

Metody chronione

Uwagi

Przykład

Hierarchia dziedziczenia

Wymagania

CMFCTasksPane::AddGroup

Parametry

Wartość zwracana

Uwagi

CMFCTasksPane::AddLabel

Parametry

Wartość zwracana

Uwagi

CMFCTasksPane::AddMRUFilesList

Parametry

Wartość zwracana

CMFCTasksPane::AddPage

Parametry

Wartość zwracana

CMFCTasksPane::AddSeparator

Parametry

Wartość zwracana

Uwagi

CMFCTasksPane::AddTask

Parametry

Wartość zwracana

CMFCTasksPane::AddWindow

Parametry

Wartość zwracana

Uwagi

CMFCTasksPane::CMFCTasksPane

CMFCTasksPane::CollapseAllGroups

Parametry

Uwagi

CMFCTasksPane::CollapseGroup

Parametry

Wartość zwracana

Uwagi

CMFCTasksPane::CreateDefaultMiniframe

Parametry

Wartość zwracana

Uwagi

CMFCTasksPane::CreateMenu

Wartość zwracana

Uwagi

CMFCTasksPane::EnableAnimation

Parametry

Uwagi

CMFCTasksPane::EnableGroupCollapse

Parametry

Uwagi

CMFCTasksPane::EnableHistoryMenuButtons

Parametry

Uwagi

CMFCTasksPane::EnableNavigationToolbar

Parametry

Uwagi

CMFCTasksPane::EnableOffsetCustomControls

Parametry

Uwagi

CMFCTasksPane::EnableScrollButtons

Parametry

Uwagi

CMFCTasksPane::EnableWrapLabels

Parametry

Uwagi

CMFCTasksPane::EnableWrapTasks

Parametry

Uwagi

CMFCTasksPane::GetActivePage

Wartość zwracana

CMFCTasksPane::GetGroupCaptionHeight

Wartość zwracana

CMFCTasksPane::GetGroupCaptionHorzOffset