CFrameWnd 클래스

창 관리를 위한 멤버와 함께 겹쳐진 Windows SDI(단일 문서 인터페이스) 또는 팝업 프레임 창의 기능을 제공합니다.

구문

class CFrameWnd : public CWnd

멤버

공용 생성자

속성	설명
CFrameWnd::CFrameWnd	CFrameWnd 개체를 생성합니다.

공용 메서드

이름	설명
CFrameWnd::ActivateFrame	프레임을 표시하고 사용자가 사용할 수 있도록 합니다.
CFrameWnd::BeginModalState	프레임 창을 모달로 설정합니다.
CFrameWnd::Create	개체와 연결된 CFrameWnd Windows 프레임 창을 만들고 초기화하기 위한 호출입니다.
CFrameWnd::CreateView	에서 파생되지 않은 프레임 내에 뷰를 CView만듭니다.
CFrameWnd::DockControlBar	컨트롤 막대를 도킹합니다.
CFrameWnd::EnableDocking	컨트롤 막대를 도킹할 수 있습니다.
CFrameWnd::EndModalState	프레임 창의 모달 상태를 종료합니다. 에서 사용하지 않도록 설정된 BeginModalState모든 창을 사용하도록 설정합니다.
CFrameWnd::FloatControlBar	컨트롤 막대를 부동합니다.
CFrameWnd::GetActiveDocument	활성 CDocument 개체를 반환합니다.
CFrameWnd::GetActiveFrame	활성 CFrameWnd 개체를 반환합니다.
CFrameWnd::GetActiveView	활성 CView 개체를 반환합니다.
CFrameWnd::GetControlBar	컨트롤 막대를 검색합니다.
CFrameWnd::GetDockState	프레임 창의 도크 상태를 검색합니다.
CFrameWnd::GetMenuBarState	현재 MFC 애플리케이션에서 메뉴의 표시 상태를 검색합니다.
CFrameWnd::GetMenuBarVisibility	현재 MFC 애플리케이션에서 메뉴의 기본 동작이 숨겨지거나 표시되는지 여부를 나타냅니다.
CFrameWnd::GetMessageBar	프레임 창에 속하는 상태 막대에 대한 포인터를 반환합니다.
CFrameWnd::GetMessageString	명령 ID에 해당하는 메시지를 검색합니다.
CFrameWnd::GetTitle	관련 컨트롤 막대의 제목을 검색합니다.
CFrameWnd::InitialUpdateFrame	프레임 창의 OnInitialUpdate 모든 보기에 속하는 멤버 함수를 호출합니다.
CFrameWnd::InModalState	프레임 창이 모달 상태인지 여부를 나타내는 값을 반환합니다.
CFrameWnd::IsTracking	분할 막대가 현재 이동 중인지 여부를 확인합니다.
CFrameWnd::LoadAccelTable	액셀러레이터 테이블을 로드하기 위한 호출입니다.
CFrameWnd::LoadBarState	제어 표시줄 설정을 복원하기 위해 호출합니다.
CFrameWnd::LoadFrame	리소스 정보에서 프레임 창을 동적으로 만들도록 호출합니다.
CFrameWnd::NegotiateBorderSpace	프레임 창의 테두리 공간을 협상합니다.
CFrameWnd::OnBarCheck	지정된 컨트롤 막대에서 작업이 수행될 때마다 호출됩니다.
CFrameWnd::OnContextHelp	현재 위치 항목에 대한 SHIFT+F1 도움말을 처리합니다.
CFrameWnd::OnSetPreviewMode	애플리케이션의 기본 프레임 창을 인쇄 미리 보기 모드로 또는 외부로 설정합니다.
CFrameWnd::OnUpdateControlBarMenu	연결된 메뉴가 업데이트될 때 프레임워크에서 호출됩니다.
CFrameWnd::RecalcLayout	개체의 컨트롤 막대 위치를 CFrameWnd 변경합니다.
CFrameWnd::SaveBarState	제어 표시줄 설정을 저장하려면 호출합니다.
CFrameWnd::SetActivePreviewView	지정된 보기를 리치 미리 보기의 활성 보기로 지정합니다.
CFrameWnd::SetActiveView	활성 CView 개체를 설정합니다.
CFrameWnd::SetDockState	기본 창에 프레임 창을 도킹하려면 호출합니다.
CFrameWnd::SetMenuBarState	현재 MFC 애플리케이션에서 메뉴의 표시 상태를 숨기거나 표시하도록 설정합니다.
CFrameWnd::SetMenuBarVisibility	현재 MFC 애플리케이션에서 메뉴의 기본 동작을 숨기거나 표시하도록 설정합니다.
CFrameWnd::SetMessageText	표준 상태 막대의 텍스트를 설정합니다.
CFrameWnd::SetProgressBarPosition	작업 표시줄에 표시되는 Windows 7 진행률 표시줄의 현재 위치를 설정합니다.
CFrameWnd::SetProgressBarRange	작업 표시줄에 표시되는 Windows 7 진행률 표시줄의 범위를 설정합니다.
CFrameWnd::SetProgressBarState	작업 표시줄 단추에 표시되는 진행률 표시기의 유형과 상태를 설정합니다.
CFrameWnd::SetTaskbarOverlayIcon	오버로드됨. 작업 표시줄 단추에 오버레이를 적용하여 사용자에게 애플리케이션 상태 또는 알림을 나타냅니다.
CFrameWnd::SetTitle	관련 컨트롤 막대의 제목을 설정합니다.
CFrameWnd::ShowControlBar	컨트롤 막대를 표시하려면 호출합니다.
CFrameWnd::ShowOwnedWindows	개체의 CFrameWnd 하위 항목인 모든 창을 표시합니다.

보호된 메서드

속성	설명
CFrameWnd::OnCreateClient	프레임에 대한 클라이언트 창을 만듭니다.
CFrameWnd::OnHideMenuBar	현재 MFC 애플리케이션의 메뉴가 숨겨지기 전에 호출됩니다.
CFrameWnd::OnShowMenuBar	현재 MFC 애플리케이션의 메뉴가 표시되기 전에 호출됩니다.

공용 데이터 멤버

이름	설명
CFrameWnd::m_bAutoMenuEnable	메뉴 항목에 대한 기능을 자동으로 사용하거나 사용하지 않도록 설정합니다.
CFrameWnd::rectDefault	Windows에서 창의 초기 크기와 위치를 선택할 수 있도록 개체를 CFrameWnd 만들 때 이 정적 CRect 을 매개 변수로 전달합니다.

설명

애플리케이션에 대한 유용한 프레임 창을 만들려면 .에서 CFrameWnd클래스를 파생합니다. 파생 클래스에 멤버 변수를 추가하여 애플리케이션과 관련된 데이터를 저장합니다. 파생 클래스에서 메시지 처리기 멤버 함수 및 메시지 맵을 구현하여 메시지가 창에 전달될 때 수행되는 작업을 지정합니다.

프레임 창을 생성하는 방법에는 세 가지가 있습니다.

• 를 사용하여 Create직접 생성합니다.

• 를 사용하여 LoadFrame직접 생성합니다.

• 문서 서식 파일을 사용하여 간접적으로 구성합니다.

호출 Create 하기 LoadFrame전에 C++ new 연산자를 사용하여 힙에서 프레임 창 개체를 생성해야 합니다. 호출 Create하기 전에 창 클래스를 전역 함수에 등록하여 프레임의 AfxRegisterWndClass 아이콘 및 클래스 스타일을 설정할 수도 있습니다.

멤버 함수를 Create 사용하여 프레임의 생성 매개 변수를 즉각적인 인수로 전달합니다.

LoadFrame에는 보다 Create적은 인수가 필요하고 대신 프레임의 캡션, 아이콘, 액셀러레이터 테이블 및 메뉴를 포함하여 리소스에서 대부분의 기본값을 검색합니다. 액세스 LoadFrame하려면 이러한 모든 리소스에 동일한 리소스 ID(예: IDR_MAINFRAME)가 있어야 합니다.

개체에 CFrameWnd 뷰와 문서가 포함된 경우 프로그래머가 직접 만드는 대신 프레임워크에 의해 간접적으로 만들어집니다. 개체는 CDocTemplate 프레임 만들기, 포함된 뷰 만들기 및 뷰를 적절한 문서에 연결하도록 오케스트레이션합니다. 생성자의 매개 변수 CDocTemplate 는 관련된 세 가지 클래스(문서, 프레임 및 뷰)를 지정 CRuntimeClass 합니다. CRuntimeClass 개체는 사용자가 지정한 경우(예: 파일 새로 만들기 명령 또는 MDI(다중 문서 인터페이스) Window New 명령을 사용하여) 프레임워크에서 새 프레임을 동적으로 만드는 데 사용됩니다.

위의 RUNTIME_CLASS 메커니즘이 제대로 작동하려면 파생된 CFrameWndDECLARE_DYNCREATE 프레임 창 클래스를 선언해야 합니다.

A CFrameWnd 에는 Windows용 일반적인 애플리케이션에서 기본 창의 다음 함수를 수행하는 기본 구현이 포함되어 있습니다.

• 프레임 창은 CFrameWnd Windows 활성 창 또는 현재 입력 포커스와 독립적인 현재 활성 보기를 추적합니다. 프레임이 다시 활성화되면 활성 보기는 호출 CView::OnActivateView을 통해 알림을 받습니다.

• 명령 메시지와 프레임 창에서 처리한 OnSetFocusOnHScroll메시지 및 OnVScroll 함수CWnd를 포함한 많은 일반적인 프레임 알림 메시지는 현재 활성 보기에 프레임 창에 의해 CFrameWnd 위임됩니다.

• 현재 활성 보기(또는 MDI 프레임의 경우 현재 활성 MDI 자식 프레임 창)는 프레임 창의 캡션 확인할 수 있습니다. 프레임 창의 스타일 비트를 해제 FWS_ADDTOTITLE 하여 이 기능을 사용하지 않도록 설정할 수 있습니다.

• 프레임 창은 CFrameWnd 프레임 창의 클라이언트 영역 내에서 컨트롤 막대, 보기 및 기타 자식 창의 위치를 관리합니다. 프레임 창은 도구 모음 및 기타 컨트롤 바 단추의 유휴 시간 업데이트도 수행합니다. CFrameWnd 프레임 창에는 도구 모음 및 상태 막대를 설정/해제하기 위한 명령의 기본 구현도 있습니다.

• 프레임 창은 CFrameWnd 기본 메뉴 모음을 관리합니다. 팝업 메뉴가 표시되면 프레임 창에서 메커니즘을 UPDATE_COMMAND_UI 사용하여 사용하거나 사용하지 않도록 설정하거나 검사 메뉴 항목을 결정합니다. 사용자가 메뉴 항목을 선택하면 프레임 창에서 상태 표시줄을 해당 명령에 대한 메시지 문자열로 업데이트합니다.

• CFrameWnd 프레임 창에는 키보드 가속기를 자동으로 변환하는 선택적 가속기 테이블이 있습니다.

• CFrameWnd 프레임 창에는 상황에 맞는 도움말에 사용되는 선택적 도움말 ID가 있습니다LoadFrame. 프레임 창은 상황에 맞는 도움말(SHIFT+F1) 및 인쇄 미리 보기 모드와 같은 반모달 상태의 기본 오케스트레이터입니다.

• CFrameWnd 프레임 창은 파일 관리자에서 끌어 프레임 창에 놓인 파일을 엽니다. 파일 확장 프로그램이 등록되고 애플리케이션과 연결된 경우 프레임 창은 사용자가 파일 관리자에서 데이터 파일을 열거나 Windows 함수가 호출될 때 ShellExecute 발생하는 DDE(동적 데이터 교환) 열기 요청에 응답합니다.

• 프레임 창이 기본 애플리케이션 창인 경우(즉, CWinThread::m_pMainWnd사용자가 애플리케이션을 닫을 때) 프레임 창에서 수정된 문서(for 및 OnQueryEndSession)를 OnClose 저장하라는 메시지가 표시됩니다.

• 프레임 창이 기본 애플리케이션 창인 경우 프레임 창은 WinHelp를 실행하기 위한 컨텍스트입니다. 이 애플리케이션에 대한 도움말을 위해 시작된 경우 프레임 창을 닫으면 종료 WINHELP.EXE 됩니다.

C++ delete 연산자를 사용하여 프레임 창을 삭제하지 마세요. 대신 CWnd::DestroyWindow을 사용합니다. 이 구현 PostNcDestroy 은 CFrameWnd 창이 제거될 때 C++ 개체를 삭제합니다. 사용자가 프레임 창을 닫으면 기본 OnClose 처리기가 호출 DestroyWindow됩니다.

자세한 내용은 CFrameWnd프레임 창을 참조 하세요.

상속 계층 구조

CObject

CCmdTarget

CWnd

CFrameWnd

요구 사항

헤더afxwin.h:

CFrameWnd::ActivateFrame

이 멤버 함수를 호출하여 프레임 창이 표시되고 사용자가 사용할 수 있도록 프레임 창을 활성화하고 복원합니다.

virtual void ActivateFrame(int nCmdShow = -1);

매개 변수

nCmdShow
에 전달할 매개 변수를 지정합니다 CWnd::ShowWindow. 기본적으로 프레임이 표시되고 올바르게 복원됩니다.

설명

이 멤버 함수는 일반적으로 DDE, OLE 또는 프레임 창 또는 해당 내용을 사용자에게 표시할 수 있는 다른 이벤트와 같은 비 사용자 인터페이스 이벤트 후에 호출됩니다.

기본 구현은 프레임을 활성화하고 Z 순서의 맨 위로 가져오고 필요한 경우 애플리케이션의 기본 프레임 창에 대해 동일한 단계를 수행합니다.

프레임 활성화 방법을 변경하려면 이 멤버 함수를 재정의합니다. 예를 들어 MDI 자식 창을 강제로 최대화할 수 있습니다. 적절한 기능을 추가한 다음 명시적 nCmdShow클래스 버전을 사용하여 기본 클래스 버전을 호출합니다.

예시

void CChildFrame::ActivateFrame(int nCmdShow)
{
   // Create the child frame window maximized
   nCmdShow = SW_MAXIMIZE;

   CMDIChildWnd::ActivateFrame(nCmdShow);
}

CFrameWnd::BeginModalState

프레임 창을 모달로 만들기 위해 이 멤버 함수를 호출합니다.

virtual void BeginModalState();

CFrameWnd::CFrameWnd

개체를 CFrameWnd 생성하지만 표시되는 프레임 창을 만들지는 않습니다.

CFrameWnd();

설명

표시되는 창을 만들려면 호출 Create 합니다.

CFrameWnd::Create

개체와 연결된 CFrameWnd Windows 프레임 창을 만들고 초기화하기 위한 호출입니다.

virtual BOOL Create(
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName,
    DWORD dwStyle = WS_OVERLAPPEDWINDOW,
    const RECT& rect = rectDefault,
    CWnd* pParentWnd = NULL,
    LPCTSTR lpszMenuName = NULL,
    DWORD dwExStyle = 0,
    CCreateContext* pContext = NULL);

매개 변수

lpszClassName
Windows 클래스의 이름을 지정하는 null로 끝나는 문자열을 가리킵니다. 클래스 이름은 전역 함수 또는 RegisterClass Windows 함수에 AfxRegisterWndClass 등록된 모든 이름일 수 있습니다. 이면 NULL미리 정의된 기본 CFrameWnd 특성을 사용합니다.

lpszWindowName
창 이름을 나타내는 null로 끝나는 문자열을 가리킵니다. 제목 표시줄의 텍스트로 사용됩니다.

dwStyle
창 스타일 특성을 지정합니다. 제목 표시줄에 FWS_ADDTOTITLE 창에 표시되는 문서의 이름을 자동으로 표시하려면 스타일을 포함합니다.

rect
창의 크기와 위치를 지정합니다. 이 rectDefault 값을 사용하면 Windows에서 새 창의 크기와 위치를 지정할 수 있습니다.

pParentWnd
이 프레임 창의 부모 창을 지정합니다. 이 매개 변수는 최상위 프레임 창에 대한 매개 변수여야 NULL 합니다.

lpszMenuName
창에 사용할 메뉴 리소스의 이름을 식별합니다. 메뉴에 문자열 대신 정수 ID가 있는 경우 사용합니다 MAKEINTRESOURCE . 이 매개 변수는 NULL일 수 있습니다.

dwExStyle
창 확장 스타일 특성을 지정합니다.

pContext
구조체에 대한 포인터를 CCreateContext 지정합니다. 이 매개 변수는 NULL일 수 있습니다.

Return Value

초기화에 성공하면 0이 아닌 값입니다. 그렇지 않으면 0입니다.

설명

두 단계로 개체를 CFrameWnd 생성합니다. 먼저 개체를 생성하는 CFrameWnd 생성자를 호출한 다음, 호출합니다. 이 생성 Create자는 Windows 프레임 창을 만들고 개체에 CFrameWnd 연결합니다. Create 창의 클래스 이름 및 창 이름을 초기화하고 스타일, 부모 및 관련 메뉴의 기본값을 등록합니다.

인수를 지정하는 대신 리소스에서 프레임 창을 로드하는 대신 Create 사용합니다LoadFrame.

CFrameWnd::CreateView

프레임 내에서 뷰를 만들려면 호출 CreateView 합니다.

CWnd* CreateView(
    CCreateContext* pContext,
    UINT nID = AFX_IDW_PANE_FIRST);

매개 변수

pContext
보기 및 문서의 형식을 지정합니다.

nID
보기의 ID 번호입니다.

Return Value

성공하면 개체에 대한 포인터입니다 CWnd . 그렇지 않으면 NULL.

설명

이 멤버 함수를 사용하여 프레임 내에서 파생되지 않은 CView"뷰"를 만듭니다. 호출 CreateView후 수동으로 보기를 활성으로 설정하고 표시되도록 설정해야 합니다. 이러한 작업은 자동으로 수행 CreateView되지 않습니다.

CFrameWnd::DockControlBar

컨트롤 막대가 프레임 창에 도킹되도록 합니다.

void DockControlBar(
    CControlBar* pBar,
    UINT nDockBarID = 0,
    LPCRECT lpRect = NULL);

매개 변수

pBar
도킹할 컨트롤 막대를 가리킵니다.

nDockBarID
도킹을 위해 고려할 프레임 창의 측면을 결정합니다. 0이거나 다음 중 하나 이상일 수 있습니다.

• AFX_IDW_DOCKBAR_TOP 프레임 창의 위쪽에 도킹합니다.

• AFX_IDW_DOCKBAR_BOTTOM 프레임 창의 아래쪽에 도킹합니다.

• AFX_IDW_DOCKBAR_LEFT 프레임 창의 왼쪽에 도킹합니다.

• AFX_IDW_DOCKBAR_RIGHT 프레임 창의 오른쪽에 도킹합니다.

0이면 대상 프레임 창에서 도킹할 수 있도록 설정된 모든 면에 컨트롤 막대를 도킹할 수 있습니다.

lpRect
화면 좌표에서 컨트롤 막대가 대상 프레임 창의 비클라이언트 영역에 도킹되는 위치를 결정합니다.

설명

컨트롤 막대는 둘 다 CControlBar::EnableDocking 에 대한 호출에 지정된 프레임 창의 측면 중 하나에 도킹됩니다 CFrameWnd::EnableDocking. 선택한 쪽은 .에 의해 nDockBarID결정됩니다.

CFrameWnd::EnableDocking

프레임 창에서 도킹 가능한 컨트롤 막대를 사용하도록 설정하려면 이 함수를 호출합니다.

void EnableDocking(DWORD dwDockStyle);

매개 변수

dwDockStyle
컨트롤 막대의 도킹 사이트로 사용할 수 있는 프레임 창의 측면을 지정합니다. 다음 중 하나 이상이 될 수 있습니다.

• CBRS_ALIGN_TOP 클라이언트 영역의 맨 위에 도킹할 수 있습니다.

• CBRS_ALIGN_BOTTOM 클라이언트 영역의 맨 아래에 도킹할 수 있습니다.

• CBRS_ALIGN_LEFT 클라이언트 영역의 왼쪽에 도킹을 허용합니다.

• CBRS_ALIGN_RIGHT 클라이언트 영역의 오른쪽에 도킹을 허용합니다.

• CBRS_ALIGN_ANY 클라이언트 영역의 어느 쪽에서나 도킹할 수 있습니다.

설명

기본적으로 컨트롤 막대는 위쪽, 아래쪽, 왼쪽, 오른쪽 순서로 프레임 창의 측면에 도킹됩니다.

예시

에 대한 예제를 CToolBar::Create참조하세요.

CFrameWnd::EndModalState

프레임 창을 모달에서 모덜리스로 변경하려면 이 멤버 함수를 호출합니다.

virtual void EndModalState();

설명

EndModalState 에서는 모든 창을 사용하지 않도록 설정합니다 BeginModalState.

CFrameWnd::FloatControlBar

컨트롤 막대가 프레임 창에 도킹되지 않도록 하려면 이 함수를 호출합니다.

void FloatControlBar(
    CControlBar* pBar,
    CPoint point,
    DWORD dwStyle = CBRS_ALIGN_TOP);

매개 변수

pBar
부동할 컨트롤 막대를 가리킵니다.

point
화면 좌표의 위치로, 컨트롤 막대의 왼쪽 위 모서리가 배치됩니다.

dwStyle
컨트롤 막대를 새 프레임 창 내에서 가로 또는 세로로 맞출지 여부를 지정합니다. 다음 중 하나일 수 있습니다.

• CBRS_ALIGN_TOP 컨트롤 막대의 방향을 세로로 지정합니다.

• CBRS_ALIGN_BOTTOM 컨트롤 막대의 방향을 세로로 지정합니다.

• CBRS_ALIGN_LEFT 컨트롤 막대의 가로 방향을 지정합니다.

• CBRS_ALIGN_RIGHT 컨트롤 막대의 가로 방향을 지정합니다.

가로 방향과 세로 방향을 모두 지정하는 스타일이 전달되면 도구 모음이 가로 방향으로 지정됩니다.

설명

일반적으로 이 작업은 프로그램이 이전 실행에서 설정을 복원할 때 애플리케이션 시작 시 수행됩니다.

이 함수는 사용자가 도킹에 사용할 수 없는 위치 위로 컨트롤 막대를 끌 때 왼쪽 마우스 단추를 놓아 놓기 작업을 수행할 때 프레임워크에서 호출됩니다.

CFrameWnd::GetActiveDocument

현재 활성 뷰에 연결된 현재 CDocument 에 대한 포인터를 가져오려면 이 멤버 함수를 호출합니다.

virtual CDocument* GetActiveDocument();

Return Value

현재 CDocument에 대한 포인터입니다. 현재 문서가 없으면 .를 반환합니다 NULL.

CFrameWnd::GetActiveFrame

MDI 프레임 창의 활성 MDI(다중 문서 인터페이스) 자식 창에 대한 포인터를 가져오려면 이 멤버 함수를 호출합니다.

virtual CFrameWnd* GetActiveFrame();

Return Value

활성 MDI 자식 창에 대한 포인터입니다. 애플리케이션이 SDI 애플리케이션이거나 MDI 프레임 창에 활성 문서가 없는 경우 암시적 this 포인터가 반환됩니다.

설명

활성 MDI 자식이 없거나 애플리케이션이 SDI(단일 문서 인터페이스)인 경우 암시적 this 포인터가 반환됩니다.

CFrameWnd::GetActiveView

이 멤버 함수를 호출하여 프레임 창 CFrameWnd()에 연결된 활성 뷰(있는 경우)에 대한 포인터를 가져옵니다.

CView* GetActiveView() const;

Return Value

현재 CView에 대한 포인터입니다. 현재 보기가 없으면 .를 반환합니다 NULL.

설명

이 함수는 MDI 기본 프레임 창(CMDIFrameWnd)에 대해 호출되면 반환 NULL 됩니다. MDI 애플리케이션에서 MDI 기본 프레임 창에는 연결된 보기가 없습니다. 대신 각 개별 자식 창( CMDIChildWnd)에 하나 이상의 연결된 보기가 있습니다. MDI 애플리케이션의 활성 보기는 먼저 활성 MDI 자식 창을 찾은 다음 해당 자식 창에 대한 활성 보기를 찾아서 가져올 수 있습니다. 활성 MDI 자식 창은 함수 MDIGetActive 를 호출하거나 GetActiveFrame 다음에 설명된 대로 찾을 수 있습니다.

CMDIFrameWnd *pFrame = (CMDIFrameWnd*)AfxGetApp()->GetMainWnd();

// Get the active MDI child window.
CMDIChildWnd *pChild = (CMDIChildWnd*)pFrame->GetActiveFrame();

// or CMDIChildWnd *pChild = pFrame->MDIGetActive();

// Get the active view attached to the active MDI child window.
CMyView *pView = (CMyView*)pChild->GetActiveView();

CFrameWnd::GetControlBar

ID와 연결된 컨트롤 막대에 대한 액세스 권한을 얻기 위해 호출 GetControlBar 합니다.

CControlBar* GetControlBar(UINT nID);

매개 변수

nID
컨트롤 막대의 ID 번호입니다.

Return Value

ID와 연결된 컨트롤 막대에 대한 포인터입니다.

설명

매개 변수는 nID 컨트롤 막대의 메서드에 Create 전달된 고유 식별자를 참조합니다. 컨트롤 막대에 대한 자세한 내용은 컨트롤 막대라는 항목을 참조하세요.

GetControlBar 는 컨트롤 막대가 부동이므로 현재 프레임의 자식 창이 아니더라도 반환됩니다.

CFrameWnd::GetDockState

개체에 프레임 창의 컨트롤 막대에 대한 상태 정보를 저장하려면 이 멤버 함수를 CDockState 호출합니다.

void GetDockState(CDockState& state) const;

매개 변수

state
반환 시 프레임 창 컨트롤 막대의 현재 상태를 포함합니다.

설명

그런 다음, 사용하거나 Serialize.를 사용하여 CDockState::SaveState 스토리지에 콘텐츠를 CDockState 쓸 수 있습니다. 나중에 컨트롤 막대를 이전 상태로 복원하려면 상태를 CDockState::LoadState 로드하거나 SerializeSetDockState 호출하여 이전 상태를 프레임 창의 컨트롤 막대에 적용합니다.

CFrameWnd::GetMenuBarState

현재 MFC 애플리케이션에서 메뉴의 표시 상태를 검색합니다.

virtual DWORD GetMenuBarState();

Return Value

반환 값에는 다음 값이 있을 수 있습니다.

• AFX_MBS_VISIBLE (0x01) - 메뉴가 표시됩니다.

• AFX_MBS_HIDDEN (0x02) - 메뉴가 숨겨져 있습니다.

설명

런타임 오류가 발생하면 이 메서드는 디버그 모드에서 어설션하고 클래스에서 파생된 예외를 CException 발생합니다.

CFrameWnd::GetMenuBarVisibility

현재 MFC 애플리케이션에서 메뉴의 기본 상태가 숨겨지거나 표시되는지 여부를 나타냅니다.

virtual DWORD CFrameWnd::GetMenuBarVisibility();

Return Value

이 메서드는 다음 값 중 하나를 반환합니다.

• AFX_MBV_KEEPVISIBLE (0x01) - 메뉴가 항상 표시되며 기본적으로 포커스가 없습니다.

• AFX_MBV_DISPLAYONFOCUS (0x02) - 메뉴는 기본적으로 숨겨집니다. 메뉴가 숨겨져 있으면 Alt 키를 눌러 메뉴를 표시하고 포커스를 지정합니다. 메뉴가 표시되면 ALT 또는 ESC 키를 눌러 숨깁니다.

• AFX_MBV_ DISPLAYONFOCUS | AFX_MBV_DISPLAYONF10 (0x06) - 메뉴는 기본적으로 숨겨집니다. 메뉴가 숨겨져 있으면 F10 키를 눌러 메뉴를 표시하고 포커스를 지정합니다. 메뉴가 표시되면 F10 키를 눌러 메뉴에서 포커스를 전환하거나 해제합니다. ALT 또는 ESC 키를 눌러 숨길 때까지 메뉴가 표시됩니다.

설명

런타임 오류가 발생하면 이 메서드는 디버그 모드에서 어설션하고 클래스에서 파생된 예외를 CException 발생합니다.

CFrameWnd::GetMessageBar

이 멤버 함수를 호출하여 상태 막대에 대한 포인터를 가져옵니다.

virtual CWnd* GetMessageBar();

Return Value

상태 막대 창에 대한 포인터입니다.

CFrameWnd::GetMessageString

명령 ID에 대한 사용자 지정 문자열을 제공하도록 이 함수를 재정의합니다.

virtual void GetMessageString(
    UINT nID,
    CString& rMessage) const;

매개 변수

nID
원하는 메시지의 리소스 ID입니다.

rMessage
CString 메시지를 배치할 개체입니다.

설명

기본 구현은 리소스 파일에서 지정한 nID 문자열만 로드합니다. 이 함수는 상태 표시줄의 메시지 문자열을 업데이트해야 하는 경우 프레임워크에서 호출됩니다.

CFrameWnd::GetTitle

창 개체의 제목을 검색합니다.

CString GetTitle() const;

Return Value

CString 창 개체의 현재 제목을 포함하는 개체입니다.

CFrameWnd::InitialUpdateFrame

를 사용하여 새 프레임Create을 만든 후 호출 IntitialUpdateFrame 합니다.

void InitialUpdateFrame(
    CDocument* pDoc,
    BOOL bMakeVisible);

매개 변수

pDoc
프레임 창이 연결된 문서를 가리킵니다. NULL일 수 있습니다.

bMakeVisible
이면 TRUE프레임이 표시되고 활성화되어야 했음을 나타냅니다. 이 경우 FALSE하위 항목이 표시되지 않습니다.

설명

이렇게 하면 해당 프레임 창의 모든 보기가 호출을 받습니다 OnInitialUpdate .

또한 이전에 활성 보기가 없는 경우 프레임 창의 기본 보기가 활성화됩니다. 기본 보기는 자식 ID가 .인 AFX_IDW_PANE_FIRST보기입니다. 마지막으로 0이 아닌 경우 bMakeVisible 프레임 창이 표시됩니다. 0이면 bMakeVisible 프레임 창의 현재 포커스와 표시 상태가 변경되지 기본. 프레임워크의 파일 새로 만들기 및 파일 열기 구현을 사용하는 경우 이 함수를 호출할 필요가 없습니다.

CFrameWnd::InModalState

프레임 창이 모달이거나 모덜리스인 경우 이 멤버 함수를 호출하여 검사.

BOOL InModalState() const;

Return Value

0이 아닌 경우 그렇지 않으면 0입니다.

CFrameWnd::IsTracking

이 멤버 함수를 호출하여 창의 분할 막대가 현재 이동 중인지 확인합니다.

BOOL IsTracking() const;

Return Value

분할자 작업이 진행 중인 경우 0이 아닌 경우 그렇지 않으면 0입니다.

CFrameWnd::LoadAccelTable

지정된 액셀러레이터 테이블을 로드하기 위한 호출입니다.

BOOL LoadAccelTable(LPCTSTR lpszResourceName);

매개 변수

lpszResourceName
액셀러레이터 리소스의 이름을 식별합니다. 리소스가 정수 ID로 식별되는 경우 사용합니다 MAKEINTRESOURCE .

Return Value

가속기 테이블이 성공적으로 로드된 경우 0이 아닌 경우 그렇지 않으면 0입니다.

설명

한 번에 하나의 테이블만 로드할 수 있습니다.

리소스에서 로드된 가속기 테이블은 애플리케이션이 종료될 때 자동으로 해제됩니다.

프레임 창을 만들기 위해 호출 LoadFrame 하는 경우 프레임워크는 메뉴 및 아이콘 리소스와 함께 액셀러레이터 테이블을 로드하고 이 멤버 함수에 대한 후속 호출은 필요하지 않습니다.

CFrameWnd::LoadBarState

프레임 창에서 소유한 각 컨트롤 막대의 설정을 복원하려면 이 함수를 호출합니다.

void LoadBarState(LPCTSTR lpszProfileName);

매개 변수

lpszProfileName
초기화(INI) 파일의 섹션 이름 또는 상태 정보가 저장되는 Windows 레지스트리의 키입니다.

설명

복원된 정보에는 표시 유형, 가로/세로 방향, 도킹 상태 및 컨트롤 바 위치가 포함됩니다.

복원하려는 설정은 호출 LoadBarState하기 전에 레지스트리에 기록해야 합니다. 를 호출 CWinApp::SetRegistryKey하여 레지스트리에 정보를 씁니다. 를 호출 SaveBarState하여 INI 파일에 정보를 씁니다.

CFrameWnd::LoadFrame

리소스 정보에서 프레임 창을 동적으로 만들도록 호출합니다.

virtual BOOL LoadFrame(
    UINT nIDResource,
    DWORD dwDefaultStyle = WS_OVERLAPPEDWINDOW | FWS_ADDTOTITLE,
    CWnd* pParentWnd = NULL,
    CCreateContext* pContext = NULL);

매개 변수

nIDResource
프레임 창과 연결된 공유 리소스의 ID입니다.

dwDefaultStyle
프레임의 스타일입니다. 제목 표시줄에 FWS_ADDTOTITLE 창에 표시되는 문서의 이름을 자동으로 표시하려면 스타일을 포함합니다.

pParentWnd
프레임의 부모에 대한 포인터입니다.

pContext
구조체에 대한 포인터입니다 CCreateContext . 이 매개 변수는 NULL일 수 있습니다.

설명

두 단계로 개체를 CFrameWnd 생성합니다. 먼저 개체를 생성하는 CFrameWnd 생성자를 호출한 다음, 호출합니다. 이 생성 LoadFrame자는 Windows 프레임 창 및 관련 리소스를 로드하고 프레임 창을 개체에 CFrameWnd 연결합니다. 매개 변수는 nIDResource 프레임 창에 대한 타이틀의 메뉴, 액셀러레이터 테이블, 아이콘 및 문자열 리소스를 지정합니다.

프레임 창의 Create 모든 생성 매개 변수를 지정하려는 경우 대신 LoadFrame 멤버 함수를 사용합니다.

프레임워크는 문서 템플릿 개체를 사용하여 프레임 창을 만들 때 호출 LoadFrame 합니다.

프레임워크는 인수를 pContext 사용하여 포함된 뷰 개체를 포함하여 프레임 창에 연결할 개체를 지정합니다. 호출LoadFrame할 때 인수를 pContextNULL 설정할 수 있습니다.

CFrameWnd::m_bAutoMenuEnable

이 데이터 멤버를 사용하도록 설정하면(기본값) 사용자가 메뉴를 풀다운할 때 없는 ON_UPDATE_COMMAND_UI 메뉴 항목이나 ON_COMMAND 처리기가 자동으로 비활성화됩니다.

BOOL m_bAutoMenuEnable;

설명

처리기가 있지만 처리기가 없는 ON_UPDATE_COMMAND_UI 메뉴 항목 ON_COMMAND 은 자동으로 사용하도록 설정됩니다.

이 데이터 멤버를 설정하면 도구 모음 단추를 사용하는 것과 동일한 방식으로 메뉴 항목이 자동으로 활성화됩니다.

참고 항목

m_bAutoMenuEnable 는 최상위 메뉴 항목에 영향을 주지 않습니다.

이 데이터 멤버는 현재 선택에 따라 선택적 명령의 구현을 간소화하고 메뉴 항목을 사용하도록 설정하고 사용하지 않도록 설정하기 위한 처리기를 작성 ON_UPDATE_COMMAND_UI 할 필요가 줄어듭니다.

예시

// CMainFrame is application-defined object of type CFrameWnd
CMainFrame::CMainFrame()
    : m_hDrawMenu(NULL), m_hDrawAccel(NULL), m_bCheck(false), m_nWindowTimer(0), m_nCallbackTimer(0)
{
   // Set to FALSE so no ON_UPDATE_COMMAND_UI
   // or ON_COMMAND handlers are needed, and
   // CMenu::EnableMenuItem() will work as expected.
   m_bAutoMenuEnable = FALSE;
}

CFrameWnd::NegotiateBorderSpace

이 멤버 함수를 호출하여 OLE 위치 활성화 중에 프레임 창의 테두리 공간을 협상합니다.

virtual BOOL NegotiateBorderSpace(
    UINT nBorderCmd,
    LPRECT lpRectBorder);

매개 변수

nBorderCmd
다음 값 enum BorderCmd중 하나를 포함합니다.

• borderGet = 1

• borderRequest = 2

• borderSet = 3

lpRectBorder
테두리의 RECT 좌표를 지정하는 구조체 또는 CRect 개체에 대한 포인터입니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

설명

이 멤버 함수는 OLE 테두리 공간 협상의 구현입니다 CFrameWnd .

CFrameWnd::OnBarCheck

지정된 컨트롤 막대에서 작업이 수행될 때마다 호출됩니다.

afx_msg BOOL OnBarCheck(UINT nID);

매개 변수

nID
표시할 컨트롤 막대의 ID입니다.

Return Value

컨트롤 막대가 있는 경우 0이 아닌 경우 그렇지 않으면 0입니다.

CFrameWnd::OnContextHelp

현재 위치 항목에 대한 SHIFT+F1 도움말을 처리합니다.

afx_msg void OnContextHelp();

설명

상황에 맞는 도움말을 사용하도록 설정하려면 다음을 추가해야 합니다.

ON_COMMAND(ID_CONTEXT_HELP, &CMainFrame::OnContextHelp)

클래스 메시지 맵에 CFrameWnd 문을 추가하고 이 멤버 함수를 사용하도록 설정하기 위해 accelerator-table 항목(일반적으로 SHIFT+F1)을 추가합니다.

애플리케이션이 OLE 컨테이너 OnContextHelp 인 경우 프레임 창 개체에 포함된 모든 현재 위치 항목을 도움말 모드로 전환합니다. 커서가 화살표와 물음표로 바뀌면 마우스 포인터를 이동하고 마우스 왼쪽 단추를 눌러 대화 상자, 창, 메뉴 또는 명령 단추를 선택할 수 있습니다. 이 멤버 함수는 커서 아래에 있는 개체의 도움말 컨텍스트를 사용하여 Windows 함수 WinHelp 를 호출합니다.

CFrameWnd::OnCreateClient

를 실행하는 동안 프레임워크에서 호출됩니다 OnCreate.

virtual BOOL OnCreateClient(
    LPCREATESTRUCT lpcs,
    CCreateContext* pContext);

매개 변수

lpcs
Windows CREATESTRUCT 구조체에 대한 포인터입니다.

pContext
구조체에 대한 포인터입니다 CCreateContext .

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

설명

이 함수를 호출하지 마세요.

이 함수의 기본 구현은 가능한 경우 제공된 pContext정보에서 개체를 만듭니다CView.

개체에 전달된 값을 재정의 CCreateContext 하거나 프레임 창의 기본 클라이언트 영역에서 컨트롤을 만드는 방법을 변경하려면 이 함수를 재정의합니다. 재정의할 수 있는 멤버는 CCreateContext 클래스에 CCreateContext 설명되어 있습니다.

참고 항목

구조체에 CREATESTRUCT 전달된 값을 대체하지 마세요. 정보 제공 전용입니다. 예를 들어 초기 창 사각형을 재정의하려면 멤버 함수PreCreateWindow를 재정의 CWnd 합니다.

CFrameWnd::OnHideMenuBar

이 함수는 시스템이 현재 MFC 애플리케이션에서 메뉴 모음을 숨기려고 할 때 호출됩니다.

virtual void OnHideMenuBar();

설명

이 이벤트 처리기를 사용하면 시스템이 메뉴를 숨기려고 할 때 애플리케이션에서 사용자 지정 작업을 수행할 수 있습니다. 메뉴가 숨겨지는 것을 막을 수는 없지만, 예를 들어 다른 메서드를 호출하여 메뉴 스타일이나 상태를 검색할 수 있습니다.

CFrameWnd::OnSetPreviewMode

애플리케이션의 주 프레임 창을 인쇄 미리 보기 모드 내부 및 외부로 설정하려면 이 멤버 함수를 호출합니다.

virtual void OnSetPreviewMode(
    BOOL bPreview,
    CPrintPreviewState* pState);

매개 변수

bPreview
애플리케이션을 인쇄 미리 보기 모드로 배치할지 여부를 지정합니다. 인쇄 미리 보기에 배치되도록 TRUE 설정하여 미리 보기 FALSE 모드를 취소합니다.

pState
구조체에 대한 포인터입니다 CPrintPreviewState .

설명

기본 구현은 모든 표준 도구 모음을 사용하지 않도록 설정하고 기본 메뉴와 기본 클라이언트 창을 숨깁니다. 그러면 MDI 프레임 창이 임시 SDI 프레임 창으로 바뀝니다.

인쇄 미리 보기 중에 컨트롤 막대 및 기타 프레임 창 파트의 숨기기 및 표시를 사용자 지정하려면 이 멤버 함수를 재정의합니다. 재정의된 버전 내에서 기본 클래스 구현을 호출합니다.

CFrameWnd::OnShowMenuBar

이 함수는 시스템이 현재 MFC 애플리케이션에 메뉴 모음을 표시하려고 할 때 호출됩니다.

virtual void OnShowMenuBar();

설명

이 이벤트 처리기를 사용하면 메뉴가 표시될 때 애플리케이션에서 사용자 지정 작업을 수행할 수 있습니다. 메뉴가 표시되지 않도록 방지할 수는 없지만, 예를 들어 다른 메서드를 호출하여 메뉴 스타일이나 상태를 검색할 수 있습니다.

CFrameWnd::OnUpdateControlBarMenu

연결된 메뉴가 업데이트될 때 프레임워크에서 호출됩니다.

afx_msg void OnUpdateControlBarMenu(CCmdUI* pCmdUI);

매개 변수

pCmdUI
업데이트 명령을 생성한 메뉴를 나타내는 개체에 대한 포인터 CCmdUI 입니다. 업데이트 처리기는 개체 pCmdUI 의 Enable 멤버 함수를 CCmdUI 호출하여 사용자 인터페이스를 업데이트합니다.

CFrameWnd::RecalcLayout

표준 컨트롤 막대를 설정/해제하거나 프레임 창의 크기를 조정할 때 프레임워크에서 호출됩니다.

virtual void RecalcLayout(BOOL bNotify = TRUE);

매개 변수

bNotify
프레임 창의 현재 위치 항목이 레이아웃 변경 알림을 받는지 여부를 결정합니다. 이면 TRUE항목에 알림이 표시되고, 그렇지 않으면 FALSE.

설명

이 멤버 함수의 기본 구현은 멤버 함수를 호출 CWnd 하여 프레임의 모든 컨트롤 막대와 기본 클라이언트 창(일반적으로 a CView 또는 MDICLIENT)의 위치를 변경 RepositionBars 합니다.

프레임 창의 레이아웃이 변경된 후 컨트롤 막대의 모양과 동작을 제어하려면 이 멤버 함수를 재정의합니다. 예를 들어 컨트롤 막대를 켜거나 끄거나 다른 컨트롤 막대를 추가할 때 호출합니다.

CFrameWnd::rectDefault

Windows에서 창의 초기 크기와 위치를 선택할 수 있도록 창을 만들 때 이 정적 CRect 을 매개 변수로 전달합니다.

static AFX_DATA const CRect rectDefault;

CFrameWnd::SaveBarState

프레임 창이 소유한 각 컨트롤 막대에 대한 정보를 저장하려면 이 함수를 호출합니다.

void SaveBarState(LPCTSTR lpszProfileName) const;

매개 변수

lpszProfileName
초기화 파일의 섹션 이름 또는 상태 정보가 저장되는 Windows 레지스트리의 키입니다.

설명

이 정보는 .를 사용하여 LoadBarState초기화 파일에서 읽을 수 있습니다. 저장된 정보에는 표시 유형, 가로/세로 방향, 도킹 상태 및 제어 막대 위치가 포함됩니다.

CFrameWnd::SetActivePreviewView

지정된 보기를 리치 미리 보기의 활성 보기로 지정합니다.

void SetActivePreviewView(CView* pViewNew);

매개 변수

pViewNew
활성화할 뷰에 대한 포인터입니다.

설명

CFrameWnd::SetActiveView

이 멤버 함수를 호출하여 활성 보기를 설정합니다.

void SetActiveView(
    CView* pViewNew,
    BOOL bNotify = TRUE);

매개 변수

pViewNew
개체에 대한 포인터를 지정하거나 NULL 활성 보기가 없도록 CView 지정합니다.

bNotify
뷰에 활성화 알림을 받을지 여부를 지정합니다. OnActivateView 이면 TRUE새 뷰에 대해 호출되고, 그렇지 않으면 FALSE호출됩니다.

설명

프레임워크는 사용자가 프레임 창 내의 보기로 포커스를 변경하면 이 함수를 자동으로 호출합니다. 명시적으로 호출 SetActiveView 하여 포커스를 지정된 뷰로 변경할 수 있습니다.

CFrameWnd::SetDockState

개체에 저장된 상태 정보를 프레임 창의 컨트롤 막대에 CDockState 적용하려면 이 멤버 함수를 호출합니다.

void SetDockState(const CDockState& state);

매개 변수

state
프레임 창의 컨트롤 막대에 저장된 상태를 적용합니다.

설명

컨트롤 막대의 이전 상태를 복원하려면 저장된 상태를 CDockState::LoadState 사용하거나 Serialize프레임 창의 컨트롤 막대에 적용하는 데 사용할 SetDockState 수 있습니다. 이전 상태는 다음을 사용하여 개체에 CDockState 저장됩니다. GetDockState

CFrameWnd::SetMenuBarState

현재 MFC 애플리케이션에서 메뉴의 표시 상태를 숨기거나 표시하도록 설정합니다.

virtual BOOL SetMenuBarState(DWORD nState);

매개 변수

nState
[in] 메뉴를 표시하거나 숨길지 여부를 지정합니다. 매개 변수에는 nState 다음 값이 있을 수 있습니다.

• AFX_MBS_VISIBLE (0x01) - 메뉴가 숨겨져 있지만 표시되는 경우 아무런 영향을 주지 않으면 메뉴를 표시합니다.
• AFX_MBS_HIDDEN (0x02) - 표시되는 경우 메뉴를 숨기지만 숨겨진 경우에는 아무런 영향을 주지 않습니다.

Return Value

TRUE이 메서드가 메뉴 상태를 성공적으로 변경하면 이고, 그렇지 않으면 . FALSE

설명

런타임 오류가 발생하면 이 메서드는 디버그 모드에서 어설션하고 클래스에서 파생된 예외를 CException 발생합니다.

CFrameWnd::SetMenuBarVisibility

현재 MFC 애플리케이션에서 메뉴의 기본 동작을 숨기거나 표시하도록 설정합니다.

virtual void SetMenuBarVisibility(DWORD nStyle);

매개 변수

nStyle
[in] 메뉴가 기본적으로 숨겨져 있는지, 아니면 표시되고 포커스가 있는지 여부를 지정합니다. 매개 변수에는 nStyle 다음 값이 있을 수 있습니다.

• AFX_MBV_KEEPVISIBLE (0x01) - 메뉴가 항상 표시되며 기본적으로 포커스가 없습니다.

• AFX_MBV_DISPLAYONFOCUS (0x02) - 메뉴는 기본적으로 숨겨집니다. 메뉴가 숨겨져 있으면 Alt 키를 눌러 메뉴를 표시하고 포커스를 지정합니다. 메뉴가 표시되면 ALT 또는 ESC 키를 눌러 메뉴를 숨깁니다.

• AFX_MBV_DISPLAYONFOCUS | AFX_MBV_DISPLAYONF10 (0x06) - 메뉴는 기본적으로 숨겨집니다. 메뉴가 숨겨져 있으면 F10 키를 눌러 메뉴를 표시하고 포커스를 지정합니다. 메뉴가 표시되면 F10 키를 눌러 메뉴에서 포커스를 전환하거나 해제합니다. ALT 또는 ESC 키를 눌러 숨길 때까지 메뉴가 표시됩니다.

설명

매개 변수 값 nStyle 이 유효하지 않으면 이 메서드는 디버그 모드에서 어설션되고 릴리스 모드에서 발생합니다 CInvalidArgException . 다른 런타임 오류의 경우 이 메서드는 디버그 모드에서 어설션하고 클래스에서 파생된 예외를 CException 발생합니다.

이 메서드는 Windows Vista 이상용으로 작성된 애플리케이션의 메뉴 상태에 영향을 줍니다.

CFrameWnd::SetMessageText

ID가 0인 상태 막대 창에 문자열을 배치하려면 이 함수를 호출합니다.

void SetMessageText(LPCTSTR lpszText);
void SetMessageText(UINT nID);

매개 변수

lpszText
상태 막대에 배치할 문자열을 가리킵니다.

nID
상태 막대에 배치할 문자열의 문자열 리소스 ID입니다.

설명

일반적으로 상태 막대의 가장 왼쪽 및 가장 긴 창입니다.

CFrameWnd::SetProgressBarPosition

작업 표시줄에 표시되는 Windows 7 진행률 표시줄의 현재 위치를 설정합니다.

void SetProgressBarPosition(int nProgressPos);

매개 변수

nProgressPos
설정할 위치를 지정합니다. 에 의해 SetProgressBarRange설정된 범위 내에 있어야 합니다.

설명

CFrameWnd::SetProgressBarRange

작업 표시줄에 표시되는 Windows 7 진행률 표시줄의 범위를 설정합니다.

void SetProgressBarRange(
    int nRangeMin,
    int nRangeMax);

매개 변수

nRangeMin
최소값입니다.

nRangeMax
최대값입니다.

설명

CFrameWnd::SetProgressBarState

작업 표시줄 단추에 표시되는 진행률 표시기의 유형과 상태를 설정합니다.

void SetProgressBarState(TBPFLAG tbpFlags);

매개 변수

tbpFlags
진행률 단추의 현재 상태를 제어하는 플래그입니다. 모든 상태는 상호 배타TBPF_NOPROGRESSTBPF_ERRORTBPF_INDETERMINATETBPF_NORMALTBPF_PAUSED적이므로 다음 플래그 중 하나만 지정합니다.

설명

CFrameWnd::SetTaskbarOverlayIcon

오버로드됨. 작업 표시줄 단추에 오버레이를 적용하여 애플리케이션 상태 나타내거나 사용자에게 알립니다.

BOOL SetTaskbarOverlayIcon(
    UINT nIDResource,
    LPCTSTR lpcszDescr);

BOOL SetTaskbarOverlayIcon(
    HICON hIcon,
    LPCTSTR lpcszDescr);

매개 변수

nIDResource
오버레이로 사용할 아이콘의 리소스 ID를 지정합니다. 자세한 내용은 설명을 hIcon 참조하세요.

lpcszDescr
접근성을 위해 오버레이로 전달되는 정보의 대체 텍스트 버전을 제공하는 문자열에 대한 포인터입니다.

hIcon
오버레이로 사용할 아이콘의 핸들입니다. 이 아이콘은 인치당 96개 점(dpi)에서 16x16 픽셀을 측정하는 작은 아이콘이어야 합니다. 오버레이 아이콘이 작업 표시줄 단추에 이미 적용된 경우 기존 오버레이가 바뀝니다. 이 값은 NULL일 수 있습니다. NULL 값이 처리되는 방법은 작업 표시줄 단추가 단일 창 또는 창 그룹을 나타내는지 여부에 따라 달라집니다. 더 이상 필요하지 않을 때는 호출 애플리케이션 hIcon 의 책임입니다.

Return Value

TRUE 성공하면 FALSE OS 버전이 Windows 7보다 작거나 아이콘을 설정하는 동안 오류가 발생하는 경우

설명

CFrameWnd::SetTitle

창 개체의 제목을 설정합니다.

void SetTitle(LPCTSTR lpszTitle);

매개 변수

lpszTitle
창 개체의 제목을 포함하는 문자열에 대한 포인터입니다.

CFrameWnd::ShowControlBar

이 멤버 함수를 호출하여 컨트롤 막대를 표시하거나 숨깁니다.

void ShowControlBar(
    CControlBar* pBar,
    BOOL bShow,
    BOOL bDelay);

매개 변수

pBar
표시하거나 숨길 컨트롤 막대에 대한 포인터입니다.

bShow
이면 TRUE컨트롤 막대가 표시되도록 지정합니다. 이면 FALSE컨트롤 막대를 숨기도록 지정합니다.

bDelay
이면 TRUE컨트롤 막대 표시를 지연합니다. 이면 FALSE컨트롤 막대를 즉시 표시합니다.

CFrameWnd::ShowOwnedWindows

개체의 하위 항목인 모든 창을 표시하려면 이 멤버 함수를 CFrameWnd 호출합니다.

void ShowOwnedWindows(BOOL bShow);

매개 변수

bShow
소유된 창을 표시할지 숨길지 여부를 지정합니다.

참고 항목

CWnd 클래스
계층 구조 차트
CWnd 클래스
CMDIFrameWnd 클래스
CMDIChildWnd 클래스
CView 클래스
CDocTemplate 클래스
CRuntimeClass 구조