ICommandSource 인터페이스
명령 원본 개체에서 사용자 컨트롤로 전송되는 명령을 관리합니다.
구문
interface class ICommandSource
멤버
공용 메서드
| 이름 | 설명 |
|---|---|
| ICommandSource::AddCommandHandler | 명령 원본 개체에 명령 처리기를 추가합니다. |
| ICommandSource::AddCommandRangeHandler | 명령 원본 개체에 명령 처리기 그룹을 추가합니다. |
| ICommandSource::AddCommandRangeUIHandler | 명령 소스 개체에 사용자 인터페이스 명령 메시지 처리기 그룹을 추가합니다. |
| ICommandSource::AddCommandUIHandler | 명령 소스 개체에 사용자 인터페이스 명령 메시지 처리기를 추가합니다. |
| ICommandSource::P ostCommand | 메시지를 처리할 때까지 기다리지 않고 게시합니다. |
| ICommandSource::RemoveCommandHandler | 명령 원본 개체에서 명령 처리기를 제거합니다. |
| ICommandSource::RemoveCommandRangeHandler | 명령 원본 개체에서 명령 처리기 그룹을 제거합니다. |
| ICommandSource::RemoveCommandRangeUIHandler | 명령 소스 개체에서 사용자 인터페이스 명령 메시지 처리기 그룹을 제거합니다. |
| ICommandSource::RemoveCommandUIHandler | 명령 소스 개체에서 사용자 인터페이스 명령 메시지 처리기를 제거합니다. |
| ICommandSource::SendCommand | 메시지를 보내고 반환하기 전에 처리될 때까지 기다립니다. |
설명
MFC 보기 에서 사용자 컨트롤을 호스트하는 경우 CWinFormsView 클래스 는 명령 및 업데이트 명령 UI 메시지를 사용자 컨트롤로 라우팅하여 MFC 명령(예: 프레임 메뉴 항목 및 도구 모음 단추)을 처리할 수 있도록 합니다. ICommandTarget 인터페이스를 구현하여 사용자 컨트롤에 개체에 대한 참조를 ICommandSource 제공합니다.
사용 방법에 ICommandTarget대한 예제는 방법: Windows Forms 컨트롤에 명령 라우팅 추가 방법을 참조하세요.
Windows Forms 사용에 대한 자세한 내용은 MFC에서 Windows Form 사용자 컨트롤 사용을 참조하세요.
요구 사항
헤더: afxwinforms.h(어셈블리 atlmfc\lib\mfcmifc80.dll 정의)
ICommandSource::AddCommandHandler
명령 원본 개체에 명령 처리기를 추가합니다.
void AddCommandHandler(
unsigned int cmdID,
CommandHandler^ cmdHandler);
매개 변수
cmdID
명령 ID입니다. cmdHandler
명령 처리기 메서드에 대한 핸들입니다.
설명
이 메서드는 명령 처리기 cmdHandler를 명령 원본 개체에 추가하고 처리기를 cmdID에 매핑합니다. AddCommandHandler를 사용하는 방법에 대한 예제는 방법: Windows Forms 컨트롤에 명령 라우팅 추가를 참조하세요.
ICommandSource::AddCommandRangeHandler
명령 원본 개체에 명령 처리기 그룹을 추가합니다.
void AddCommandRangeHandler(
unsigned int cmdIDMin,
unsigned int cmdIDMax,
CommandHandler^ cmdHandler);
매개 변수
cmdIDMin
명령 ID 범위의 시작 인덱스입니다.
cmdIDMax
명령 ID 범위의 끝 인덱스입니다.
cmdHandler
명령이 매핑되는 메시지 처리기 메서드에 대한 핸들입니다.
설명
이 메서드는 연속된 명령 ID 범위를 단일 메시지 처리기에 매핑하고 명령 원본 개체에 추가합니다. 이는 하나의 메서드를 사용하여 관련 단추 그룹을 처리하는 데 사용됩니다.
ICommandSource::AddCommandRangeUIHandler
명령 소스 개체에 사용자 인터페이스 명령 메시지 처리기 그룹을 추가합니다.
void AddCommandRangeUIHandler(
unsigned int cmdIDMin,
unsigned int cmdIDMax,
CommandUIHandler^ cmdUIHandler);
매개 변수
cmdIDMin
명령 ID 범위의 시작 인덱스입니다.
cmdIDMax
명령 ID 범위의 끝 인덱스입니다.
cmdHandler
명령이 매핑되는 메시지 처리기 메서드에 대한 핸들입니다.
설명
이 메서드는 명령 ID의 연속된 범위를 단일 사용자 인터페이스 명령 메시지 처리기에 매핑하고 명령 원본 개체에 추가합니다. 이는 하나의 메서드를 사용하여 관련 단추 그룹을 처리하는 데 사용됩니다.
ICommandSource::AddCommandUIHandler
명령 소스 개체에 사용자 인터페이스 명령 메시지 처리기를 추가합니다.
void AddCommandUIHandler(
unsigned int cmdID,
CommandUIHandler^ cmdUIHandler);
매개 변수
cmdID
명령 ID입니다. cmdUIHandler
사용자 인터페이스 명령 메시지 처리기 메서드에 대한 핸들입니다.
설명
이 메서드는 명령 소스 개체에 사용자 인터페이스 명령 메시지 처리기 cmdHandler를 추가하고 처리기를 cmdID에 매핑합니다.
ICommandSource::P ostCommand
메시지를 처리할 때까지 기다리지 않고 게시합니다.
void PostCommand(unsigned int command);
매개 변수
command
게시할 메시지의 명령 ID입니다.
설명
이 메서드는 명령에 의해 지정된 ID에 매핑된 메시지를 비동기적으로 게시합니다. CWnd::P ostMessage를 호출하여 메시지를 창의 메시지 큐에 배치한 다음 해당 창이 메시지를 처리할 때까지 기다리지 않고 반환합니다.
ICommandSource::RemoveCommandHandler
명령 원본 개체에서 명령 처리기를 제거합니다.
void RemoveCommandHandler(unsigned int cmdID);
매개 변수
cmdID
명령 ID입니다.
설명
이 메서드는 명령 소스 개체에서 cmdID에 매핑된 명령 처리기를 제거합니다.
ICommandSource::RemoveCommandRangeHandler
명령 원본 개체에서 명령 처리기 그룹을 제거합니다.
void RemoveCommandRangeUIHandler(
unsigned int cmdIDMin,
unsigned int cmdIDMax);
매개 변수
cmdIDMin
명령 ID 범위의 시작 인덱스입니다.
cmdIDMax
명령 ID 범위의 끝 인덱스입니다.
설명
이 메서드는 명령 원본 개체에서 cmdIDMin 및 cmdIDMax로 지정된 명령 ID에 매핑된 메시지 처리기 그룹을 제거합니다.
ICommandSource::RemoveCommandRangeUIHandler
명령 소스 개체에서 사용자 인터페이스 명령 메시지 처리기 그룹을 제거합니다.
void RemoveCommandRangeUIHandler(
unsigned int cmdIDMin,
unsigned int cmdIDMax);
매개 변수
cmdIDMin
명령 ID 범위의 시작 인덱스입니다.
cmdIDMax
명령 ID 범위의 끝 인덱스입니다.
설명
이 메서드는 명령 소스 개체에서 cmdIDMin 및 cmdIDMax로 지정된 명령 ID에 매핑된 사용자 인터페이스 명령 메시지 처리기 그룹을 제거합니다.
ICommandSource::RemoveCommandUIHandler
명령 소스 개체에서 사용자 인터페이스 명령 메시지 처리기를 제거합니다.
void RemoveCommandUIHandler(unsigned int cmdID);
매개 변수
cmdID
명령 ID입니다.
설명
이 메서드는 명령 소스 개체에서 cmdID에 매핑된 사용자 인터페이스 명령 메시지 처리기를 제거합니다.
ICommandSource::SendCommand
메시지를 보내고 반환하기 전에 처리될 때까지 기다립니다.
void SendCommand(unsigned int command);
매개 변수
command
보낼 메시지의 명령 ID입니다.
설명
이 메서드는 명령에 의해 지정된 ID에 매핑된 메시지를 동기적으로 보냅니다. CWnd::SendMessage를 호출하여 메시지를 창의 메시지 큐에 배치하고 해당 창 프로시저가 메시지를 처리할 때까지 기다렸다가 반환합니다.