ICommandSource Интерфейс

Определение

Определяет объект, который знает, как вызвать команду.Defines an object that knows how to invoke a command.

public interface class ICommandSource
public interface ICommandSource
type ICommandSource = interface
Public Interface ICommandSource
Производный

Комментарии

Источник команды определяет, как команда вызывается этим конкретным объектом.The command source defines how a command is invoked by that particular object. Например, если объект Button связан с командой, команда вызывается Button при нажатии кнопки.For example, if a Button is associated with a command, the command is invoked when the Button is clicked.

Источник команды обычно отключается, если команда, с которой он связан, не может выполняться на текущем целевом объекте команды.A command source will normally disable itself if the command it is associated with cannot execute on the current command target. Например, MenuItem связанная Paste с командой команда будет Paste серым цветом, если команда не может выполняться на текущем целевом объекте команды.For example, a MenuItem associated with the Paste command will gray itself out when the Paste command cannot execute on the current command target.

Как правило, источник команды будет ожидать CanExecuteChanged события в команде.Normally, a command source will listen to the CanExecuteChanged event on the command. Это информирует источник команды при изменении условий на целевом объекте команды, например при утере фокуса клавиатуры.This informs the command source when conditions change on the command target, such as loss of keyboard focus. Затем источник команды может выполнить запрос к команде с помощью CanExecute метода.The command source can then query the command using the CanExecute method.

Вот некоторые из классов, WPFWPF в которых ICommandSource реализуется ButtonBase: MenuItem, и Hyperlink.Some of the classes in WPFWPF that implement ICommandSource are: ButtonBase, MenuItem, and Hyperlink.

В системе CommandTarget команд Windows Presentation Foundation свойство ICommandSource для доступно только в том случае, если параметр ICommand имеет RoutedCommandзначение.In the Windows Presentation Foundation commanding system, the CommandTarget property on a ICommandSource is only applicable when the ICommand is a RoutedCommand. Если параметр ICommandSource RoutedCommandимеет значение, а соответствующая команда не является, целевой объект команды игнорируется. CommandTargetIf the CommandTarget is set on a ICommandSource and the corresponding command is not a RoutedCommand, the command target is ignored.

Свойства

Command

Получает команду, которая будет выполняться при вызове источника команды.Gets the command that will be executed when the command source is invoked.

CommandParameter

Представляет определенное пользователем значение данных, которое может быть передано в команду при ее выполнении.Represents a user defined data value that can be passed to the command when it is executed.

CommandTarget

Объект, для которого выполняется команда.The object that the command is being executed on.

Применяется к

Дополнительно