Interfaccia ICommandSource

Gestisce i comandi inviati da un oggetto origine comando a un controllo utente.

Sintassi

interface class ICommandSource

Membri

Metodi pubblici

Osservazioni:

Quando si ospita un controllo utente in una visualizzazione MFC, la classe CWinFormsView instrada i comandi e aggiorna i messaggi dell'interfaccia utente del comando al controllo utente per consentirgli di gestire i comandi MFC(ad esempio, voci di menu cornice e pulsanti della barra degli strumenti). Implementando L'interfaccia ICommandTarget, si assegna al controllo utente un riferimento all'oggetto ICommandSource .

Vedere Procedura: Aggiungere il routing dei comandi al controllo Windows Form per un esempio di come usare ICommandTarget.

Per altre informazioni sull'uso di Windows Form, vedere Uso di un controllo utente di Windows Form in MFC.

Requisiti

Intestazione: afxwinforms.h (definita nell'assembly atlmfc\lib\mfcmifc80.dll)

ICommandSource::AddCommandHandler

Aggiunge un gestore comandi a un oggetto origine comando.

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

Parametri

cmdID
ID comando. cmdHandler
Handle per il metodo del gestore comandi.

Osservazioni:

Questo metodo aggiunge il gestore dei comandi cmdHandler all'oggetto origine del comando ed esegue il mapping del gestore a cmdID. Vedere Procedura: Aggiungere il routing dei comandi al controllo Windows Form per un esempio di come usare AddCommandHandler.

ICommandSource::AddCommandRangeHandler

Aggiunge un gruppo di gestori comandi a un oggetto origine del comando.

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

Parametri

cmdIDMin
Indice iniziale dell'intervallo di ID comando. cmdIDMax
Indice finale dell'intervallo di ID comando. cmdHandler
Handle per il metodo del gestore messaggi a cui vengono mappati i comandi.

Osservazioni:

Questo metodo esegue il mapping di un intervallo contiguo di ID comando a un singolo gestore di messaggi e lo aggiunge all'oggetto origine del comando. Viene usato per gestire un gruppo di pulsanti correlati con un solo metodo.

ICommandSource::AddCommandRangeUIHandler

Aggiunge un gruppo di gestori di messaggi di comando dell'interfaccia utente a un oggetto di origine del comando.

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

Parametri

cmdIDMin
Indice iniziale dell'intervallo di ID comando. cmdIDMax
Indice finale dell'intervallo di ID comando. cmdHandler
Handle per il metodo del gestore messaggi a cui vengono mappati i comandi.

Osservazioni:

Questo metodo esegue il mapping di un intervallo contiguo di ID comando a un singolo gestore di messaggi di comando dell'interfaccia utente e lo aggiunge all'oggetto origine del comando. Viene usato per gestire un gruppo di pulsanti correlati con un solo metodo.

ICommandSource::AddCommandUIHandler

Aggiunge un gestore di messaggi di comando dell'interfaccia utente a un oggetto origine del comando.

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

Parametri

cmdID
ID comando. cmdUIHandler
Handle per il metodo del gestore dei messaggi del comando dell'interfaccia utente.

Osservazioni:

Questo metodo aggiunge il gestore del messaggio del comando dell'interfaccia utente cmdHandler all'oggetto origine del comando ed esegue il mapping del gestore a cmdID.

ICommandSource::P ostCommand

Invia un messaggio senza attendere che venga elaborato.

void PostCommand(unsigned int command);

Parametri

command
ID comando del messaggio da pubblicare.

Osservazioni:

Questo metodo invia in modo asincrono il messaggio mappato all'ID specificato dal comando . Chiama CWnd::P ostMessage per inserire il messaggio nella coda dei messaggi della finestra e quindi restituisce senza attendere che la finestra corrispondente elabori il messaggio.

ICommandSource::RemoveCommandHandler

Rimuove un gestore comandi da un oggetto origine comando.

void RemoveCommandHandler(unsigned int cmdID);

Parametri

cmdID
ID di comando.

Osservazioni:

Questo metodo rimuove il gestore dei comandi mappato a cmdID dall'oggetto origine del comando.

ICommandSource::RemoveCommandRangeHandler

Rimuove un gruppo di gestori di comandi da un oggetto di origine del comando.

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

Parametri

cmdIDMin
Indice iniziale dell'intervallo di ID comando. cmdIDMax
Indice finale dell'intervallo di ID comando.

Osservazioni:

Questo metodo rimuove un gruppo di gestori di messaggi, mappati agli ID comando specificati da cmdIDMin e cmdIDMax, dall'oggetto origine del comando.

ICommandSource::RemoveCommandRangeUIHandler

Rimuove un gruppo di gestori di messaggi di comando dell'interfaccia utente da un oggetto origine comando.

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

Parametri

cmdIDMin
Indice iniziale dell'intervallo di ID comando. cmdIDMax
Indice finale dell'intervallo di ID comando.

Osservazioni:

Questo metodo rimuove un gruppo di gestori di messaggi dei comandi dell'interfaccia utente, mappati agli ID comando specificati da cmdIDMin e cmdIDMax, dall'oggetto origine del comando.

ICommandSource::RemoveCommandUIHandler

Rimuove un gestore di messaggi di comando dell'interfaccia utente da un oggetto di origine del comando.

void RemoveCommandUIHandler(unsigned int cmdID);

Parametri

cmdID
ID di comando.

Osservazioni:

Questo metodo rimuove il gestore dei messaggi del comando dell'interfaccia utente mappato a cmdID dall'oggetto origine del comando.

ICommandSource::SendCommand

Invia un messaggio e attende che venga elaborato prima della restituzione.

void SendCommand(unsigned int command);

Parametri

command
ID del comando del messaggio da inviare.

Osservazioni:

Questo metodo invia in modo sincrono il messaggio mappato all'ID specificato dal comando . Chiama CWnd::SendMessage per inserire il messaggio nella coda dei messaggi della finestra e attende fino a quando tale routine della finestra non ha elaborato il messaggio prima di restituire.

Vedi anche

Procedura: Aggiungere il routing dei comandi al controllo Windows Form
Interfaccia ICommandTarget