Интерфейс 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 направляет команды и обновляет сообщения пользовательского интерфейса команды в пользовательский элемент управления, чтобы разрешить ему обрабатывать команды MFC (например, элементы меню кадров и кнопки панели инструментов). Реализуя интерфейс ICommandTarget, вы предоставляете пользователю ссылку на ICommandSource объект.

См . инструкции. Добавление маршрутизации команд в элемент управления Windows Forms для примера использования ICommandTarget.

Дополнительные сведения об использовании Windows Forms см. в разделе "Использование пользовательского элемента управления Windows Form" в MFC.

Требования

Заголовок: afxwinforms.h (определен в сборке atlmfc\lib\mfcfc80.dll)

ICommandSource::AddCommandHandler

Добавляет обработчик команд в исходный объект команды.

void AddCommandHandler(
    unsigned int cmdID,
    CommandHandler^ cmdHandler);

Параметры

cmdID
Идентификатор команды. cmdHandler
Дескриптор метода обработчика команд.

Замечания

Этот метод добавляет обработчик команд cmdHandler в исходный объект команды и сопоставляет обработчик с cmdID. См . инструкции. Добавление маршрутизации команд в элемент управления Windows Forms для примера использования AddCommandHandler.

ICommandSource::AddCommandRangeHandler

Добавляет группу обработчиков команд в исходный объект команды.

void AddCommandRangeHandler(
    unsigned int cmdIDMin,
    unsigned int cmdIDMax,
    CommandHandler^ cmdHandler);

Параметры

cmdIDMin
Начальный индекс диапазона идентификаторов команды. cmdIDMax
Конечный индекс диапазона идентификаторов команды. cmdHandler
Дескриптор метода обработчика сообщений, с которым сопоставляются команды.

Замечания

Этот метод сопоставляет непрерывный диапазон идентификаторов команд с одним обработчиком сообщений и добавляет его в исходный объект команды. Это используется для обработки группы связанных кнопок с одним методом.

ICommandSource::AddCommandRangeUIHandler

Добавляет группу обработчиков команд пользовательского интерфейса в объект источника команд.

void AddCommandRangeUIHandler(
    unsigned int cmdIDMin,
    unsigned int cmdIDMax,
    CommandUIHandler^ cmdUIHandler);

Параметры

cmdIDMin
Начальный индекс диапазона идентификаторов команды. cmdIDMax
Конечный индекс диапазона идентификаторов команды. cmdHandler
Дескриптор метода обработчика сообщений, с которым сопоставляются команды.

Замечания

Этот метод сопоставляет непрерывный диапазон идентификаторов команд с одним обработчиком командного сообщения пользовательского интерфейса и добавляет его в исходный объект команды. Это используется для обработки группы связанных кнопок с одним методом.

ICommandSource::AddCommandUIHandler

Добавляет обработчик командного сообщения пользовательского интерфейса в объект источника команды.

void AddCommandUIHandler(
    unsigned int cmdID,
    CommandUIHandler^ cmdUIHandler);

Параметры

cmdID
Идентификатор команды. cmdUIHandler
Дескриптор обработчика командного сообщения пользовательского интерфейса.

Замечания

Этот метод добавляет обработчик командного сообщения пользовательского интерфейса cmdHandler в исходный объект команды и сопоставляет обработчик с cmdID.

ICommandSource::P ostCommand

Публикует сообщение, не ожидая обработки сообщения.

void PostCommand(unsigned int command);

Параметры

command
Идентификатор команды для публикации сообщения.

Замечания

Этот метод асинхронно публикует сообщение, сопоставленное с идентификатором, указанным командой. Он вызывает CWnd::P ostMessage, чтобы поместить сообщение в очередь сообщений окна, а затем возвращается без ожидания соответствующего окна для обработки сообщения.

ICommandSource::RemoveCommandHandler

Удаляет обработчик команд из исходного объекта команды.

void RemoveCommandHandler(unsigned int cmdID);

Параметры

cmdID
Идентификатор команды.

Замечания

Этот метод удаляет обработчик команд, сопоставленный с cmdID, из исходного объекта команды.

ICommandSource::RemoveCommandRangeHandler

Удаляет группу обработчиков команд из исходного объекта команды.

void RemoveCommandRangeUIHandler(
    unsigned int cmdIDMin,
    unsigned int cmdIDMax);

Параметры

cmdIDMin
Начальный индекс диапазона идентификаторов команды. cmdIDMax
Конечный индекс диапазона идентификаторов команды.

Замечания

Этот метод удаляет группу обработчиков сообщений, сопоставленных с идентификаторами команд, указанными cmdIDMin и cmdIDMax, из исходного объекта команды.

ICommandSource::RemoveCommandRangeUIHandler

Удаляет группу обработчиков сообщений командной строки пользовательского интерфейса из исходного объекта команды.

void RemoveCommandRangeUIHandler(
    unsigned int cmdIDMin,
    unsigned int cmdIDMax);

Параметры

cmdIDMin
Начальный индекс диапазона идентификаторов команды. cmdIDMax
Конечный индекс диапазона идентификаторов команды.

Замечания

Этот метод удаляет группу обработчиков сообщений команд пользовательского интерфейса, сопоставленных с идентификаторами команд, указанными cmdIDMin и cmdIDMax, из исходного объекта команды.

ICommandSource::RemoveCommandUIHandler

Удаляет обработчик командного сообщения пользовательского интерфейса из исходного объекта команды.

void RemoveCommandUIHandler(unsigned int cmdID);

Параметры

cmdID
Идентификатор команды.

Замечания

Этот метод удаляет обработчик командного сообщения пользовательского интерфейса, сопоставленный с cmdID из исходного объекта команды.

ICommandSource::SendCommand

Отправляет сообщение и ожидает его обработки перед возвратом.

void SendCommand(unsigned int command);

Параметры

command
Идентификатор команды отправленного сообщения.

Замечания

Этот метод синхронно отправляет сообщение, сопоставленное с идентификатором, указанным командой. Он вызывает CWnd::SendMessage, чтобы поместить сообщение в очередь сообщений окна и ожидает, пока эта процедура окна не обработала сообщение перед возвратом.

См. также

Практическое руководство. Добавление маршрутизации команд в элемент управления Windows Forms
Интерфейс ICommandTarget