CMFCBaseTabCtrl 클래스
탭 창의 기본 기능을 구현합니다. 더 자세한 내용은 Visual Studio 설치의 VC\atlmfc\src\mfc 폴더에 있는 소스 코드를 참조하세요.
구문
class CMFCBaseTabCtrl : public CWnd
멤버
공용 메서드
보호된 메서드
| 속성 | 설명 |
|---|---|
| CMFCBaseTabCtrl::CreateWrapper | 에서 파생되지 않은 CWnd CDockablePane에서 파생된 개체에 대한 래퍼를 만듭니다. CMFCBaseTabCtrl 개체를 도킹하려면 포함된 모든 컨트롤이 CDockablePane에서 파생되었거나 이 컨트롤에 도킹 래퍼가 있어야 합니다.SetDockingBayWrapperRTC를 사용하여 래퍼의 클래스를 설정합니다. |
데이터 멤버
| 속성 | 설명 |
|---|---|
| CMFCBaseTabCtrl::m_bActivateTabOnRightClick | 마우스 왼쪽 단추 클릭이나 마우스 오른쪽 단추 클릭 중 어느 것을 사용하여 탭을 선택할지를 지정합니다. |
| CMFCBaseTabCtrl::m_bAutoDestroyWindow | 탭에 포함된 창이 자동으로 소멸되는지 여부를 지정합니다. |
설명
CMFCBaseTabCtrl 클래스는 추상 클래스입니다. 따라서 인스턴스화할 수 없습니다. 탭 창을 만들려면 CMFCBaseTabCtrl에서 클래스를 파생해야 합니다. MFC 라이브러리에는 몇 가지 파생 클래스 예제가 있으며, 그중 두 개는 CMFCTabCtrl Class 및 CMFCOutlookBarTabCtrl Class입니다.
Visual Studio 2015부터 이 클래스는 Microsoft Active Accessibility를 지원합니다.
사용자 지정 팁
다음은 CMFCBaseTabCtrl Class 및 이 클래스에서 상속되는 클래스와 관련된 팁입니다.
분리 가능한 탭을 사용하도록 설정하는 경우 탭 창에 대한 포인터를 유지하지 마세요. 이러한 분리 가능한 탭은 동적으로 만들고 제거할 수 있습니다. 따라서 포인터가 유효하지 않게 될 수 있습니다.
사용자가 마우스를 사용해 탭 컨트롤에서 동적으로 탭을 이동할 수 있도록 탭 컨트롤을 구성할 수 있습니다. 이 기능은
CMFCBaseTabCtrl클래스에서 기본으로 제공됩니다. 이 기능을 사용하려면 CMFCBaseTabCtrl::EnableTabSwap을 호출합니다.탭 컨트롤에 탭을 추가하면 기본적으로 이 탭은 분리 가능한 상태입니다. CMFCBaseTabCtrl::AddTab을 사용하여 분리 불가능한 탭을 추가할 수도 있습니다. 매개 변수
bDetachable을FALSE로 설정하는 경우 탭을 분리할 수 없습니다. CMFCBaseTabCtrl::EnableTabDetach메서드를 호출하여 탭의 분리 가능 여부를 변경할 수도 있습니다.CWnd Class 에서 파생되는 개체를 도킹 가능한 컨트롤 막대나 도킹 가능한 탭에 배치할 수 있습니다. 전체 컨트롤을 도킹하려면
CWnd개체를 도킹 가능하도록 만들어야 합니다. 이를 위해 MFC는 래퍼 클래스를 사용합니다. 이 래퍼 클래스는 CDockablePaneAdapter Class입니다. 도킹 가능한 컨트롤 막대나 도킹 가능한 탭에 추가되는CWnd개체는CDockablePaneAdapter개체 내에 래핑됩니다.m_bEnableWrapping개체의 매개 변수CMFCBaseTablCtrl을FALSE로 설정하여 자동 래핑을 사용하지 않도록 설정할 수 있습니다. CMFCBaseTabCtrl::SetDockingBarWrapperRTC메서드를 사용하여 애플리케이션에서 래퍼로 사용할 클래스를 변경할 수도 있습니다.
상속 계층 구조
요구 사항
헤더: afxbasetabctrl.h
CMFCBaseTabCtrl::AddIcon
보호된 CMap m_mapAddedIcons 멤버의 아이콘 목록에 아이콘을 추가합니다.
void AddIcon(
HICON hIcon,
int iIcon);
매개 변수
hIcon
[in] 추가할 아이콘에 대한 핸들입니다.
iIcon
[in] 보호된 CImageList m_Images 멤버에 있는 0부터 시작하는 아이콘 인덱스입니다.
설명
CMFCBaseTabCtrl::AddTab
탭 컨트롤에 새 탭을 추가합니다.
virtual void AddTab(
CWnd* pTabWnd,
LPCTSTR lpszTabLabel,
UINT uiImageId = (UINT)-1,
BOOL bDetachable = TRUE);
virtual void AddTab(
CWnd* pTabWnd,
UINT uiResTabLabel,
UINT uiImageId = (UINT)-1,
BOOL bDetachable = TRUE);
매개 변수
pTabWnd
[in] 이 메서드가 새 탭으로 나타내는 창에 대한 포인터입니다.
lpszTabLabel
[in] 새 탭의 레이블을 포함하는 문자열입니다.
uiImageId
[in] 이미지 목록의 이미지 ID입니다. 탭 컨트롤은 이 이미지를 새 탭의 아이콘으로 사용합니다.
uiResTabLabel
[in] 레이블에 대한 리소스 ID입니다.
bDetachable
[in] 새 탭의 분리 가능 여부를 결정하는 부울 매개 변수입니다.
설명
pTabWnd가 CDockablePane 클래스에서 파생되지 않은 개체를 가리키고 bDetachable이 TRUE인 경우, 프레임워크는 자동으로 pTabWnd 개체의 래퍼를 작성합니다. 래퍼는 pTabWnd 개체를 분리할 수 있게 만듭니다. 기본적으로 래퍼는 CDockablePaneAdapter 클래스의 인스턴스입니다. 기본 래퍼에서 제공한 기능이 허용되지 않는 경우 CMFCBaseTabCtrl::SetDockingBarWrapperRTC 메서드를 사용하여 다른 래퍼를 지정하세요.
CMFCBaseTabCtrl::ApplyRestoredTabInfo
virtual void ApplyRestoredTabInfo(BOOL bUseTabIndexes = FALSE);
매개 변수
[in] bUseTabIndexes
설명
CMFCBaseTabCtrl::AutoDestroyWindow
void AutoDestroyWindow(BOOL bAutoDestroy = TRUE);
매개 변수
[in] bAutoDestroy
설명
CMFCBaseTabCtrl::CalcRectEdit
virtual void CalcRectEdit(CRect& rectEdit);
매개 변수
[in] rectEdit
설명
CMFCBaseTabCtrl::CleanUp
virtual void CleanUp();
설명
CMFCBaseTabCtrl::ClearImageList
virtual void ClearImageList();
설명
CMFCBaseTabCtrl::CreateWrapper
CWnd 클래스에서 파생되지만 CDockablePane 클래스에서 파생되지 않은 프레임 창의 래퍼를 만듭니다.
virtual CWnd* CreateWrapper(
CWnd* pWndToWrap,
LPCTSTR lpszTabLabel,
BOOL bDetachable);
매개 변수
pWndToWrap
[in] 래핑된 프레임 창에 대한 포인터입니다.
lpszTabLabel
[in] 창의 레이블이 포함된 문자열입니다.
bDetachable
[in] 창이 분리되는지 여부를 나타내는 부울 매개 변수입니다.
Return Value
CreateWrapper가 pWndToWrap의 래퍼 클래스를 성공적으로 만들면 CDockablePane 클래스에서 파생된 래퍼에 대한 포인터입니다. 메서드가 실패하면 pWndToWrap을 반환합니다.
설명
탭 창은 CWnd에서 파생된 모든 개체를 도킹할 수 있습니다. 그러나 CMFCBaseTabCtrl Class 개체를 도킹 가능하게 하려면 CMFCBaseTabCtrl의 각 개체를 분리할 수 있어야 합니다. 따라서 CMFCBaseTabCtrl이 CDockablePane에서 파생되지 않은 모든 개체를 자동으로 래핑합니다.
기본적으로 CMFCBaseTabCtrl은 CDockablePaneAdapter 클래스의 인스턴스를 만듭니다. 래퍼의 기본 클래스를 변경하려면 CMFCBaseTabCtrl::SetDockingBarWrapperRTC를 호출합니다.
CDockablePane에서 pWndToWrap이 파생되면 이 메서드가 래퍼를 만들지 않습니다. 대신 실패하고 pWndToWrap을 반환합니다.
CMFCBaseTabCtrl::DetachTab
프레임워크가 이 메서드를 호출하여 탭 컨트롤에서 탭을 분리합니다.
virtual BOOL DetachTab(
AFX_DOCK_METHOD dockMethod,
int nTabNum = -1,
BOOL bHide = FALSE);
매개 변수
dockMethod
[in] CBasePane 클래스에서 제공하는 열거된 데이터 형식입니다. 이 데이터 형식은 탭을 분리하는 데 사용된 메서드를 지정합니다.
nTabNum
[in] 분리할 탭의 0부터 시작하는 인덱스입니다.
bHide
[in] 프레임워크가 분리된 탭을 숨길지 여부를 나타내는 부울 매개 변수입니다.
Return Value
성공하면 0이 아니고, 그렇지 않으면 0입니다.
설명
nTabNum으로 지정된 탭이 분리 불가능하면 이 함수는 실패하고 FALSE를 반환합니다.
CMFCBaseTabCtrl::EnableActivateLastActive
void EnableActivateLastActive(BOOL bLastActive = TRUE);
매개 변수
[in] bLastActive
설명
CMFCBaseTabCtrl::EnableAutoColor
탭을 그릴 때 프레임워크가 자동 배경색을 사용하는지 여부를 제어합니다.
void EnableAutoColor(BOOL bEnable = TRUE);
매개 변수
bEnable
[in] 프레임워크에서 자동 색을 사용하는지 여부를 결정하는 부울 매개 변수입니다.
설명
탭 컨트롤에는 사전 정의된 여러 색상의 배열이 있습니다. 프레임워크에서 자동 색상을 사용하면 일련의 탭에 포함된 각 탭에 이 배열의 다음 색상이 할당됩니다.
기본적으로 자동 색은 라이브러리에 정의된 색에 따라 결정됩니다. CMFCBaseTabCtrl::SetAutoColors를 호출하여 사용자 지정 색상 배열을 제공할 수 있습니다.
CMFCBaseTabCtrl::EnableCustomToolTips
탭 컨트롤에 대한 사용자 지정 도구 설명을 사용하도록 설정합니다.
BOOL EnableCustomToolTips(BOOL bEnable = TRUE);
매개 변수
bEnable
[in] 사용자 지정 도구 설명 사용 여부를 결정하는 부울입니다.
Return Value
성공하면 TRUE이고, 실패하면 FALSE입니다.
설명
사용자 지정 도구 설명이 활성화된 경우 탭 컨트롤이 AFX_WM_ON_GET_TAB_TOOLTIP 메시지를 기본 프레임으로 전송합니다. 애플리케이션에서 사용자 지정 도구 설명을 지원하려면, 기본 프레임 창에서 이 메서드를 처리하고 사용자 지정 도구 설명 텍스트를 제공해야 합니다. 사용자 지정 도구 설명 텍스트 제공에 대한 자세한 내용은 CMFCTabToolTipInfo 구조체를 참조하세요.
CMFCBaseTabCtrl::EnableInPlaceEdit
사용자가 탭 레이블 직접 편집을 사용하도록 설정합니다.
virtual void EnableInPlaceEdit(BOOL bEnable) = 0;
매개 변수
bEnable
[in] 탭 레이블의 직접 편집을 사용하도록 설정할지 여부를 지정하는 부울 매개 변수입니다.
설명
기본적으로 탭 레이블의 직접 편집은 탭 컨트롤에 사용하지 않도록 설정됩니다.
탭 컨트롤에서 탭의 하위 집합에 대한 직접 편집을 사용하도록 설정할 수 있습니다. 이렇게 하려면 CMFCBaseTabCtrl::StartRenameTab 메서드를 재정의합니다. StartRenameTab은 탭 레이블의 직접 편집을 지원하는 모든 탭에 대해 0이 아닌 값을 반환해야 합니다.
CMFCBaseTabCtrl Class에서 이 메서드는 순수 가상 함수이며, 구현이 없습니다. CMFCBaseTabCtrl에서 클래스를 파생하는 경우 이 함수를 구현해야 합니다.
CMFCBaseTabCtrl::EnableTabDetach
분리 가능한 탭을 사용하도록 설정합니다.
virtual BOOL EnableTabDetach(
int iTab,
BOOL bEnable);
매개 변수
iTab
[in] 탭의 0부터 시작하는 인덱스입니다.
bEnable
[in] 탭 분리 가능 여부를 나타내는 부울입니다.
Return Value
성공하면 TRUE이고, 실패하면 FALSE입니다.
CMFCBaseTabCtrl::EnableTabSwap
사용자가 마우스를 사용하여 탭 순서를 변경할 수 있습니다.
void EnableTabSwap(BOOL bEnable);
매개 변수
bEnable
[in] 탭 전환 사용 가능 여부를 나타내는 부울입니다.
설명
탭 전환을 사용하는 경우 사용자는 탭을 끌어 탭 컨트롤에서 상대적 위치를 변경할 수 있습니다.
CMFCBaseTabCtrl::EnsureVisible
지정된 탭이 표시될 때까지 탭을 스크롤합니다.
virtual BOOL EnsureVisible(int iTab);
매개 변수
iTab
[in] 탭의 0부터 시작하는 인덱스입니다.
Return Value
성공하면 0이 아니고, 그렇지 않으면 0입니다.
설명
iTab으로 표시된 탭이 이미 표시되면 이 메서드는 영향을 주지 않습니다.
기본적으로 이 메서드는 CMFCBaseTabCtrl Class에서 지원되지 않습니다. 사용자 지정 탭 컨트롤이 탭 스크롤을 지원하는 경우, CMFCBaseTabCtrl에서 파생된 사용자 지정 클래스에서 이 함수를 구현해야 합니다. 이 메서드는 CMFCTabCtrl 클래스에서 지원됩니다.
CMFCBaseTabCtrl::EnterDragMode
void EnterDragMode();
설명
CMFCBaseTabCtrl::FindTargetWnd
지정된 지점에 포함된 창을 확인합니다.
virtual CWnd* FindTargetWnd(const CPoint& pt) = 0;
매개 변수
pt
[in] CMFCBaseTabCtrl 개체의 클라이언트 영역 좌표를 사용하여 정의된 지점입니다.
Return Value
성공할 경우 CWnd 개체에 대한 포인터입니다. 그렇지 않으면 NULL입니다.
설명
CMFCBaseTabCtrl 클래스에서 이 메서드는 순수 가상 함수입니다. CMFCBaseTabCtrl에서 클래스를 파생시키는 경우 이 메서드를 구현해야 합니다.
CMFCBaseTabCtrl::FireChangeActiveTab
virtual void FireChangeActiveTab(int nNewTab);
매개 변수
[in] nNewTab
설명
CMFCBaseTabCtrl::FireChangingActiveTab
virtual BOOL FireChangingActiveTab(int nNewTab);
매개 변수
[in] nNewTab
Return Value
설명
CMFCBaseTabCtrl::GetActiveTab
현재 활성 탭의 인덱스를 검색합니다.
virtual int GetActiveTab() const;
Return Value
활성 탭의 0부터 시작하는 인덱스입니다. 활성 탭이 없는 경우 -1입니다.
CMFCBaseTabCtrl::GetActiveTabColor
현재 활성 탭의 배경색을 검색합니다.
virtual COLORREF GetActiveTabColor() const;
Return Value
활성 탭의 배경색을 지정하는 COLORREF 값입니다.
설명
기본적으로 활성 탭의 배경색은 COLOR_WINDOW입니다. CMFCBaseTabCtrl::SetActiveTabColor메서드를 사용하여 활성 탭의 배경색을 변경할 수 있습니다.
CMFCBaseTabCtrl::GetActiveTabTextColor
활성 탭의 텍스트 색을 검색합니다.
virtual COLORREF GetActiveTabTextColor() const;
Return Value
활성 탭의 텍스트 색을 지정하는 COLORREF 값입니다.
설명
기본적으로 활성 탭의 텍스트 색은 COLOR_WINDOWTEXT입니다. CMFCBaseTabCtrl::SetActiveTabTextColor 메서드로 텍스트 색을 변경할 수 있습니다.
CMFCBaseTabCtrl::GetActiveWnd
현재 활성 탭 창에 대한 포인터를 검색합니다.
virtual CWnd* GetActiveWnd() const;
Return Value
창에 대한 포인터입니다.
CMFCBaseTabCtrl::GetAutoColors
자동 색상 지정에 사용되는 색상 배열을 검색합니다.
const CArray<COLORREF,COLORREF>& GetAutoColors() const;
Return Value
CMFCBaseTabCtrl 개체가 자동 탭 색상 지정에 사용하는 COLORREF 값 배열에 대한 참조입니다.
설명
기본적으로 프레임워크는 색상의 배열을 라이브러리에서 정의한 색으로 초기화합니다. CMFCBaseTabCtrl::SetAutoColors 메서드를 호출하여 색상의 사용자 지정 배열을 제공할 수 있습니다.
CMFCBaseTabCtrl::GetFirstVisibleTab
첫 번째 표시 탭에 대한 포인터를 검색합니다.
virtual CWnd* GetFirstVisibleTab(int& iTabNum);
virtual CWnd* GetFirstVisibleTab(
int iStartFrom,
int& iTabNum);
매개 변수
iTabNum
[out] 정수에 대한 참조입니다. 이 메서드는 이 매개 변수에 처음 표시되는 탭의 0부터 시작하는 인덱스를 작성합니다.
iStartFrom
[in] 확인할 첫 번째 탭의 0부터 시작하는 인덱스입니다.
Return Value
성공할 경우 첫 번째로 표시되는 탭에 대한 포인터입니다. 그렇지 않으면 NULL입니다.
설명
이 메서드가 실패하면 값 -1을 iStartFrom에 씁니다.
iStartFrom이 탭 컨트롤의 탭 수보다 크거나 같으면 GetFirstVisibleTab이 자동으로 실패합니다.
CMFCBaseTabCtrl::GetFirstVisibleTabNum
virtual int GetFirstVisibleTabNum() const;
Return Value
설명
CMFCBaseTabCtrl::GetHighlightedTab
현재 강조 표시된 탭의 인덱스를 검색합니다.
int GetHighlightedTab() const;
Return Value
강조 표시된 탭의 0부터 시작하는 인덱스입니다.
CMFCBaseTabCtrl::GetImageList
virtual const CImageList* GetImageList() const;
Return Value
설명
CMFCBaseTabCtrl::GetImageSize
virtual CSize GetImageSize() const;
Return Value
설명
CMFCBaseTabCtrl::GetLastVisibleTab
virtual CWnd* GetLastVisibleTab(int& iTabNum);
매개 변수
[in] iTabNum
Return Value
설명
CMFCBaseTabCtrl::GetLocation
탭 컨트롤의 탭 영역 부분 위치를 검색합니다.
Location GetLocation() const;
Return Value
탭 영역의 위치입니다.
설명
가능한 탭 영역 위치 값은 LOCATION_BOTTOM 및 LOCATION_TOP입니다.
CMFCBaseTabCtrl::GetMaxWindowSize
virtual CSize GetMaxWindowSize() const;
Return Value
설명
CMFCBaseTabCtrl::GetTabArea
탭 컨트롤의 탭 영역 크기 및 위치를 검색합니다.
virtual void GetTabArea(
CRect& rectTabAreaTop,
CRect& rectTabAreaBottom) const = 0;
매개 변수
rectTabAreaTop
[in] CRect 개체에 대한 참조입니다. GetTabArea는 이 개체를 사용하여 맨 위 탭 영역의 크기와 위치를 저장합니다.
rectTabAreaBottom
[in] CRect 개체에 대한 참조입니다. GetTabArea는 이 개체를 사용하여 맨 아래 탭 영역의 크기와 위치를 저장합니다.
설명
GetTabArea가 반환되면 CRect 매개 변수에는 탭 컨트롤의 클라이언트 좌표에 있는 탭 영역의 크기와 위치가 포함됩니다. 탭 컨트롤의 맨 위 또는 맨 아래에 탭 영역이 없으면 rectTabAreaTop 또는 rectTabAreaBottom이 비어 있습니다.
CMFCBaseTabCtrl Class에서 이 메서드는 순수 가상 함수이며, 구현이 없습니다. CMFCBaseTabCtrl에서 클래스를 파생하는 경우 이 함수를 구현해야 합니다.
CMFCBaseTabCtrl::GetTabBkColor
지정된 탭의 배경색을 검색합니다.
virtual COLORREF GetTabBkColor(int iTab) const;
매개 변수
iTab
[in] 탭의 0부터 시작하는 인덱스입니다.
Return Value
지정된 탭의 배경색을 나타내는 COLORREF 값입니다. iTab이 범위를 벗어나는 경우 -1입니다.
CMFCBaseTabCtrl::GetTabBorderSize
탭 컨트롤의 탭 테두리 크기를 검색합니다.
virtual int GetTabBorderSize() const;
Return Value
탭 테두리의 크기(픽셀)입니다.
설명
탭 테두리의 기본 크기는 3픽셀입니다. CMFCBaseTabCtrl::SetTabBorderSize 메서드로 이 테두리 크기를 변경할 수 있습니다.
CMFCBaseTabCtrl::GetTabByID
탭 ID를 기반으로 탭의 인덱스를 검색합니다.
virtual int GetTabByID(int id) const;
매개 변수
id
[in] 탭 ID입니다.
Return Value
탭이 있는 경우 0부터 시작하는 인덱스입니다. 탭 ID를 찾을 수 없는 경우 -1입니다.
설명
탭 ID는 탭이 탭 컨트롤에 추가될 때 자동으로 할당됩니다.
CMFCBaseTabCtrl::GetTabCloseButton
CRect GetTabCloseButton() const;
Return Value
설명
CMFCBaseTabCtrl::GetTabFromHwnd
지정된 HWND 개체를 포함하는 탭의 인덱스를 검색합니다.
virtual int GetTabFromHwnd(HWND hwnd) const;
매개 변수
hwnd
[in] 창 핸들입니다.
Return Value
성공한 경우 탭의 0부터 시작하는 인덱스입니다. 탭에 hwnd가 없으면 -1입니다.
CMFCBaseTabCtrl::GetTabFromPoint
지정된 지점이 포함된 탭을 검색합니다.
virtual int GetTabFromPoint(CPoint& pt) const;
매개 변수
pt
[in] 탭 컨트롤의 클라이언트 좌표에 있는 지점입니다.
Return Value
pt를 포함하는 탭의 인덱스입니다. 탭에 pt가 없는 경우 -1입니다.
CMFCBaseTabCtrl::GetTabFullWidth
virtual int GetTabFullWidth(int iTab) const;
매개 변수
[in] iTab
Return Value
설명
CMFCBaseTabCtrl::GetTabHicon
지정된 탭과 연결된 HICON을 반환합니다.
virtual HICON GetTabHicon(int iTab) const;
매개 변수
iTab
[in] 탭의 0부터 시작하는 인덱스입니다.
Return Value
성공한 경우 탭 레이블과 연관된 HICON입니다. HICON이 없거나 메서드가 실패하는 경우에는 NULL입니다.
CMFCBaseTabCtrl::GetTabIcon
지정된 탭과 연결된 아이콘을 검색합니다.
virtual UINT GetTabIcon(int iTab) const;
매개 변수
iTab
[in] 탭의 0부터 시작하는 인덱스입니다.
Return Value
성공한 경우 지정된 탭의 아이콘 ID입니다. 인덱스가 유효하지 않은 경우 -1입니다.
설명
CMFCBaseTabCtrl 개체는 내부 CImageList 개체에 아이콘을 저장합니다.
CMFCBaseTabCtrl::GetTabID
탭 인덱스로 지정된 탭에 대한 ID를 검색합니다.
int GetTabID(int iTab) const;
매개 변수
iTab
[in] 탭의 0부터 시작하는 인덱스입니다.
Return Value
iTab이 범위를 벗어나는 경우 탭의 ID 또는 -1입니다.
CMFCBaseTabCtrl::GetTabLabel
탭 레이블의 텍스트를 검색합니다.
virtual BOOL GetTabLabel(
int iTab,
CString& strLabel) const;
매개 변수
iTab
[in] 탭의 0부터 시작하는 인덱스입니다.
strLabel
[out] CString 개체에 대한 참조입니다. 이 메서드는 이 매개 변수에 탭의 레이블을 저장합니다.
Return Value
성공하면 TRUE이고, 그렇지 않으면 FALSE입니다.
설명
인덱스 iTab이 유효하지 않은 경우 이 메서드가 실패합니다.
CMFCBaseTabCtrl::AddTab을 사용하여 탭을 작성할 때 탭의 레이블을 설정합니다. CMFCBaseTabCtrl::SetTabLabel 메서드를 사용하여 작성한 후 레이블을 변경할 수도 있습니다.
CMFCBaseTabCtrl::GetTabRect
지정된 탭의 크기와 위치를 검색합니다.
virtual BOOL GetTabRect(
int iTab,
CRect& rect) const;
매개 변수
iTab
[in] 탭의 0부터 시작하는 인덱스입니다.
rect
[out] CRect 개체에 대한 참조입니다. 이 메서드는 이 매개 변수에 탭의 크기와 위치를 저장합니다.
Return Value
성공하면 TRUE이고, 탭 인덱스가 유효하지 않은 경우 FALSE입니다.
CMFCBaseTabCtrl::GetTabsHeight
virtual int GetTabsHeight() const;
Return Value
설명
CMFCBaseTabCtrl::GetTabsNum
탭 컨트롤에서 탭 수를 검색합니다.
virtual int GetTabsNum() const;
Return Value
탭 컨트롤의 탭 수입니다.
CMFCBaseTabCtrl::GetTabsRect
virtual void GetTabsRect(CRect& rect) const;
매개 변수
[in] rect
설명
CMFCBaseTabCtrl::GetTabTextColor
지정한 탭의 텍스트 색상을 검색합니다.
virtual COLORREF GetTabTextColor(int iTab) const;
매개 변수
iTab
[in] 탭의 0부터 시작하는 인덱스입니다.
Return Value
지정된 탭의 텍스트 색을 나타내는 COLORREF 매개 변수입니다. iTab이 범위를 벗어났을 경우 -1입니다.
CMFCBaseTabCtrl::GetTabWnd
지정된 탭에 있는 창에 대한 포인터를 반환합니다.
virtual CWnd* GetTabWnd(int iTab) const;
매개 변수
iTab
[in] 탭의 0부터 시작하는 인덱스입니다.
Return Value
iTab이 지정하는 탭에 있는 CWnd 개체에 대한 포인터입니다. iTab이 유효하지 않으면 NULL입니다.
설명
반환된 개체는 CMFCBaseTabCtrl::AddTab 또는 CMFCBaseTabCtrl::InsertTab을 호출한 경우 애플리케이션이 추가한 개체입니다.
탭의 개체에 래퍼가 있는 경우 이 메서드는 해당 개체의 래퍼를 반환합니다. 래퍼에 대한 자세한 내용은 CMFCBaseTabCtrl::CreateWrapper를 참조하세요. 래퍼가 없는 직접 개체에 대한 포인터에 액세스하려면 CMFCBaseTabCtrl::GetTabWndNoWrapper메서드를 사용하세요.
CMFCBaseTabCtrl::GetTabWndNoWrapper
컨트롤에 래퍼가 있는 경우에도 탭에 있는 컨트롤에 대한 포인터를 반환합니다.
virtual CWnd* GetTabWndNoWrapper(int iTab) const;
매개 변수
iTab
[in] 탭의 0부터 시작하는 인덱스입니다.
Return Value
지정된 탭에 있는 CWnd 개체에 대한 포인터입니다.iTab이 잘못된 경우 NULL입니다.
설명
이 메서드는 CMFCBaseTabCtrl::AddTab 또는 CMFCBaseTabCtrl::InsertTab 메서드를 사용하여 추가한 CWnd 개체에 대한 직접 포인터를 검색합니다. GetTabWndNoWrapper는 프레임워크가 개체의 래퍼를 추가한 경우에도 추가된 CWnd에 대한 포인터를 검색합니다. 래퍼 및 CMFCBaseTabCtrl 클래스에 대한 자세한 내용은 CMFCBaseTabCtrl::CreateWrapper를 참조하세요.
래퍼 클래스를 무시하지 않으려면 CMFCBaseTabCtrl::GetTabWnd 메서드를 사용합니다.
CMFCBaseTabCtrl::GetToolTipCtrl
도구 설명 컨트롤에 대한 참조를 검색합니다.
CToolTipCtrl& GetToolTipCtrl() const;
Return Value
도구 설명 컨트롤에 대한 참조입니다.
CMFCBaseTabCtrl::GetVisibleTabsNum
현재 표시되는 탭의 수를 검색합니다.
virtual int GetVisibleTabsNum() const;
Return Value
표시되는 탭의 수입니다.
CMFCBaseTabCtrl::HasImage
virtual BOOL HasImage(int iTab) const;
매개 변수
[in] iTab
Return Value
설명
CMFCBaseTabCtrl::HideSingleTab
표시되는 탭 컨트롤이 한 개 있는 경우 탭 컨트롤에 대한 탭을 숨기도록 옵션을 설정합니다.
virtual void HideSingleTab(BOOL bHide = TRUE);
매개 변수
bHide
[in] 단일 탭 숨기기 사용 여부를 지정하는 부울입니다.
설명
애플리케이션이 단일 탭을 숨기도록 구성된 경우 탭 컨트롤에 두 번째 탭이 추가되면 프레임워크가 자동으로 해당 탭을 표시합니다.
CMFCBaseTabCtrl::InsertTab
탭 컨트롤에 탭을 삽입합니다.
Virtual void InsertTab(
CWnd* pNewWnd,
LPCTSTR lpszTabLabel,
int nInsertAt,
UINT uiImageId = (UINT)-1,
BOOL bDetachable = TRUE);
virtual void InsertTab(
CWnd* pNewWnd,
UINT uiResTabLabel,
int nInsertAt,
UINT uiImageId = (UINT)-1,
BOOL bDetachable = TRUE);
매개 변수
pNewWnd
[in] 이 메서드가 새 탭으로 추가하는 창에 대한 포인터입니다.
lpszTabLabel
[in] 새 탭의 레이블을 포함하는 문자열입니다.
nInsertAt
[in] 새 탭의 0부터 시작하는 인덱스입니다.
uiImageId
[in] 이미지 목록의 이미지 ID입니다. 탭 컨트롤은 이 이미지를 새 탭의 아이콘으로 사용합니다.
bDetachable
[in] 새 탭의 분리 가능 여부를 결정하는 부울 매개 변수입니다.
uiResTabLabel
[in] 레이블에 대한 리소스 ID입니다.
설명
pNewWnd로 표시된 개체가 CDockablePane 클래스에서 파생되지 않았고 bDetachable 매개 변수가 TRUE인 경우, 프레임워크는 새 탭에 대한 특수 래퍼를 만듭니다. 기본적으로 래퍼는 CDockablePaneAdapter 클래스의 인스턴스입니다. CMFCBaseTabCtrl::SetDockingBarWrapperRTC 메서드를 사용하여 다른 래퍼 클래스를 작성합니다. 사용자 정의 래퍼 클래스는 CDockablePaneAdapter에서 파생되어야 합니다.
CMFCBaseTabCtrl::InvalidateTab
void InvalidateTab(int iTab);
매개 변수
[in] iTab
설명
CMFCBaseTabCtrl::IsActiveTabCloseButton
virtual BOOL IsActiveTabCloseButton() const;
Return Value
설명
CMFCBaseTabCtrl::IsAutoColor
탭 컨트롤이 autocolor 모드에 있는지 여부를 확인합니다.
BOOL IsAutoColor() const;
Return Value
탭 컨트롤이 autocolor 모드에 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.
설명
CMFCBaseTabCtrl::EnableAutoColor 메서드를 사용하여 autocolor 모드를 사용하거나 사용하지 않도록 설정할 수 있습니다.
CMFCBaseTabCtrl::IsAutoDestroyWindow
BOOL IsAutoDestroyWindow() const;
Return Value
설명
CMFCBaseTabCtrl::IsColored
virtual BOOL IsColored() const;
Return Value
설명
CMFCBaseTabCtrl::IsDialogControl
BOOL IsDialogControl() const;
Return Value
설명
CMFCBaseTabCtrl::IsDrawNoPrefix
BOOL IsDrawNoPrefix() const;
Return Value
설명
CMFCBaseTabCtrl::IsFlatFrame
탭 컨트롤 프레임이 플랫 스타일 또는 3D 스타일로 렌더링되는지 여부를 나타냅니다.
virtual BOOL IsFlatFrame() const;
Return Value
탭 컨트롤 프레임이 플랫 스타일로 렌더링되는 경우 TRUE이고, 프레임이 3D 스타일로 렌더링되는 경우 FALSE입니다.
설명
CMFCTabCtrl::SetFlatFrame을 사용하여 탭 컨트롤 프레임에 대한 스타일을 변경합니다.
Outlook 스타일을 사용하는 탭 컨트롤은 플랫 프레임으로 렌더링 될 수 없습니다. 여기에는 CMFCOutlookBarTabCtrl 클래스와 해당 클래스에서 파생된 모든 클래스가 포함됩니다.
CMFCBaseTabCtrl::IsFlatTab
virtual BOOL IsFlatTab() const;
Return Value
설명
CMFCBaseTabCtrl::IsHideSingleTab
탭이 하나만 있는 경우 탭 컨트롤이 탭 레이블을 숨기는지 여부를 결정합니다.
virtual BOOL IsHideSingleTab() const;
Return Value
탭이 한 개 있는 경우 탭 컨트롤이 탭 레이블을 숨기면 TRUE이고, 그렇지 않으면 FALSE입니다.
설명
탭이 하나만 있는 경우 CMFCBaseTabCtrl::HideSingleTab 메서드를 사용하여 탭 레이블을 숨기도록 설정합니다.
CMFCBaseTabCtrl::IsIconAdded
BOOL IsIconAdded(
HICON hIcon,
int& iIcon);
매개 변수
[in] hIcon
[in] iIcon
Return Value
설명
CMFCBaseTabCtrl::IsInPlaceEdit
사용자가 탭 레이블을 동적으로 수정할 수 있도록 탭 컨트롤이 구성되어 있는지 여부를 나타냅니다.
virtual BOOL IsInPlaceEdit() const;
Return Value
위치 내 편집이 사용되는 경우 0이 아닌 값입니다. 그렇지 않으면 0입니다.
설명
CMFCBaseTabCtrl::EnableInPlaceEdit 메서드를 호출하여 위치 내 편집을 사용하거나 사용하지 않도록 설정할 수 있습니다.
CMFCBaseTabCtrl::IsLeftRightRounded
virtual BOOL IsLeftRightRounded() const;
Return Value
설명
CMFCBaseTabCtrl::IsMDITab
BOOL IsMDITab() const;
Return Value
설명
CMFCBaseTabCtrl::IsOneNoteStyle
탭이 Microsoft OneNote의 스타일로 표시되는지 여부를 결정합니다.
virtual BOOL IsOneNoteStyle() const;
Return Value
Microsoft OneNote의 스타일에 탭이 표시되면 TRUE이고, 그렇지 않으면 FALSE입니다.
설명
Microsoft OneNote 스타일을 사용하도록 설정하려면 CMDIFrameWndEx::EnableMDITabs 메서드를 호출합니다. CMFCTabCtrl 클래스를 인스턴스화할 때 이 스타일을 사용하도록 설정할 수도 있습니다. 간단히 스타일 STYLE_3D_ONENOTE를 CMFCTabCtrl::Create 메서드에 전달하면 됩니다.
기본적으로 Microsoft OneNote 스타일은 CMFCBaseTabCtrl Class에서 파생된 사용자 지정 클래스에서 지원되지 않습니다. 그러나 CMFCTabCtrl 클래스에서는 지원됩니다.
CMFCBaseTabCtrl::IsPtInTabArea
지점이 탭 영역 내에 있는지 여부를 확인합니다.
virtual BOOL IsPtInTabArea(CPoint point) const = 0;
매개 변수
point
[in] 테스트할 지점입니다.
Return Value
지점이 탭 영역에 있는 경우 0이 아닌 값입니다. 그렇지 않은 경우 0입니다.
설명
CMFCBaseTabCtrl Class에서 이 메서드는 순수 가상 함수이며, 구현이 없습니다. CMFCBaseTabCtrl에서 클래스를 파생하는 경우 이 함수를 구현해야 합니다.
CMFCBaseTabCtrl::IsTabCloseButtonHighlighted
BOOL IsTabCloseButtonHighlighted() const;
Return Value
설명
CMFCBaseTabCtrl::IsTabCloseButtonPressed
BOOL IsTabCloseButtonPressed() const;
Return Value
설명
CMFCBaseTabCtrl::IsTabDetachable
탭이 분리 가능한지 여부를 나타냅니다.
virtual BOOL IsTabDetachable(int iTab) const;
매개 변수
iTab
[in] 확인할 탭의 0부터 시작하는 인덱스입니다.
Return Value
탭이 분리 가능한 경우 TRUE이고, 그렇지 않으면 FALSE입니다.
설명
탭을 분리할 수 있게 하려면 CMFCBaseTabCtrl::EnableTabDetach 메서드를 사용합니다.
CMFCBaseTabCtrl::IsTabIconOnly
탭 레이블에 아이콘만 포함되어 있고 텍스트가 없는지 확인합니다.
virtual BOOL IsTabIconOnly(int iTab) const;
매개 변수
iTab
[in] 탭의 0부터 시작하는 인덱스입니다.
Return Value
탭 레이블에 아이콘만 있는 경우 TRUE이고, 그렇지 않으면 FALSE입니다.
설명
애플리케이션의 탭을 아이콘만 표시하도록 설정하려면 CMFCBaseTabCtrl::SetTabIconOnly 메서드를 호출합니다.
CMFCBaseTabCtrl::IsTabSwapEnabled
사용자가 탭 컨트롤에서 마우스를 사용하여 탭 위치를 변경할 수 있는지 여부를 결정합니다.
BOOL IsTabSwapEnabled() const;
Return Value
사용자가 탭 위치를 변경할 수 있는 경우 0이 아닌 값입니다. 그렇지 않은 경우 0입니다.
설명
기본적으로 사용자는 탭 컨트롤의 탭 순서를 변경할 수 없습니다. 이 기능을 사용하도록 설정하려면 CMFCBaseTabCtrl::EnableTabSwap 메서드를 사용합니다.
CMFCBaseTabCtrl::IsTabVisible
지정된 탭이 표시되는지 여부를 나타냅니다.
virtual BOOL IsTabVisible(int iTab) const;
매개 변수
iTab
[in] 확인할 탭의 0부터 시작하는 인덱스입니다.
Return Value
지정된 탭이 표시되는 경우 0이 아닌 값입니다. 그렇지 않은 경우 0입니다.
CMFCBaseTabCtrl::IsVS2005Style
virtual BOOL IsVS2005Style() const;
Return Value
설명
CMFCBaseTabCtrl::m_bActivateTabOnRightClick
m_bActivateTabOnRightClick은 사용자가 마우스 오른쪽 단추를 사용하여 탭 레이블을 클릭할 때 탭이 포커스에 있는지 여부를 판별합니다.
BOOL m_bActivateTabOnRightClick;
설명
이 데이터 멤버의 기본값은 FALSE입니다.
CMFCBaseTabCtrl::m_bAutoDestroyWindow
m_bAutoDestroyWindow는 탭이 제거될 때 프레임워크가 탭에서 개체를 자동으로 삭제하는지 여부를 판별합니다.
BOOL m_bAutoDestroyWindow;
설명
기본적으로 이 멤버는 FALSE입니다.
CMFCBaseTabCtrl::MoveTab
virtual void MoveTab(
int nSource,
int nDest);
매개 변수
[in] nSource
[in] nDest
설명
CMFCBaseTabCtrl::OnChangeTabs
탭 컨트롤의 탭 수가 변경될 때 프레임워크에서 이 메서드를 호출합니다.
virtual void OnChangeTabs();
설명
기본적으로 이 메서드는 아무것도 수행하지 않습니다. 탭 컨트롤 변경 사항의 탭 수가 변경될 때 사용자 지정 코드를 실행하려면 이 메서드를 재정의합니다.
CMFCBaseTabCtrl::OnDrop
virtual BOOL OnDrop(
COleDataObject*,
DROPEFFECT,
CPoint);
매개 변수
[in] COleDataObject*
[in] DROPEFFECT
[in] CPoint
Return Value
설명
CMFCBaseTabCtrl::OnDragOver
virtual DROPEFFECT OnDragOver(
COleDataObject*,
DWORD,
CPoint);
매개 변수
[in] COleDataObject*
[in] DWORD
[in] CPoint
Return Value
설명
CMFCBaseTabCtrl::OnDragLeave
virtual void OnDragLeave();
설명
CMFCBaseTabCtrl::OnDragEnter
virtual DROPEFFECT OnDragEnter(
COleDataObject*,
DWORD,
CPoint);
매개 변수
[in] COleDataObject*
[in] DWORD
[in] CPoint
Return Value
설명
CMFCBaseTabCtrl::OnRenameTab
virtual BOOL OnRenameTab(int, CString&);
매개 변수
[in] int
[in] CString&
Return Value
설명
CMFCBaseTabCtrl::PreTranslateMessage
virtual BOOL PreTranslateMessage(MSG* pMsg);
매개 변수
[in] pMsg
Return Value
설명
CMFCBaseTabCtrl::RecalcLayout
탭 컨트롤의 내부 레이아웃을 다시 계산합니다.
virtual void RecalcLayout() = 0;
설명
CMFCBaseTabCtrl Class에서 이 메서드는 순수 가상 함수입니다. CMFCBaseTabCtrl에서 클래스를 파생하는 경우 이 함수를 구현해야 합니다.
CMFCBaseTabCtrl::RemoveAllTabs
탭 컨트롤에서 탭을 모두 제거합니다.
virtual void RemoveAllTabs();
설명
CMFCBaseTabCtrl::m_bAutoDestroyWindow가 TRUE인 경우 프레임워크는 제거된 탭에 연결된 모든 CWnd 개체를 삭제합니다.
CMFCBaseTabCtrl::RemoveTab
탭 컨트롤에서 탭을 제거합니다.
virtual BOOL RemoveTab(
int iTab,
BOOL bRecalcLayout = TRUE);
매개 변수
iTab
[in] 탭의 0부터 시작하는 인덱스입니다.
bRecalcLayout
[in] 탭의 레이아웃을 다시 계산할지 여부를 지정하는 부울 매개 변수입니다.
Return Value
메서드가 탭을 성공적으로 제거하면 TRUE이고, 그렇지 않으면 FALSE입니다.
설명
CMFCBaseTabCtrl::m_bAutoDestroyWindow가 TRUE이면 RemoveTab은 지정된 탭과 연결된 CWnd 개체를 삭제합니다.
CMFCBaseTabCtrl::RenameTab
virtual BOOL RenameTab();
Return Value
설명
CMFCBaseTabCtrl::ResetImageList
CMFCBaseTabCtrl 클래스의 인스턴스에 대한 이미지 목록을 재설정합니다.
void ResetImageList();
CMFCBaseTabCtrl::Serialize
virtual void Serialize(CArchive& ar);
매개 변수
[in] ar
설명
CMFCBaseTabCtrl::SetActiveTab
지정된 탭을 활성화합니다.
virtual BOOL SetActiveTab(int iTab) = 0;
매개 변수
iTab
[in] 탭의 0부터 시작하는 인덱스입니다. SetActiveTab은 이 인덱스가 있는 탭을 활성화합니다.
Return Value
성공하면 TRUE이고, 실패하면 FALSE입니다.
설명
CMFCBaseTabCtrl Class에서 이 메서드는 순수 가상 함수입니다. CMFCBaseTabCtrl에서 클래스를 파생하는 경우 이 함수를 구현해야 합니다.
CMFCBaseTabCtrl::SetActiveTabColor
활성 탭의 배경색을 설정합니다.
virtual void SetActiveTabColor(COLORREF clr);
매개 변수
clr
[in] 새 배경색을 지정합니다.
설명
프레임워크는 GetSysColor 메서드에서 활성 탭의 기본 배경색을 가져옵니다.
CMFCBaseTabCtrl::SetActiveTabTextColor
활성 탭의 텍스트 색을 설정합니다.
virtual void SetActiveTabTextColor(COLORREF clr);
매개 변수
clr
[in] 새 텍스트 색상을 지정하는 COLORREF 매개 변수입니다.
설명
기본적으로 프레임워크는 GetSysColor에서 텍스트 색상을 가져옵니다. SetActiveTabTextColor 메서드를 사용하여 이 기본 색상을 재정의합니다.
CMFCBaseTabCtrl::SetAutoColors
프레임워크가 자동 색상 모드에서 사용하는 탭 컨트롤의 색상을 설정합니다.
void SetAutoColors(const CArray<COLORREF,COLORREF>& arColors);
매개 변수
arColors
[in] RGB 색상의 배열입니다.
설명
색의 사용자 지정 배열을 제공하는 경우 기본 색 배열은 무시됩니다. arColors 매개 변수가 비어 있으면 프레임워크는 기본 색 배열로 돌아갑니다.
autocolor 모드를 사용하도록 설정하려면 CMFCBaseTabCtrl::EnableAutoColor 메서드를 사용합니다.
CMFCBaseTabCtrl::SetDockingBarWrapperRTC
CDockablePane Class에서 파생되지 않은 개체에 사용되는 래퍼 클래스를 설정합니다.
void SetDockingBarWrapperRTC(CRuntimeClass* pRTC);
매개 변수
pRTC
[in] 새 래퍼 클래스에 대한 런타임 클래스 정보입니다.
설명
CMFCBaseTabCtrl::AddTab 및 CMFCBaseTabCtrl::InsertTab 메서드를 사용하여 탭 컨트롤에 탭을 추가합니다. 탭을 추가하면 해당 탭의 각 컨트롤은 도킹 가능해야 합니다. CDockablePane에서 파생되지 않은 모든 개체는 래핑해야 합니다. AddTab 및 InsertTab은 이러한 개체의 래퍼를 생성합니다. 기본 래퍼 클래스는 CDockablePaneAdapter 클래스입니다. SetDockingBarWrapperRTC 메서드를 사용하면 래퍼 클래스로 사용되는 클래스를 변경할 수 있습니다. 제공하는 래퍼 클래스는 CDockablePaneAdapter에서 파생되어야 합니다.
CMFCBaseTabCtrl::SetDrawNoPrefix
탭 레이블의 접두사 처리를 사용하거나 사용하지 않도록 설정합니다.
void SetDrawNoPrefix(
BOOL bNoPrefix,
BOOL bRedraw = TRUE);
매개 변수
bNoPrefix
[in] 접두사를 처리하려면 TRUE이고, 그렇지 않으면 FALSE입니다.
bRedraw
[in] 탭 창을 다시 그리려면 TRUE이고, 그렇지 않으면 FALSE입니다.
설명
접두사는 앰퍼샌드(&)가 앞에 오는 니모닉 문자입니다.
CMFCBaseTabCtrl::SetImageList
탭 컨트롤의 아이콘 이미지 목록을 설정합니다.
virtual BOOL SetImageList(
UINT uiID,
int cx = 15,
COLORREF clrTransp = RGB(255, 0, 255));
virtual BOOL SetImageList(HIMAGELIST hImageList);
매개 변수
uiID
[in] 비트맵 리소스 ID입니다. SetImageList는 이 리소스에서 이미지 목록을 로드합니다.
cx
[in] 각 이미지의 너비(픽셀)입니다.
clrTransp
[in] 이미지의 투명 색상을 나타내는 COLORREF 매개 변수입니다.
hImageList
[in] 사전 로드된 이미지 목록에 대한 핸들입니다.
Return Value
메서드가 성공한 경우 0이 아닌 값입니다. 그렇지 않은 경우 0입니다.
설명
아이콘 이미지 목록의 이미지는 탭 레이블과 함께 표시됩니다. 아이콘을 표시하려면 CMFCBaseTabCtrl::AddTab을 호출할 때 해당 인덱스를 지정해야 합니다.
탭 컨트롤이 플랫 스타일로 생성된 경우 SetImageList가 실패합니다. 프레임워크가 uiID로 표시된 이미지를 로드할 수 없는 경우에도 실패합니다.
이 메서드는 이미지 및 텍스트 크기에 따라 탭의 높이를 다시 계산합니다.
CMFCBaseTabCtrl::SetLocation
virtual void SetLocation(Location location);
매개 변수
[in] location
설명
CMFCBaseTabCtrl::SetTabBkColor
지정된 탭의 배경색을 설정합니다.
virtual BOOL SetTabBkColor(
int iTab,
COLORREF color = (COLORREF)-1);
매개 변수
iTab
[in] 탭의 0부터 시작하는 인덱스입니다.
color
[in] 설정할 색상입니다.
Return Value
성공하면 TRUE이고, 그렇지 않으면 FALSE입니다.
CMFCBaseTabCtrl::SetTabBorderSize
탭 컨트롤의 새 테두리 크기를 설정합니다.
virtual void SetTabBorderSize(
int nTabBorderSize,
BOOL bRepaint = TRUE);
매개 변수
nTabBorderSize
[in] 새 테두리 크기(픽셀)입니다.
bRepaint
[in] 프레임워크가 컨트롤을 다시 그리는지 여부를 나타내는 부울 매개 변수입니다.
CMFCBaseTabCtrl::SetTabHicon
탭 레이블의 아이콘을 설정합니다.
virtual BOOL SetTabHicon(
int iTab,
HICON hIcon);
매개 변수
iTab
[in] 탭의 0부터 시작하는 인덱스입니다. 이 메서드는 이 탭의 아이콘을 변경합니다.
hIcon
[in] 아이콘에 대한 핸들입니다.
Return Value
성공하면 TRUE이고, 실패하면 FALSE입니다.
CMFCBaseTabCtrl::SetTabIcon
탭의 아이콘을 설정합니다.
virtual BOOL SetTabIcon(
int iTab,
UINT uiIcon);
매개 변수
iTab
업데이트할 행의 0부터 시작하는 인덱스입니다.
uiIcon
[in] 새 아이콘의 아이콘 ID입니다. 이 ID는 내부 CImageList 개체를 참조합니다.
Return Value
성공하면 TRUE이고, 실패하면 FALSE입니다.
CMFCBaseTabCtrl::SetTabIconOnly
특정 탭에 아이콘(및 텍스트 레이블 없음)만 표시하도록 설정합니다.
virtual BOOL SetTabIconOnly(
int iTab,
BOOL bIconOnly = TRUE,
BOOL bShowTooltipAlways = FALSE);
매개 변수
iTab
[in] 변경할 탭의 0부터 시작하는 인덱스입니다.
bIconOnly
[in] 아이콘만 표시할지 여부를 결정하는 부울 매개 변수입니다.
bShowTooltipAlways
[in] 프레임워크에 아이콘만 표시하는 탭 레이블에 대한 도구 설명 표시 여부를 결정하는 부울 매개 변수입니다.
Return Value
성공하면 TRUE이고, 실패하면 FALSE입니다.
설명
기본적으로 탭 컨트롤은 각 탭의 아이콘 및 텍스트 레이블을 표시합니다.
CMFCBaseTabCtrl::SetTabLabel
탭 레이블에 대한 텍스트를 설정합니다.
virtual BOOL SetTabLabel(
int iTab,
const CString& strLabel);
매개 변수
iTab
업데이트할 행의 0부터 시작하는 인덱스입니다.
strLabel
[in] 탭 레이블에 대한 새 텍스트를 포함하는 문자열에 대한 참조입니다.
Return Value
성공하는 경우 0이 아닌 값입니다. 그렇지 않은 경우 0입니다.
CMFCBaseTabCtrl::SetTabsHeight
virtual void SetTabsHeight();
설명
CMFCBaseTabCtrl::SetTabsOrder
지정된 순서대로 탭을 정렬합니다.
BOOL SetTabsOrder(const CArray<int,int>& arOrder);
매개 변수
arOrder
[in] 새 탭 순서를 정의한 0부터 시작하는 인덱스 배열입니다.
Return Value
성공하면 TRUE이고, 그렇지 않으면 FAIL입니다.
설명
arOrder 배열의 크기는 탭 컨트롤의 탭 수와 같아야 합니다.
CMFCBaseTabCtrl::SetTabTextColor
지정된 탭의 텍스트 색을 설정합니다.
virtual BOOL SetTabTextColor(
int iTab,
COLORREF color = (COLORREF)-1);
매개 변수
iTab
[in] 탭의 0부터 시작하는 인덱스입니다.
color
[in] 새 텍스트 색상을 나타내는 COLORREF 매개 변수입니다.
Return Value
성공하는 경우 0이 아닌 값입니다. 그렇지 않은 경우 0입니다.
CMFCBaseTabCtrl::ShowTab
지정된 탭을 표시하거나 숨깁니다.
virtual BOOL ShowTab(
int iTab,
BOOL bShow = TRUE,
BOOL bRecalcLayout = TRUE,
BOOL bActivate = FALSE);
매개 변수
iTab
[in] ShowTab이 표시하거나 숨길 탭의 인덱스입니다.
bShow
[in] 탭을 표시할지 여부를 나타내는 부울 매개 변수입니다.
bRecalcLayout
[in] 창 레이아웃을 즉시 다시 계산할지 여부를 나타내는 부울 매개 변수입니다.
bActivate
[in] iTab으로 지정된 탭을 선택할지 여부를 나타내는 부울 매개 변수입니다.
Return Value
성공하면 0이 아니고, 그렇지 않으면 0입니다.
설명
bActivate 매개 변수는 bShow가 TRUE인 경우에만 적용됩니다. bActivate가 TRUE이고 ShowTab이 성공하면 ShowTab은 탭 창의 부모에 AFX_WM_CHANGE_ACTIVE_TAB 메시지를 보냅니다.
CMFCBaseTabCtrl::StartRenameTab
virtual BOOL StartRenameTab(int iTab);
매개 변수
[in] iTab
Return Value
설명
CMFCBaseTabCtrl::SwapTabs
virtual void SwapTabs(
int nFisrtTabID,
int nSecondTabID);
매개 변수
[in] nFisrtTabID
[in] nSecondTabID
설명
참고 항목
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기