Klasa CMFCTasksPane
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
Członkowie
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 grupy. |
| CMFCTasksPane::GetGroupCaptionHorzOffset | Zwraca bieżące przesunięcie grupy podpis od lewej i prawej krawędzi okienka zadań. |
| CMFCTasksPane::GetGroupCaptionVertOffset | Zwraca bieżące przesunięcie grupy podpis od góry 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 podpis nazwę okienka zadań. |
| CMFCTasksPane::SetGroupCaptionHeight | Ustawia wysokość podpis grupy. |
| CMFCTasksPane::SetGroupCaptionHorzOffset | Ustawia przesunięcie poziome podpis grupy. |
| CMFCTasksPane::SetGroupCaptionVertOffset | Ustawia przesunięcie w pionie podpis grupy. |
| CMFCTasksPane::SetGroupName | Ustawia nazwę grupy. |
| CMFCTasksPane::SetGroupTextColor | Ustawia kolor tekstu dla podpis 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 podpis 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 | Aktualizacje elementów graficznego interfejsu użytkownika należących 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żde grupowanie 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:
CMFCTasksPaneOsadź 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 . W celu uzyskania więcej informacji, zobacz następujący temat: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 podpis, a ostatnie zadanie w grupie jest prostą etykietą:
Wygląd okienka zadań można dostosować, dostosowując różne marginesy i przesunięcia. Poniższa ilustracja wyjaśnia znaczenie tych zmiennych:
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ć podpis nazwę okienka zadań, ustawić kolor tekstu dla grupy podpis i ustawić 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
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 podpis 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
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ę pokazuje 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 podpis 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ść podpis grupy.
int GetGroupCaptionHeight() const;
Wartość zwracana
Wysokość grupy podpis w pikselach.
CMFCTasksPane::GetGroupCaptionHorzOffset
Zwraca przesunięcie poziome podpis grupy.
int GetGroupCaptionHorzOffset() const;
Wartość zwracana
Przesunięcie poziome grupy podpis. Przesunięcie poziome to odległość w pikselach od lewej lub prawej krawędzi okienka zadań.
CMFCTasksPane::GetGroupCaptionVertOffset
Zwraca przesunięcie pionowe podpis grupy.
int GetGroupCaptionVertOffset() const;
Wartość zwracana
Przesunięcie w pionie grupy podpis od góry 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] 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] 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 podpis nazwę okienka zadań.
void SetCaption(LPCTSTR lpszName);
Parametry
Lpszname
[in] Określa nazwę podpis.
Uwagi
Jeśli okienko zadań ma wiele stron, domyślna strona zawiera podpis, które zostały ustawione przy użyciu tej funkcji.
CMFCTasksPane::SetGroupCaptionHeight
Ustawia wysokość podpis grupy.
void SetGroupCaptionHeight(int n = -1);
Parametry
N
[in] Określa wysokość podpis.
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ść podpis wynosi 25 pikseli.
CMFCTasksPane::SetGroupCaptionHorzOffset
Ustawia przesunięcie poziome podpis grupy.
void SetGroupCaptionHorzOffset(int n = -1);
Parametry
N
[in] Określa przesunięcie poziome podpis grupy.
CMFCTasksPane::SetGroupCaptionVertOffset
Ustawia przesunięcie w pionie podpis grupy.
void SetGroupCaptionVertOffset(int n = -1);
Parametry
N
[in] Określa przesunięcie pionowe w pikselach grupy podpis.
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 podpis 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 podpis 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 podpis do wyświetlenia na stronie.
Uwagi
Jeśli okienko zadań ma wiele stron, domyślna strona zawiera podpis, które zostały ustawione 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 okienko zadań podpis, 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
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla