Klasa ICommandSource

Zarządza poleceniami wysyłanymi z obiektu źródłowego polecenia do kontrolki użytkownika.

Składnia

interface class ICommandSource

Elementy członkowskie

Metody publiczne

Nazwa/nazwisko	opis
ICommandSource::AddCommandHandler	Dodaje procedurę obsługi poleceń do obiektu źródłowego polecenia.
ICommandSource::AddCommandRangeHandler	Dodaje grupę programów obsługi poleceń do obiektu źródłowego polecenia.
ICommandSource::AddCommandRangeUIHandler	Dodaje grupę procedur obsługi komunikatów poleceń interfejsu użytkownika do obiektu źródłowego polecenia.
ICommandSource::AddCommandUIHandler	Dodaje procedurę obsługi komunikatów poleceń interfejsu użytkownika do obiektu źródłowego polecenia.
ICommandSource::P ostCommand	Publikuje komunikat bez oczekiwania na jego przetworzenie.
ICommandSource::RemoveCommandHandler	Usuwa program obsługi poleceń z obiektu źródłowego polecenia.
ICommandSource::RemoveCommandRangeHandler	Usuwa grupę programów obsługi poleceń z obiektu źródłowego polecenia.
ICommandSource::RemoveCommandRangeUIHandler	Usuwa grupę programów obsługi komunikatów poleceń interfejsu użytkownika z obiektu źródłowego polecenia.
ICommandSource::RemoveCommandUIHandler	Usuwa program obsługi komunikatów polecenia interfejsu użytkownika z obiektu źródłowego polecenia.
ICommandSource::SendCommand	Wysyła komunikat i czeka na jego przetworzenie przed zwróceniem.

Uwagi

Gdy hostujesz kontrolkę użytkownika w widoku MFC, klasa CWinFormsView kieruje polecenia i aktualizuje komunikaty interfejsu użytkownika poleceń do kontrolki użytkownika, aby umożliwić jej obsługę poleceń MFC (na przykład elementy menu ramek i przyciski paska narzędzi). Implementując interfejs ICommandTarget, można przekazać użytkownikowi odwołanie do ICommandSource obiektu.

Zobacz Instrukcje: dodawanie routingu poleceń do kontrolki Formularzy systemu Windows, aby zapoznać się z przykładem używania polecenia ICommandTarget.

Aby uzyskać więcej informacji na temat korzystania z formularzy systemu Windows, zobacz Using a Windows Form User Control in MFC (Używanie kontrolki użytkownika formularza systemu Windows w MFC).

Wymagania

Nagłówek: afxwinforms.h (zdefiniowany w zestawie atlmfc\lib\mfcmifc80.dll)

ICommandSource::AddCommandHandler

Dodaje procedurę obsługi poleceń do obiektu źródłowego polecenia.

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

Parametry

cmdID
Identyfikator polecenia. cmdHandler
Dojście do metody obsługi poleceń.

Uwagi

Ta metoda dodaje program obsługi poleceń cmdHandler do obiektu źródłowego polecenia i mapuje program obsługi na cmdID. Zobacz Instrukcje: dodawanie routingu poleceń do kontrolki formularzy systemu Windows, aby zapoznać się z przykładem korzystania z polecenia AddCommandHandler.

ICommandSource::AddCommandRangeHandler

Dodaje grupę programów obsługi poleceń do obiektu źródłowego polecenia.

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

Parametry

cmdIDMin
Początkowy indeks zakresu identyfikatorów poleceń. cmdIDMax
Końcowy indeks zakresu identyfikatorów poleceń. cmdHandler
Dojście do metody obsługi komunikatów, do której są mapowane polecenia.

Uwagi

Ta metoda mapuje ciągły zakres identyfikatorów poleceń na jedną procedurę obsługi komunikatów i dodaje ją do obiektu źródłowego polecenia. Jest to używane do obsługi grupy powiązanych przycisków z jedną metodą.

ICommandSource::AddCommandRangeUIHandler

Dodaje grupę procedur obsługi komunikatów poleceń interfejsu użytkownika do obiektu źródłowego polecenia.

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

Parametry

cmdIDMin
Początkowy indeks zakresu identyfikatorów poleceń. cmdIDMax
Końcowy indeks zakresu identyfikatorów poleceń. cmdHandler
Dojście do metody obsługi komunikatów, do której są mapowane polecenia.

Uwagi

Ta metoda mapuje ciągły zakres identyfikatorów poleceń na jeden program obsługi komunikatów poleceń interfejsu użytkownika i dodaje go do obiektu źródłowego polecenia polecenia. Jest to używane do obsługi grupy powiązanych przycisków z jedną metodą.

ICommandSource::AddCommandUIHandler

Dodaje procedurę obsługi komunikatów poleceń interfejsu użytkownika do obiektu źródłowego polecenia.

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

Parametry

cmdID
Identyfikator polecenia. cmdUIHandler
Dojście do metody obsługi komunikatów poleceń interfejsu użytkownika.

Uwagi

Ta metoda dodaje program obsługi komunikatów polecenia interfejsu użytkownika cmdHandler do obiektu źródłowego polecenia i mapuje program obsługi na cmdID.

ICommandSource::P ostCommand

Publikuje komunikat bez oczekiwania na jego przetworzenie.

void PostCommand(unsigned int command);

Parametry

polecenie
Identyfikator polecenia wiadomości do opublikowania.

Uwagi

Ta metoda asynchronicznie publikuje komunikat zamapowany na identyfikator określony przez polecenie. Wywołuje metodę CWnd::P ostMessage, aby umieścić komunikat w kolejce komunikatów okna, a następnie zwracany bez oczekiwania na przetworzenie komunikatu przez odpowiednie okno.

ICommandSource::RemoveCommandHandler

Usuwa program obsługi poleceń z obiektu źródłowego polecenia.

void RemoveCommandHandler(unsigned int cmdID);

Parametry

cmdID
Identyfikator polecenia.

Uwagi

Ta metoda usuwa program obsługi poleceń mapowany na cmdID z obiektu źródłowego polecenia.

ICommandSource::RemoveCommandRangeHandler

Usuwa grupę programów obsługi poleceń z obiektu źródłowego polecenia.

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

Parametry

cmdIDMin
Początkowy indeks zakresu identyfikatorów poleceń. cmdIDMax
Końcowy indeks zakresu identyfikatorów poleceń.

Uwagi

Ta metoda usuwa grupę programów obsługi komunikatów zamapowanych na identyfikatory poleceń określone przez cmdIDMin i cmdIDMax z obiektu źródłowego polecenia.

ICommandSource::RemoveCommandRangeUIHandler

Usuwa grupę programów obsługi komunikatów poleceń interfejsu użytkownika z obiektu źródłowego polecenia.

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

Parametry

cmdIDMin
Początkowy indeks zakresu identyfikatorów poleceń. cmdIDMax
Końcowy indeks zakresu identyfikatorów poleceń.

Uwagi

Ta metoda usuwa grupę programów obsługi komunikatów poleceń interfejsu użytkownika, mapowanych na identyfikatory poleceń określone przez cmdIDMin i cmdIDMax z obiektu źródłowego polecenia.

ICommandSource::RemoveCommandUIHandler

Usuwa program obsługi komunikatów polecenia interfejsu użytkownika z obiektu źródłowego polecenia.

void RemoveCommandUIHandler(unsigned int cmdID);

Parametry

cmdID
Identyfikator polecenia.

Uwagi

Ta metoda usuwa program obsługi komunikatów polecenia interfejsu użytkownika mapowany na cmdID z obiektu źródłowego polecenia.

ICommandSource::SendCommand

Wysyła komunikat i czeka na jego przetworzenie przed zwróceniem.

void SendCommand(unsigned int command);

Parametry

polecenie
Identyfikator polecenia wiadomości do wysłania.

Uwagi

Ta metoda synchronicznie wysyła komunikat zamapowany na identyfikator określony przez polecenie. Wywołuje metodę CWnd::SendMessage, aby umieścić komunikat w kolejce komunikatów okna i czeka, aż ta procedura okna przetworzy komunikat przed zwróceniem.

Zobacz też

Instrukcje: dodawanie routingu poleceń do formantu interfejsu Windows Forms
Klasa ICommandTarget