CMFCTasksPane 클래스
더 자세한 내용은 Visual Studio 설치의 VC\atlmfc\src\mfc 폴더에 있는 소스 코드를 참조하세요.
CMFCTasksPane 클래스는 클릭할 수 있는 항목(작업) 목록을 구현합니다.
구문
class CMFCTasksPane : public CDockablePane
멤버
공용 생성자
| 속성 | 설명 |
|---|---|
| CMFCTasksPane::CMFCTasksPane | CMFCTasksPane 개체를 생성합니다. |
공용 메서드
보호된 메서드
| 속성 | 설명 |
|---|---|
| CMFCTasksPane::OnActivateTasksPanePage | 새 작업 창 페이지가 활성화될 때 프레임워크에서 호출됩니다. |
설명
CMFCTasksPane 클래스는 다음 기능을 구현합니다.
항목을 그룹화할 수 있고 각 항목 그룹에는 연결된 캡션이 포함될 수 있습니다.
항목 그룹을 축소하거나 확장할 수 있습니다.
작업 창에서 각 항목에 아이콘을 할당할 수 있습니다.
개별 항목은 사용자가 항목을 클릭할 때 실행되는 명령 ID와 연결될 수 있습니다. 클릭이 발생하면 WM_COMMAND 메시지가 작업창 컨트롤의 소유자에게 전송됩니다.
애플리케이션에서 CMFCTasksPane 컨트롤을 사용하려면 다음 단계를 수행합니다.
CMFCTasksPane개체를 주 프레임 창 클래스에 포함합니다.WM_CREATE 메시지를 처리할 때 메서드를 호출합니다
Create. 일반 CControlBar 스타일을 사용할 수 있습니다. 자세한 내용은CControlBar::Create를 참조하세요.CMFCTasksPane::AddGroup 메서드를 호출하여 다양한 그룹을 추가합니다.
CMFCTasksPane::AddTask, CMFCTasksPane::AddLabel 또는 CMFCTasksPane::AddMRUFilesList 멤버 함수를 호출하여 각 그룹에 새 항목(작업)을 추가합니다.
CMFCTasksPane::EnableGroupCollapse를 호출하여 항목 그룹을 축소할 수 있는지 여부를 지정합니다.
다음 그림에서는 일반적인 작업 창 컨트롤을 보여 줍니다. 첫 번째 그룹은 특수 그룹이며 캡션은 더 어두운 색입니다. 세 번째 그룹이 축소됩니다. 마지막 그룹은 작업 창의 아래쪽에 맞춰지고 캡션을 포함하지 않고, 그룹의 마지막 작업은 단순한 레이블입니다.
다양한 여백 및 오프셋을 조정하여 작업 창의 모양을 사용자 지정할 수 있습니다. 다음 그림에서는 이들 변수의 의미를 분명히 설명합니다.
예시
다음 예제에서는 CMFCTasksPane 개체를 생성하고 CMFCTasksPane 클래스에서 다양한 메서드를 사용하는 방법을 보여 줍니다. 이 예제에서는 작업 그룹의 축소를 사용하도록 설정하고, 다음 및 이전 탐색 단추에서 드롭다운 메뉴를 사용하도록 설정하고, 스크롤 막대 대신 스크롤 단추를 사용하도록 설정하고, 레이블로 텍스트에 대한 단어 줄 바꿈을 사용하도록 설정하고, 작업창의 캡션 이름을 설정하고, 그룹 캡션의 텍스트 색을 설정하는 방법을 보여 줍니다. 가로 및 세로 여백을 설정합니다.
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();
상속 계층 구조
CObject
└ CCmdTarget
└ CWnd
└ CBasePane
└ CPane
└ CDockablePane
└ CMFCTasksPane
요구 사항
헤더: afxTasksPane.h
CMFCTasksPane::AddGroup
작업 창 컨트롤에 새 작업 그룹을 추가합니다.
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);
매개 변수
nPageIdx
[in] 0부터 시작하는 페이지 인덱스를 지정합니다.
lpszGroupName
[in] 그룹 이름을 지정합니다.
bBottomLocation
[in] TRUE이면 작업창 컨트롤의 맨 아래에 그룹을 만듭니다. 그렇지 않으면 FALSE입니다.
bSpecial
[in] 이 그룹을 특수 그룹으로 표시하려면 TRUE입니다. 그렇지 않으면 FALSE입니다. 특수 그룹에 대한 자세한 내용은 의 설명 섹션 CMFCTasksPane을 참조하세요.
hIcon
[in] 그룹 캡션에 표시할 아이콘을 지정합니다.
Return Value
클래스가 유지 관리하는 그룹의 내부 목록에 있는 그룹의 인덱스(0부터 시작하는 인덱스)입니다.
설명
작업 그룹을 만들고 해당 그룹을 작업창 컨트롤에 추가하려면 이 메서드를 호출합니다.
프레임워크는 작업창 컨트롤의 맨 위 또는 아래쪽에 작업 그룹을 표시합니다. 프레임워크는 아래쪽에 하나의 그룹만 표시할 수 있습니다. 이 그룹을 마지막으로 추가해야 합니다.
CMFCTasksPane::AddLabel
지정된 작업 그룹에 레이블을 추가합니다.
int AddLabel(
int nGroup,
LPCTSTR lpszLabelName,
int nTaskIcon = -1,
BOOL bIsBold = FALSE);
매개 변수
nGroup
[in] 레이블이 추가되는 그룹의 인덱스를 지정합니다.
lpszLabelName
[in] 레이블의 이름을 지정합니다.
nTaskIcon
[in] 레이블 옆에 표시할 아이콘을 지정합니다. 프레임워크는 이미지 목록에 아이콘을 저장합니다. 이 매개 변수는 해당 목록의 인덱스입니다.
bIsBold
[in] TRUE이면 레이블을 굵은 텍스트로 표시합니다. 그렇지 않으면 FALSE입니다.
Return Value
레이블이 추가된 그룹의 인덱스(0부터 시작하는 인덱스)이거나 nGroup에서 지정한 그룹이 없으면 -1입니다.
설명
프레임워크는 태스크와 레이블을 다르게 처리합니다. 사용자가 작업을 클릭하면 프레임워크가 명령을 실행합니다. 사용자가 레이블을 클릭하면 명령이 실행되지 않습니다. 자세한 내용은 CMFCTasksPane::AddTask를 참조하세요.
CMFCTasksPane::AddMRUFilesList
MRU(가장 최근에 사용한 파일) 파일 목록에 저장된 각 파일에 대한 작업을 그룹에 추가합니다.
int AddMRUFilesList(
int nGroup,
int nMaxFiles = 4);
매개 변수
nGroup
[in] 그룹의 인덱스를 지정합니다. 이 메서드는 이 매개 변수로 지정된 그룹에 MRU 파일 목록을 추가합니다.
nMaxFiles
[in] MRU 파일 목록에 표시할 파일 수를 지정합니다.
Return Value
MRU 파일 목록이 추가된 그룹의 인덱스(0부터 시작하는 인덱스)이거나 nGroup에서 지정한 그룹이 없는 경우 -1입니다.
CMFCTasksPane::AddPage
작업창에 페이지를 추가합니다.
int AddPage(LPCTSTR lpszPageLabel);
매개 변수
lpszPageLabel
[in] 페이지의 레이블을 지정합니다.
Return Value
새 페이지의 인덱스(0부터 시작하는 인덱스)입니다.
CMFCTasksPane::AddSeparator
int AddSeparator(int nGroup);
매개 변수
[in] nGroup
Return Value
설명
CMFCTasksPane::AddTask
지정된 작업 그룹에 작업을 추가합니다.
int AddTask(
int nGroup,
LPCTSTR lpszTaskName,
int nTaskIcon = -1,
UINT uiCommandID = 0,
DWORD dwUserData = 0);
매개 변수
nGroup
[in] 작업이 추가되는 그룹 인덱스를 지정합니다.
lpszTaskName
[in] 작업의 이름을 지정합니다.
nTaskIcon
[in] 작업 옆에 표시할 아이콘을 지정합니다. 프레임워크는 이미지 목록에 아이콘을 저장합니다. 이 매개 변수는 해당 목록의 인덱스입니다.
uiCommandID
[in] 사용자가 작업을 클릭할 때 실행할 명령의 명령 ID를 지정합니다. uiCommandID가 0이면 작업이 레이블로 처리됩니다.
dwUserData
[in] 작업과 연결할 사용자 정의 데이터를 지정합니다.
Return Value
작업이 추가된 그룹의 인덱스(0부터 시작하는 인덱스)이거나 nGroup에서 지정한 그룹이 없는 경우 -1입니다.
CMFCTasksPane::AddWindow
작업 창에 자식 창을 추가합니다.
int AddWindow(
int nGroup,
HWND hwndTask,
int nWndHeight,
BOOL bAutoDestroyWindow = FALSE,
DWORD dwUserData = 0);
매개 변수
nGroup
[in] 창이 추가되는 그룹 인덱스를 지정합니다.
hwndTask
[in] 추가할 창의 핸들을 지정합니다.
nWndHeight
[in] 창의 높이를 지정합니다.
bAutoDestroyWindow
[in] TRUE이면 작업이 제거될 때 창이 삭제됩니다. 그렇지 않으면 FALSE입니다.
dwUserData
[in] 작업과 연결된 사용자 정의 데이터를 지정합니다.
Return Value
창이 추가된 그룹의 인덱스(0부터 시작하는 인덱스)이거나 nGroup에서 지정한 그룹이 없으면 -1입니다.
설명
작업창에 컨트롤을 추가하려면 이 메서드를 호출합니다. 예를 들어 검색 창처럼 작동하는 편집 컨트롤을 추가할 수 있습니다.
CMFCTasksPane::CMFCTasksPane
CMFCTasksPane 개체를 생성합니다.
CMFCTasksPane();
CMFCTasksPane::CollapseAllGroups
void CollapseAllGroups(BOOL bCollapse = TRUE);
void CollapseAllGroups(
int nPageIdx,
BOOL bCollapse);
매개 변수
[in] bCollapse
[in] nPageIdx
설명
CMFCTasksPane::CollapseGroup
그룹을 축소하거나 확장합니다.
BOOL CollapseGroup(
CMFCTasksPaneTaskGroup* pGroup,
BOOL bCollapse = TRUE);
BOOL CollapseGroup(
int nGroup,
BOOL bCollapse = TRUE);
매개 변수
pGroup
[in] 축소할 그룹을 지정합니다.
bCollapse
[in] 그룹을 축소하려면 TRUE입니다. 그룹을 확장하려면 FALSE입니다.
nGroup
[in] 그룹 내부 목록에서 축소할 그룹의 인덱스(0부터 시작하는 인덱스)를 지정합니다.
Return Value
그룹이 축소되거나 확장되면 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
축소된 그룹에는 그룹 캡션만 표시됩니다. 작업 목록이 숨겨집니다.
CMFCTasksPane::CreateDefaultMiniframe
virtual CPaneFrameWnd* CreateDefaultMiniframe(CRect rectInitial);
매개 변수
[in] rectInitial
Return Value
설명
CMFCTasksPane::CreateMenu
사용자가 다른 작업 창 메뉴 단추를 클릭할 때 나타나는 메뉴를 만듭니다 .
HMENU CreateMenu() const;
Return Value
새 메뉴에 대한 핸들입니다.
설명
파생 클래스에서 이 메서드를 재정의하여 작업창의 메뉴를 사용자 지정합니다.
이 메서드가 만드는 팝업 메뉴에는 작업창의 페이지 목록이 포함됩니다. 메뉴에는 현재 페이지 옆에 확인 표시가 표시됩니다.
CMFCTasksPane::EnableAnimation
작업 그룹이 확장되거나 축소되는 경우 발생하는 애니메이션을 사용하거나 사용하지 않도록 설정합니다.
void EnableAnimation(BOOL bEnable = TRUE);
매개 변수
bEnable
[in] TRUE이면 작업 그룹이 확장되거나 축소되는 경우 발생하는 애니메이션을 사용할 수 있습니다. 그렇지 않으면 FALSE입니다.
설명
기본적으로 작업 그룹이 확장되거나 축소될 때 발생하는 애니메이션이 사용됩니다.
CMFCTasksPane::EnableGroupCollapse
사용자가 작업 그룹을 축소할 수 있는지 여부를 지정합니다.
void EnableGroupCollapse(BOOL bEnable);
매개 변수
bEnable
[in] 사용자가 작업 그룹을 축소할 수 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
축소된 작업 그룹에는 그룹 캡션만 표시됩니다. 작업 목록이 숨겨집니다.
CMFCTasksPane::EnableHistoryMenuButtons
다음 및 이전 탐색 단추에서 드롭다운 메뉴를 사용하도록 설정합니다.
void EnableHistoryMenuButtons(BOOL bEnable = TRUE);
매개 변수
bEnable
[in] TRUE이면 다음 및 이전 탐색 단추에서 드롭다운 메뉴를 사용하도록 설정하고, 그렇지 않으면 FALSE입니다.
설명
기본적으로 다음 및 이전 단추의 드롭다운 메뉴는 사용하지 않도록 설정됩니다.
메뉴에는 사용자가 사용한 작업 페이지의 기록이 포함되어 있습니다.
CMFCTasksPane::EnableNavigationToolbar
탐색 도구 모음을 사용하거나 사용하지 않도록 설정합니다.
void EnableNavigationToolbar(
BOOL bEnable = TRUE,
UINT uiToolbarBmpRes = 0,
CSize sizeToolbarImage = CSize(0,
0),
CSize sizeToolbarButton = CSize(0,
0));
매개 변수
bEnable
[in] 탐색 도구 모음을 사용하도록 설정하려면 TRUE입니다. 그렇지 않으면 FALSE입니다.
uiToolbarBmpRes
[in] 도구 모음에 표시할 이미지가 포함된 비트맵의 리소스 ID를 지정합니다.
sizeToolbarImage
[in] 도구 모음 이미지의 크기를 지정합니다.
sizeToolbarButton
[in] 도구 모음 단추의 크기를 지정합니다.
설명
탐색 도구 모음은 프레임워크가 작업창의 맨 위에 표시하는 도구 모음입니다. 탐색 도구 모음에는 뒤로, 앞으로 및 홈 탐색 단추와 사용 가능한 페이지 목록이 포함된 메뉴 단추가 포함되어 있습니다.
기본적으로 프레임워크는 탐색 도구 모음을 표시하지 않습니다. 탐색 도구 모음이 표시되지 않으면 탐색 단추가 도킹 막대의 캡션에 있습니다.
CMFCTasksPane::EnableOffsetCustomControls
void EnableOffsetCustomControls(BOOL bEnable);
매개 변수
[in] bEnable
설명
CMFCTasksPane::EnableScrollButtons
스크롤 막대 대신 스크롤 단추를 사용하도록 설정합니다.
void EnableScrollButtons(BOOL bEnable = TRUE);
매개 변수
bEnable
[in] TRUE이면 스크롤 막대 대신 작업창에 스크롤 단추를 표시합니다. 그렇지 않으면 FALSE입니다.
설명
기본적으로 프레임워크는 작업창에 스크롤 단추를 표시합니다.
CMFCTasksPane::EnableWrapLabels
레이블의 텍스트에 대한 단어 줄 바꿈을 사용하거나 사용하지 않도록 설정합니다.
void EnableWrapLabels(BOOL bEnable = TRUE);
매개 변수
bEnable
[in] TRUE이면 작업창에 표시되는 레이블로 텍스트를 래핑합니다. 그렇지 않으면 FALSE입니다.
설명
기본적으로 프레임워크는 텍스트를 레이블로 래핑하지 않습니다. 단어 줄 바꿈을 사용하도록 설정하면 레이블의 텍스트가 여러 줄에 나타날 수 있습니다. 레이블에는 밑줄 표식과 같은 \n 줄 바꿈 표 &식이 포함될 수 있습니다.
CMFCTasksPane::EnableWrapTasks
작업에서 텍스트에 대한 단어 줄 바꿈을 사용하거나 사용하지 않도록 설정합니다.
void EnableWrapTasks(BOOL bEnable = TRUE);
매개 변수
bEnable
[in] TRUE이면 작업창에서 작업을 래핑합니다. 그렇지 않으면 FALSE입니다.
설명
기본적으로 작업에 대한 단어 줄 바꿈은 사용하지 않도록 설정됩니다.
CMFCTasksPane::GetActivePage
활성 페이지에 대한 0부터 시작하는 인덱스를 반환합니다.
int GetActivePage() const;
Return Value
활성 페이지의 인덱스(0부터 시작하는 인덱스)입니다.
CMFCTasksPane::GetGroupCaptionHeight
그룹 캡션의 높이를 반환합니다.
int GetGroupCaptionHeight() const;
Return Value
그룹 캡션의 높이(픽셀)입니다.
CMFCTasksPane::GetGroupCaptionHorzOffset
그룹 캡션의 가로 오프셋을 반환합니다.
int GetGroupCaptionHorzOffset() const;
Return Value
그룹 캡션의 가로 오프셋입니다. 가로 오프셋은 작업창의 왼쪽 또는 오른쪽 가장자리에서 픽셀 단위의 거리입니다.
CMFCTasksPane::GetGroupCaptionVertOffset
그룹 캡션의 세로 오프셋을 반환합니다.
int GetGroupCaptionVertOffset() const;
Return Value
작업창의 위쪽 및 아래쪽 가장자리에서 그룹 캡션의 세로 오프셋입니다.
설명
세로 오프셋의 기본값은 7픽셀입니다.
CMFCTasksPane::GetGroupCount
총 그룹 수를 반환합니다.
int GetGroupCount() const;
Return Value
작업창의 총 그룹 수입니다.
CMFCTasksPane::GetGroupLocation
지정된 그룹에 대한 내부 그룹 인덱스 반환
BOOL GetGroupLocation(
CMFCTasksPaneTaskGroup* pGroup,
int& nGroup) const;
매개 변수
pGroup
[in] 위치가 검색되는 작업 그룹을 지정합니다.
nGroup
[out] 작업 그룹의 인덱스(0부터 시작하는 인덱스)를 포함합니다.
Return Value
작업 그룹을 찾았으면 TRUE입니다. 그렇지 않으면 FALSE입니다.
CMFCTasksPane::GetGroupVertOffset
그룹의 세로 오프셋을 반환합니다.
int GetGroupVertOffset() const;
Return Value
그룹의 세로 오프셋(픽셀)입니다.
CMFCTasksPane::GetHorzMargin
작업창과 클라이언트 영역 가장자리 사이의 가로 간격을 반환합니다.
int GetHorzMargin() const;
Return Value
작업창과 클라이언트 영역 가장자리 사이의 가로 간격입니다.
설명
작업창과 클라이언트 영역 가장자리 사이의 기본 간격은 12픽셀입니다.
CMFCTasksPane::GetNextPages
void GetNextPages(CStringList& lstNextPages) const;
매개 변수
[in] lstNextPages
설명
CMFCTasksPane::GetPageByGroup
지정된 그룹에 대한 페이지 인덱스를 검색합니다.
BOOL GetPageByGroup(
int nGroup,
int& nPage) const;
매개 변수
nGroup
[in] 작업 그룹의 인덱스(0부터 시작하는 인덱스)를 지정합니다.
nPage
[out] 지정된 그룹의 페이지 인덱스를 포함합니다. 작업 그룹에 기본 페이지만 포함된 경우 반환된 값은 0입니다.
Return Value
nGroup 그룹이 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.
CMFCTasksPane::GetPagesCount
페이지 수를 반환합니다.
int GetPagesCount() const;
Return Value
작업창의 페이지 수입니다.
CMFCTasksPane::GetPreviousPages
void GetPreviousPages(CStringList& lstPrevPages) const;
매개 변수
[in] lstPrevPages
설명
CMFCTasksPane::GetScrollBarCtrl
virtual CScrollBar* GetScrollBarCtrl(int nBar) const;
매개 변수
[in] nBar
Return Value
설명
CMFCTasksPane::GetTask
작업을 검색합니다.
CMFCTasksPaneTask* GetTask(
int nGroup,
int nTask) const;
매개 변수
nGroup
[in] 작업을 포함하는 그룹의 인덱스(0부터 시작하는 인덱스)를 지정합니다.
nTask
[in] nGroup으로 지정된 목록에 있는 작업의 인덱스(0부터 시작하는 인덱스)를 지정합니다.
Return Value
지정된 인덱스에서의 작업입니다.
CMFCTasksPane::GetTaskCount
지정된 그룹의 작업 수를 반환합니다.
int GetTaskCount(int nGroup) const;
매개 변수
nGroup
[in] 작업 그룹의 인덱스를 지정합니다.
Return Value
지정된 그룹의 작업 수이거나 nGroup이 잘못된 경우 0입니다.
CMFCTasksPane::GetTaskGroup
지정된 그룹 인덱스 작업 그룹을 반환합니다.
CMFCTasksPaneTaskGroup* GetTaskGroup(int nGroup) const;
매개 변수
nGroup
[in] 검색할 그룹의 인덱스(0부터 시작하는 인덱스)를 지정합니다.
Return Value
지정된 인덱스에서 작업 그룹입니다.
CMFCTasksPane::GetTaskLocation
지정한 작업의 그룹 및 인덱스 값을 반환합니다.
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;
매개 변수
uiCommandID
[in] 찾을 작업의 명령 ID를 지정합니다.
nGroup
[out] 작업의 그룹 인덱스를 포함합니다.
nTask
[out] 작업 그룹에 있는 작업의 인덱스를 포함합니다.
hwndTask
[in] 작업과 연결된 창을 지정합니다.
pTask
[in] 찾을 작업을 지정합니다.
Return Value
작업 위치를 찾았으면 TRUE입니다. 지정한 작업이 없으면 FALSE입니다.
설명
이 메서드는 지정된 작업에 대한 그룹 인덱스 및 작업 인덱스를 검색합니다. 메서드가 FALSE 를 반환하면 nGroup 및 nTask 가 -1로 설정됩니다.
CMFCTasksPane::GetTasksHorzOffset
작업의 가로 오프셋을 반환합니다.
int GetTasksHorzOffset() const;
Return Value
부모 그룹의 왼쪽 및 오른쪽 가장자리에서 작업의 가로 오프셋입니다.
설명
작업의 기본 가로 오프셋은 12픽셀입니다.
CMFCTasksPane::GetTasksIconHorzOffset
int GetTasksIconHorzOffset() const;
Return Value
설명
CMFCTasksPane::GetTasksIconVertOffset
int GetTasksIconVertOffset() const;
Return Value
설명
CMFCTasksPane::GetVertMargin
작업창과 클라이언트 영역의 가장자리 사이의 세로 여백을 반환합니다.
int GetVertMargin() const;
Return Value
작업창과 클라이언트 영역의 가장자리 사이의 세로 여백입니다.
설명
세로 여백은 작업창과 클라이언트 영역의 가장자리 사이의 공간입니다. 세로 여백의 기본값은 12픽셀입니다.
CMFCTasksPane::IsAccessibilityCompatible
virtual BOOL IsAccessibilityCompatible();
Return Value
설명
CMFCTasksPane::IsAnimationEnabled
애니메이션의 사용 여부를 나타냅니다.
BOOL IsAnimationEnabled() const;
Return Value
TRUE이면 사용자가 그룹을 확장하거나 축소할 때 발생하는 애니메이션을 사용할 수 있습니다. 그렇지 않으면 FALSE입니다.
설명
CMFCTasksPane::EnableAnimation을 호출하여 애니메이션을 사용하거나 사용하지 않도록 설정합니다.
CMFCTasksPane::IsBackButtonEnabled
뒤로 단추의 사용 여부를 나타냅니다.
BOOL IsBackButtonEnabled() const;
Return Value
뒤로 단추가 활성화된 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
사용자가 뒤로 단추를 클릭하면 프레임워크에 이전 작업 페이지가 표시됩니다.
CMFCTasksPane::IsForwardButtonEnabled
앞으로 단추의 사용 여부를 나타냅니다.
BOOL IsForwardButtonEnabled() const;
Return Value
정방향 단추를 사용하는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
앞으로 단추를 사용하면 작업 페이지의 기록에서 앞으로 탐색할 수 있습니다.
CMFCTasksPane::IsGroupCollapseEnabled
BOOL IsGroupCollapseEnabled() const;
Return Value
설명
CMFCTasksPane::IsHistoryMenuButtonsEnabled
다음 및 이전 탐색 단추에 드롭다운 메뉴가 있는지 여부를 나타냅니다.
BOOL IsHistoryMenuButtonsEnabled() const;
Return Value
다음 및 이전 탐색 단추에 드롭다운 메뉴가 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.
CMFCTasksPane::IsNavigationToolbarEnabled
탐색 도구 모음이 사용되는지를 나타냅니다.
BOOL IsNavigationToolbarEnabled() const;
Return Value
탐색 도구 모음을 사용하는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
CMFCTasksPane::IsToolBox
virtual BOOL IsToolBox() const;
Return Value
설명
CMFCTasksPane::IsWrapLabelsEnabled
작업 창의 레이블이 자동 줄 바꿈되는지를 나타냅니다.
BOOL IsWrapLabelsEnabled() const;
Return Value
레이블의 단어가 래핑되면 TRUE이고, 그렇지 않으면 FALSE입니다.
CMFCTasksPane::IsWrapTasksEnabled
프레임워크에서 작업 문자열을 래핑할지 여부를 지정합니다.
BOOL IsWrapTasksEnabled() const;
Return Value
TRUE이면 작업 문자열이 래핑됩니다. 그렇지 않으면 FALSE입니다.
CMFCTasksPane::LoadState
virtual BOOL LoadState(
LPCTSTR lpszProfileName = NULL,
int nIndex = -1,
UINT uiID = (UINT) -1);
매개 변수
[in] lpszProfileName
[in] nIndex
[in] uiID
Return Value
설명
CMFCTasksPane::OnActivateTasksPanePage
작업창 페이지를 활성화할 때 프레임워크에서 호출됩니다.
virtual void OnActivateTasksPanePage();
설명
파생 클래스에서 이 메서드를 재정의하여 작업창 페이지의 모양을 사용자 지정합니다.
CMFCTasksPane::OnCancel
virtual void OnCancel();
설명
CMFCTasksPane::OnClickTask
사용자가 작업 창에서 항목을 클릭하면 프레임워크에서 호출됩니다.
virtual void OnClickTask(
int nGroupNumber,
int nTaskNumber,
UINT uiCommandID,
DWORD dwUserData);
매개 변수
nGroupNumber
[in] 클릭한 작업이 포함된 그룹의 인덱스(0부터 시작)를 지정합니다.
nTaskNumber
[in] 클릭한 작업의 인덱스(0부터 시작)를 지정합니다.
uiCommandID
[in] 작업과 연결된 명령 ID를 지정합니다.
dwUserData
[in] 클릭한 작업과 연결된 사용자 정의 데이터를 포함합니다.
설명
프레임워크는 사용자가 작업을 클릭할 때 이 메서드를 호출합니다. 기본적으로 프레임워크는 클릭한 작업과 연결된 명령 ID를 확인하고 0이 아닌 경우 작업창 컨트롤의 소유자에게 WM_COMMAND 메시지를 보냅니다.
작업을 클릭할 때 사용자 지정 코드를 실행하도록 파생 클래스에서 이 메서드를 재정의합니다.
CMFCTasksPane::OnOK
virtual void OnOK();
설명
CMFCTasksPane::OnPressBackButton
사용자가 뒤로 단추를 클릭하면 프레임워크에서 호출됩니다.
virtual void OnPressBackButton();
설명
기본적으로 프레임워크는 이전에 본 페이지를 표시합니다.
사용자가 뒤로 단추를 클릭할 때 사용자 지정 코드를 실행하도록 파생 클래스에서 이 메서드를 재정의합니다.
CMFCTasksPane::OnPressForwardButton
사용자가 앞으로 탐색 단추를 클릭하면 프레임워크에서 호출됩니다.
virtual void OnPressForwardButton();
설명
기본적으로 프레임워크는 뒤로 단추를 클릭하기 전에 사용자가 본 페이지를 표시합니다.
사용자가 앞으로 단추를 클릭할 때 사용자 지정 코드를 실행하도록 파생 클래스에서 이 메서드를 재정의합니다.
CMFCTasksPane::OnPressHomeButton
사용자가 홈 탐색 단추를 클릭할 때 프레임워크에서 호출됩니다.
virtual void OnPressHomeButton();
설명
기본적으로 프레임워크는 작업 그룹의 기본 페이지를 표시합니다.
사용자가 홈 탐색 단추를 클릭할 때 사용자 지정 코드를 실행하도록 파생 클래스에서 이 메서드를 재정의합니다.
CMFCTasksPane::OnPressOtherButton
virtual void OnPressOtherButton(
CMFCCaptionMenuButton* pbtn,
CWnd* pWndOwner);
매개 변수
[in] pbtn
[in] pWndOwner
설명
CMFCTasksPane::OnSetAccData
virtual BOOL OnSetAccData(long lVal);
매개 변수
[in] lVal
Return Value
설명
CMFCTasksPane::OnUpdateCmdUI
virtual void OnUpdateCmdUI(
CFrameWnd* pTarget,
BOOL bDisableIfNoHndler);
매개 변수
[in] pTarget
[in] bDisableIfNoHndler
설명
CMFCTasksPane::P reTranslateMessage
virtual BOOL PreTranslateMessage(MSG* pMsg);
매개 변수
[in] pMsg
Return Value
설명
CMFCTasksPane::RecalcLayout
void RecalcLayout(BOOL bRedraw = TRUE);
매개 변수
[in] bRedraw
설명
CMFCTasksPane::RemoveAllGroups
지정된 페이지에서 모든 그룹을 제거합니다.
void RemoveAllGroups(int nPageIdx = 0);
매개 변수
nPageIdx
[in] 페이지의 인덱스(0부터 시작하는 인덱스)를 지정합니다.
설명
nPageIdx로 지정된 페이지의 모든 그룹 또는 기본 페이지만 있는 경우 모든 그룹을 제거합니다.
CMFCTasksPane::RemoveAllPages
기본(첫 번째) 페이지를 제외한 모든 페이지를 작업 창에서 제거합니다.
void RemoveAllPages();
CMFCTasksPane::RemoveAllTasks
지정된 그룹에서 모든 작업을 제거합니다.
void RemoveAllTasks(int nGroup);
매개 변수
nGroup
[in] 그룹의 인덱스(0부터 시작하는 인덱스)를 지정합니다.
CMFCTasksPane::RemoveGroup
그룹을 제거합니다.
void RemoveGroup(int nGroup);
매개 변수
nGroup
[in] 제거할 그룹의 인덱스(0부터 시작하는 인덱스)를 지정합니다.
설명
이 메서드는 단일 그룹을 제거합니다. 모든 그룹을 제거하려면 CMFCTasksPane::RemoveAllGroups를 대신 호출 합니다 .
프레임워크에서 그룹을 제거하면 연결된 모든 작업 및 사용자 창이 제거됩니다.
CMFCTasksPane::RemovePage
작업 창에서 지정된 페이지를 제거합니다.
void RemovePage(int nPageIdx);
매개 변수
nPageIdx
[in] 제거할 페이지의 인덱스(0부터 시작하는 인덱스)를 지정합니다.
CMFCTasksPane::RemoveTask
작업 그룹에서 작업을 제거합니다.
BOOL RemoveTask(
int nGroup,
int nTask,
BOOL bRedraw = TRUE);
매개 변수
nGroup
[in] 제거할 작업이 포함된 작업 그룹의 인덱스(0부터 시작하는 인덱스)를 지정합니다.
nTask
[in] 제거할 작업의 인덱스(0부터 시작하는 인덱스)를 지정합니다.
bRedraw
[in] TRUE이면 작업창을 다시 그릴 수 있습니다. 그렇지 않으면 FALSE입니다.
Return Value
함수가 성공하면 TRUE입니다. nGroup 또는 nTask가 잘못된 경우 FALSE입니다.
CMFCTasksPane::SaveState
virtual BOOL SaveState(
LPCTSTR lpszProfileName = NULL,
int nIndex = -1,
UINT uiID = (UINT) -1);
매개 변수
[in] lpszProfileName
[in] nIndex
[in] uiID
Return Value
설명
CMFCTasksPane::Serialize
virtual void Serialize(CArchive& ar);
매개 변수
[in] ar
설명
CMFCTasksPane::SetActivePage
작업창에서 지정한 페이지를 활성화합니다.
void SetActivePage(int nPageIdx);
매개 변수
nPageIdx
[in] 표시할 페이지의 인덱스(0부터 시작하는 인덱스)를 지정합니다.
설명
이 메서드는 nPageIdx가 잘못된 경우 어설션합니다.
CMFCTasksPane::SetCaption
작업 창의 캡션 이름을 설정합니다.
void SetCaption(LPCTSTR lpszName);
매개 변수
lpszName
[in] 캡션 이름을 지정합니다.
설명
작업창에 여러 페이지가 있는 경우 기본 페이지에는 이 함수를 사용하여 설정된 캡션이 있습니다.
CMFCTasksPane::SetGroupCaptionHeight
그룹 캡션의 높이를 설정합니다.
void SetGroupCaptionHeight(int n = -1);
매개 변수
n
[in] 캡션 높이를 지정합니다.
설명
작업창 요소의 여백을 사용자 지정하려면 이 메서드를 호출합니다.
n이 -1이면 프레임워크는 시각적 관리자(CMFCVisualManager::GetTasksPaneGroupCaptionHeight)를 사용하여 여백 값을 결정합니다. 기본 캡션 높이는 25픽셀입니다.
CMFCTasksPane::SetGroupCaptionHorzOffset
그룹 캡션의 가로 오프셋을 설정합니다.
void SetGroupCaptionHorzOffset(int n = -1);
매개 변수
n
[in] 그룹 캡션의 가로 오프셋을 지정합니다.
CMFCTasksPane::SetGroupCaptionVertOffset
그룹 캡션의 세로 오프셋을 설정합니다.
void SetGroupCaptionVertOffset(int n = -1);
매개 변수
n
[in] 그룹 캡션의 세로 오프셋(픽셀)을 지정합니다.
CMFCTasksPane::SetGroupName
그룹 이름을 설정합니다.
BOOL SetGroupName(
int nGroup,
LPCTSTR lpszGroupName);
매개 변수
nGroup
[in] 그룹의 인덱스(0부터 시작하는 인덱스)를 지정합니다.
lpszGroupName
[in] 그룹의 이름을 지정합니다.
Return Value
그룹 이름이 성공적으로 설정되었으면 TRUE입니다. 그렇지 않으면 FALSE입니다.
CMFCTasksPane::SetGroupTextColor
그룹 캡션에 대한 텍스트 색을 설정합니다.
BOOL SetGroupTextColor(
int nGroup,
COLORREF color,
COLORREF colorHot = (COLORREF)-1);
매개 변수
nGroup
[in] 그룹의 인덱스(0부터 시작하는 인덱스)를 지정합니다.
color
[in] 텍스트 색을 지정합니다.
colorHot
[in] 강조 표시된 그룹의 텍스트 색을 지정합니다. -1이면 기본 강조 색이 사용됩니다.
Return Value
TRUE이면 그룹 텍스트 색이 변경되었습니다. 그렇지 않으면 FALSE입니다.
CMFCTasksPane::SetGroupVertOffset
그룹에 대한 세로 오프셋을 설정합니다.
void SetGroupVertOffset(int n = -1);
매개 변수
n
[in] 세로 오프셋을 지정합니다.
설명
세로 오프셋은 작업 그룹과 작업창 테두리 사이의 거리입니다.
작업창 요소의 여백을 사용자 지정하려면 이 메서드를 호출합니다. n이 -1이면 프레임워크는 시각적 관리자(CMFCVisualManager::GetTasksPaneGroupVertOffset)를 사용하여 여백 값을 결정합니다. 기본 오프셋은 15픽셀입니다.
CMFCTasksPane::SetHorzMargin
가로 여백을 설정합니다.
void SetHorzMargin(int n = -1);
매개 변수
n
[in] 여백을 픽셀 단위로 지정합니다.
설명
가로 여백은 작업창과 클라이언트 영역의 위쪽 또는 아래쪽 가장자리 사이의 거리입니다.
n이 -1이면 프레임워크가 시각적 관리자(CMFCVisualManager::GetTasksPaneHorzMargin)를 사용하여 여백 값을 결정합니다. 기본 가로 여백은 12픽셀입니다.
CMFCTasksPane::SetIconsList
이미지 목록을 설정합니다.
BOOL SetIconsList(
UINT uiImageListResID,
int cx,
COLORREF clrTransparent = RGB(255, 0, 255));
void SetIconsList(HIMAGELIST hIcons);
매개 변수
uiImageListResID
[in] 이미지 목록의 리소스 ID를 지정합니다.
cx
[in] 이미지 목록의 아이콘 크기를 지정합니다.
clrTransparent
[in] 투명한 색을 지정합니다.
hIcons
[in] 작업창의 아이콘이 포함된 이미지 목록을 지정합니다.
설명
프레임워크는 이미지 목록에 아이콘을 저장합니다. 작업은 해당 목록에 저장된 아이콘과 연결됩니다.
이 메서드는 이미지 목록을 작업창 컨트롤과 연결합니다. CMFCTasksPane::AddTask를 호출할 때 작업에 대한 아이콘을 설정하려면 이 이미지 목록에서 적절한 0부터 시작하는 인덱스로 설정합니다nTaskIcon.
CMFCTasksPane::SetPageCaption
작업 창 페이지에 대한 캡션 텍스트를 설정합니다.
void SetPageCaption(
int nPageIdx,
LPCTSTR lpszName);
매개 변수
nPageIdx
[in] 페이지의 인덱스(0부터 시작하는 인덱스)를 지정합니다.
lpszName
[in] 페이지에 표시할 캡션 텍스트를 지정합니다.
설명
작업창에 여러 페이지가 있는 경우 기본 페이지에는 이 메서드를 사용하여 설정된 캡션이 있습니다.
CMFCTasksPane::SetTaskName
작업에 대한 이름을 설정합니다.
BOOL SetTaskName(
int nGroup,
int nTask,
LPCTSTR lpszTaskName);
매개 변수
nGroup
[in] 작업 그룹의 인덱스(0부터 시작하는 인덱스)를 지정합니다.
nTask
[in] 작업의 인덱스(0부터 시작하는 인덱스)를 지정합니다.
lpszTaskName
[in] 작업 이름을 지정합니다.
Return Value
작업 이름이 성공적으로 설정되었으면 TRUE입니다. 그렇지 않으면 FALSE입니다.
CMFCTasksPane::SetTasksHorzOffset
작업의 가로 오프셋을 설정합니다.
void SetTasksHorzOffset(int n = -1);
매개 변수
n
[in] 가로 오프셋을 지정합니다.
설명
가로 오프셋은 그룹의 왼쪽 및 오른쪽 가장자리에서 픽셀 단위의 거리입니다.
n이 -1이면 이 메서드는 가로 오프셋을 메서드에서 반환된 CMFCVisualManager::GetTasksPaneTaskHorzOffset 값으로 설정합니다.
기본 가로 오프셋은 12픽셀입니다.
CMFCTasksPane::SetTasksIconHorzOffset
void SetTasksIconHorzOffset(int n = -1);
매개 변수
[in] n
설명
CMFCTasksPane::SetTasksIconVertOffset
void SetTasksIconVertOffset(int n = -1);
매개 변수
[in] n
설명
CMFCTasksPane::SetTaskTextColor
작업에 대한 텍스트 색을 설정합니다.
BOOL SetTaskTextColor(
int nGroup,
int nTask,
COLORREF color,
COLORREF colorHot = (COLORREF)-1);
매개 변수
nGroup
[in] 작업을 포함하는 작업 그룹의 인덱스(0부터 시작하는 인덱스)를 지정합니다.
nTask
[in] 작업의 인덱스(0부터 시작하는 인덱스)를 지정합니다.
color
[in] 작업의 텍스트 색을 지정합니다.
colorHot
[in] 강조 표시된 그룹의 텍스트 색을 지정합니다. -1이면 이 메서드는 기본 강조 색을 사용합니다.
Return Value
작업의 텍스트 색이 성공적으로 설정되었으면 TRUE입니다. 그렇지 않으면 FALSE입니다.
CMFCTasksPane::SetVertMargin
세로 여백을 설정합니다.
void SetVertMargin(int n = -1);
매개 변수
n
[in] 설정할 세로 여백을 지정합니다.
설명
세로 여백은 작업창과 클라이언트 영역의 세로 가장자리 사이의 거리입니다.
n이 -1이면 프레임워크는 시각적 관리자(CMFCVisualManager::GetTasksPaneVertMargin)를 사용하여 여백 값을 결정합니다. 기본 여백은 12픽셀입니다.
CMFCTasksPane::SetWindowHeight
창 컨트롤의 높이를 설정합니다.
BOOL SetWindowHeight(
int nGroup,
HWND hwndTask,
int nWndHeight);
BOOL SetWindowHeight(
HWND hwndTask,
int nWndHeight);
매개 변수
nGroup
[in] 창 컨트롤을 포함하는 그룹의 인덱스(0부터 시작하는 인덱스)를 지정합니다.
hwndTask
[in] 창 컨트롤에 대한 핸들을 지정합니다.
nWndHeight
[in] 설정할 높이를 지정합니다.
Return Value
창 컨트롤의 높이가 성공적으로 설정되었으면 TRUE입니다. nGroup이 잘못되었거나 hwndTask가 없는 경우 FALSE입니다.
설명
CMFCTasksPane::AddWindow를 호출하여 창 컨트롤이 있는 작업을 추가합니다.
CMFCTasksPane::ShowCommandMessageString
virtual void ShowCommandMessageString(UINT uiCmdId);
매개 변수
[in] uiCmdId
설명
CMFCTasksPane::ShowTask
작업을 표시하거나 숨깁니다.
BOOL ShowTask(
int nGroup,
int nTask,
BOOL bShow = TRUE,
BOOL bRedraw = TRUE);
매개 변수
nGroup
[in] 그룹의 인덱스(0부터 시작하는 인덱스)를 지정합니다.
nTask
[in] 표시하거나 숨길 작업의 인덱스(0부터 시작하는 인덱스)를 지정합니다.
bShow
[in] TRUE이면 작업을 표시합니다. 작업을 숨기려면 FALSE입니다.
bRedraw
[in] TRUE이면 작업창을 다시 그릴 수 있습니다. 그렇지 않으면 FALSE입니다.
Return Value
작업이 성공적으로 표시되거나 숨겨진 경우 TRUE입니다. 지정한 그룹 또는 작업이 없으면 FALSE입니다.
설명
CMFCTasksPane::ShowTaskByCmdId를 사용하여 명령 ID에 따라 작업을 표시하거나 숨깁니다.
CMFCTasksPane::ShowTaskByCmdId
명령 ID를 기준으로 작업을 표시하거나 숨깁니다.
BOOL ShowTaskByCmdId(
UINT uiCommandID,
BOOL bShow = TRUE,
BOOL bRedraw = TRUE);
매개 변수
uiCommandID
[in] 표시하거나 숨길 작업의 명령 ID를 지정합니다.
bShow
[in] TRUE이면 작업을 표시합니다. 작업을 숨기려면 FALSE입니다.
bRedraw
[in] TRUE이면 작업창을 다시 그릴 수 있습니다. 그렇지 않으면 FALSE입니다.
Return Value
작업이 성공적으로 표시되거나 숨겨진 경우 TRUE입니다. 지정한 명령 ID가 있는 작업이 없으면 FALSE입니다.
설명
CMFCTasksPane::ShowTask를 사용하여 명령 ID에 따라 작업을 표시하거나 숨깁니다.
CMFCTasksPane::Update
작업창에서 모든 컨트롤을 새로 고칩니다.
virtual void Update();
설명
이 메서드는 작업창 캡션을 업데이트하고, 스크롤 막대를 조정하고, 모든 작업의 위치를 변경하고, 모든 작업창 컨트롤을 다시 그리습니다.
프레임워크가 작업창을 새로 고칠 때 사용자 지정 코드를 실행하도록 파생 클래스에서 이 메서드를 재정의합니다.
참고 항목
계층 구조 차트
클래스
CMFCTasksPaneTaskGroup 클래스
CMFCTasksPaneTask 클래스
CMFCOutlookBar 클래스
CMFCVisualManager 클래스