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을 참조하세요.
상속 계층 구조
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
명령과 함께 사용할 텍스트에 대한 포인터입니다.