ICommandSource – rozhraní
Spravuje příkazy odeslané ze zdrojového objektu příkazu do uživatelského ovládacího prvku.
Syntaxe
interface class ICommandSource
Členové
Veřejné metody
| Název | Popis |
|---|---|
| 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::P ostCommand | 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. |
Poznámky
Když hostujete uživatelský ovládací prvek v zobrazení MFC, CWinFormsView Třída směruje příkazy a aktualizuje zprávy uživatelského rozhraní příkazů do uživatelského ovládacího prvku, aby mohl zpracovávat příkazy MFC (například položky nabídky rámečku a tlačítka panelu nástrojů). Implementací ICommandTarget Interface dáte uživatelskému ovládacímu prvku odkaz na ICommandSource objekt.
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.
Požadavky
Hlavička: afxwinforms.h (definovaná v sestavení 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);
Parametry
cmdID
ID příkazu. cmdHandler
Popisovač metody obslužné rutiny příkazu.
Poznámky
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);
Parametry
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.
Poznámky
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);
Parametry
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.
Poznámky
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);
Parametry
cmdID
ID příkazu. cmdUIHandler
Popisovač metody obslužné rutiny zprávy uživatelského rozhraní.
Poznámky
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::P ostCommand
Publikuje zprávu bez čekání na zpracování.
void PostCommand(unsigned int command);
Parametry
příkaz
ID příkazu zprávy, která se má publikovat.
Poznámky
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);
Parametry
cmdID
ID příkazu.
Poznámky
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);
Parametry
cmdIDMin
Počáteční index rozsahu ID příkazu.
cmdIDMax
Koncový index rozsahu ID příkazu.
Poznámky
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);
Parametry
cmdIDMin
Počáteční index rozsahu ID příkazu.
cmdIDMax
Koncový index rozsahu ID příkazu.
Poznámky
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);
Parametry
cmdID
ID příkazu.
Poznámky
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);
Parametry
příkaz
ID příkazu zprávy, která se má odeslat.
Poznámky
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.
Viz také
Postupy: Přidání směrování příkazů do ovládacího prvku Windows Forms
ICommandTarget – rozhraní