ICommandSource Interface

Spravuje příkazy odeslané ze zdrojového objektu příkazu do uživatelského ovládacího prvku.

Syntax

interface class ICommandSource

Members

Public Methods

Name	Description
ICommandSource::AddCommandHandler	Přidá obslužnou rutinu příkazu do zdrojového objektu příkazu.
ICommandSource::AddCommandRangeHandler	Přidá skupinu obslužných rutin příkazů do zdrojového objektu příkazu.
ICommandSource::AddCommandRangeUIHandler	Přidá do zdrojového objektu příkazového řádku skupinu obslužných rutin příkazů uživatelského rozhraní.
ICommandSource::AddCommandUIHandler	Přidá obslužnou rutinu zprávy uživatelského rozhraní do zdrojového objektu příkazu.
ICommandSource::PostCommand	Publikuje zprávu bez čekání na zpracování.
ICommandSource::RemoveCommandHandler	Odebere obslužnou rutinu příkazu ze zdrojového objektu příkazu.
ICommandSource::RemoveCommandRangeHandler	Odebere skupinu obslužných rutin příkazů ze zdrojového objektu příkazu.
ICommandSource::RemoveCommandRangeUIHandler	Odebere skupinu obslužných rutin zpráv příkazového rozhraní uživatelského rozhraní ze zdrojového objektu příkazu.
ICommandSource::RemoveCommandUIHandler	Odebere obslužnou rutinu zprávy uživatelského rozhraní ze zdrojového objektu příkazu.
ICommandSource::SendCommand	Odešle zprávu a čeká na zpracování před vrácením.

Remarks

When you host a user control in an MFC View, CWinFormsView Class routes commands and update command UI messages to the user control to allow it to handle MFC commands (for example, frame menu items and toolbar buttons). By implementing ICommandTarget Interface, you give the user control a reference to the ICommandSource object.

Viz Postupy: Přidání směrování příkazů do ovládacího prvku model Windows Forms pro příklad použití ICommandTarget.

Další informace o používání model Windows Forms naleznete v tématu Použití uživatelského ovládacího prvku Windows Form v prostředí MFC.

Requirements

Header: afxwinforms.h (defined in assembly atlmfc\lib\mfcmifc80.dll)

ICommandSource::AddCommandHandler

Přidá obslužnou rutinu příkazu do zdrojového objektu příkazu.

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

Parameters

cmdID
ID příkazu.

cmdHandler
Popisovač metody obslužné rutiny příkazu.

Remarks

Tato metoda přidá obslužnou rutinu příkazu cmdHandler do zdrojového objektu příkazu a mapuje obslužnou rutinu na cmdID. Viz Postupy: Přidání směrování příkazů do ovládacího prvku model Windows Forms příklad použití AddCommandHandler.

ICommandSource::AddCommandRangeHandler

Přidá skupinu obslužných rutin příkazů do zdrojového objektu příkazu.

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

Parameters

cmdIDMin
Počáteční index rozsahu ID příkazu.

cmdIDMax
Koncový index rozsahu ID příkazu.

cmdHandler
Popisovač metody obslužné rutiny zprávy, na kterou jsou příkazy mapovány.

Remarks

Tato metoda mapuje souvislou oblast ID příkazů na jednu obslužnou rutinu zprávy a přidá ji do zdrojového objektu příkazu. Používá se ke zpracování skupiny souvisejících tlačítek pomocí jedné metody.

ICommandSource::AddCommandRangeUIHandler

Přidá do zdrojového objektu příkazového řádku skupinu obslužných rutin příkazů uživatelského rozhraní.

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

Parameters

cmdIDMin
Počáteční index rozsahu ID příkazu.

cmdIDMax
Koncový index rozsahu ID příkazu.

cmdHandler
Popisovač metody obslužné rutiny zprávy, na kterou jsou příkazy mapovány.

Remarks

Tato metoda mapuje souvislou oblast ID příkazů na jednu obslužnou rutinu zprávy příkazového rozhraní a přidá ji do zdrojového objektu příkazu. Používá se ke zpracování skupiny souvisejících tlačítek pomocí jedné metody.

ICommandSource::AddCommandUIHandler

Přidá obslužnou rutinu zprávy uživatelského rozhraní do zdrojového objektu příkazu.

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

Parameters

cmdID
ID příkazu.

cmdUIHandler
Popisovač metody obslužné rutiny zprávy uživatelského rozhraní.

Remarks

Tato metoda přidá obslužnou rutinu příkazového řádku uživatelského rozhraní cmdHandler do zdrojového objektu příkazu a mapuje obslužnou rutinu na cmdID.

ICommandSource::PostCommand

Publikuje zprávu bez čekání na zpracování.

void PostCommand(unsigned int command);

Parameters

command
ID příkazu zprávy, která se má publikovat.

Remarks

Tato metoda asynchronně publikuje zprávu mapovanou na ID určené příkazem. Volá CWnd::P ostMessage umístit zprávu do fronty zpráv okna a poté se vrátí bez čekání na odpovídající okno zpracovat zprávu.

ICommandSource::RemoveCommandHandler

Odebere obslužnou rutinu příkazu ze zdrojového objektu příkazu.

void RemoveCommandHandler(unsigned int cmdID);

Parameters

cmdID
ID příkazu.

Remarks

Tato metoda odebere obslužnou rutinu příkazu mapovanou na cmdID ze zdrojového objektu příkazu.

ICommandSource::RemoveCommandRangeHandler

Odebere skupinu obslužných rutin příkazů ze zdrojového objektu příkazu.

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

Parameters

cmdIDMin
Počáteční index rozsahu ID příkazu.

cmdIDMax
Koncový index rozsahu ID příkazu.

Remarks

Tato metoda odebere skupinu obslužných rutin zpráv mapované na ID příkazů určené cmdIDMin a cmdIDMax z objektu zdroje příkazu.

ICommandSource::RemoveCommandRangeUIHandler

Odebere skupinu obslužných rutin zpráv příkazového rozhraní uživatelského rozhraní ze zdrojového objektu příkazu.

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

Parameters

cmdIDMin
Počáteční index rozsahu ID příkazu.

cmdIDMax
Koncový index rozsahu ID příkazu.

Remarks

Tato metoda odebere skupinu obslužných rutin zpráv příkazového rozhraní uživatelského rozhraní mapované na ID příkazů určené cmdIDMin a cmdIDMax ze zdrojového objektu příkazu.

ICommandSource::RemoveCommandUIHandler

Odebere obslužnou rutinu zprávy uživatelského rozhraní ze zdrojového objektu příkazu.

void RemoveCommandUIHandler(unsigned int cmdID);

Parameters

cmdID
ID příkazu.

Remarks

Tato metoda odebere obslužnou rutinu zprávy uživatelského rozhraní mapovanou na cmdID ze zdrojového objektu příkazu.

ICommandSource::SendCommand

Odešle zprávu a čeká na zpracování před vrácením.

void SendCommand(unsigned int command);

Parameters

command
ID příkazu zprávy, která se má odeslat.

Remarks

Tato metoda synchronně odešle zprávu mapovanou na ID určené příkazem. Volá CWnd::SendMessage, aby zprávu umístila do fronty zpráv okna a čeká, dokud tato procedura okna nezpracovala zprávu před vrácením.

See also

Postupy: Přidání směrování příkazů do ovládacího prvku Windows Forms
ICommandTarget Interface