COleCmdUI 클래스

애플리케이션의 IOleCommandTarget기반 기능과 관련된 사용자 인터페이스 개체의 상태를 업데이트하기 위한 MFC용 메서드를 구현합니다.

구문

class COleCmdUI : public CCmdUI

멤버

공용 생성자

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

공용 메서드

이름	설명
COleCmdUI::Enable	사용 명령 플래그를 설정하거나 지웁니다.
COleCmdUI::SetCheck	설정/해제 토글 명령의 상태를 설정합니다.
COleCmdUI::SetText	명령에 대한 텍스트 이름 또는 상태 문자열을 반환합니다.

설명

DocObjects에 사용하도록 설정되지 않은 애플리케이션에서 사용자가 애플리케이션의 메뉴를 볼 때 MFC는 UPDATE_COMMAND_UI 알림을 처리합니다. 각 알림에는 특정 명령의 상태를 반영하도록 조작할 수 있는 CCmdUI 개체가 제공됩니다. 그러나 애플리케이션이 DocObjects에 사용하도록 설정된 경우 MFC는 UPDATE_OLE_COMMAND_UI 알림을 처리하고 개체를 할당합니다 COleCmdUI .

COleCmdUI 를 사용하면 DocObject가 컨테이너의 사용자 인터페이스(예: FileNew, Open, Print 등)에서 시작된 명령을 수신할 수 있으며, 컨테이너가 DocObject의 사용자 인터페이스에서 시작된 명령을 수신할 수 있습니다. 동일한 명령을 IOleCommandTarget 디스패치하는 데 사용할 수 있지만 IDispatch 일반적으로 인수 없이 표준 명령 집합을 사용하며 형식 정보가 관련되지 않으므로 더 간단한 쿼리 및 실행 방법을 제공합니다. COleCmdUI 은 DocObject 사용자 인터페이스 명령의 다른 속성을 사용, 업데이트 및 설정하는 데 사용할 수 있습니다. 명령을 호출하려면 COleServerDoc::OnExecOleCmd를 호출합니다.

DocObjects에 대한 자세한 내용은 CDocObjectServer 및 CDocObjectServerItem을 참조하세요.

상속 계층 구조

CCmdUI

COleCmdUI

요구 사항

헤더: afxdocob.h

COleCmdUI::COleCmdUI

COleCmdUI 특정 사용자 인터페이스 명령과 연결된 개체를 생성합니다.

COleCmdUI(
    OLECMD* rgCmds,
    ULONG cCmds,
    const GUID* m_pGroup);

매개 변수

rgCmds
지정된 GUID와 연결된 지원되는 명령 목록입니다. 구조체는 OLECMD 명령을 명령 플래그와 연결합니다.

cCmds
rgCmds의 명령 수입니다.

pGroup
명령 집합을 식별하는 GUID에 대한 포인터입니다.

설명

이 개체는 COleCmdUI 메뉴 항목 또는 컨트롤 바 단추와 같은 DocObject 사용자 인터페이스 개체를 업데이트하기 위한 프로그래밍 방식 인터페이스를 제공합니다. 사용자 인터페이스 개체는 개체를 통해 COleCmdUI 사용, 사용 안 함, 검사 및/또는 지울 수 있습니다.

COleCmdUI::Enable

이 함수를 호출하여 개체의 COleCmdUI 명령 플래그를 OLECOMDF_ENABLED 설정하여 인터페이스에 명령을 사용할 수 있고 사용하도록 설정하거나 명령 플래그를 지웁니다.

virtual void Enable(BOOL bOn);

매개 변수

본
개체와 COleCmdUI 연결된 명령을 사용하도록 설정하거나 사용하지 않도록 설정할지 여부를 나타냅니다. 0이 아닌 경우 명령을 사용하도록 설정합니다. 0은 명령을 사용하지 않도록 설정합니다.

COleCmdUI::SetCheck

이 함수를 호출하여 설정/해제 토글 명령의 상태를 설정합니다.

virtual void SetCheck(int nCheck);

매개 변수

nCheck
켜기/끄기 토글 명령을 설정할 상태를 결정하는 값입니다. 값:

값	Description
1	명령을 켜도록 설정합니다.
2	확정되지 않은 명령을 설정합니다. 이 명령의 특성이 관련 선택 영역의 켜기 및 끄기 상태에 있으므로 상태를 확인할 수 없습니다.
기타 모든 값	명령을 해제로 설정합니다.

COleCmdUI::SetText

명령의 텍스트 이름 또는 상태 문자열을 반환하려면 이 함수를 호출합니다.

virtual void SetText(LPCTSTR lpszText);

매개 변수

lpszText
명령과 함께 사용할 텍스트에 대한 포인터입니다.

참고 항목

CCmdUI 클래스
계층 구조 차트