IAgentNotifySinkEx::HelpComplete

[Microsoft Agent è deprecato a partire da Windows 7 e potrebbe non essere disponibile nelle versioni successive di Windows.]

HRESULT HelpComplete(
   long dwCharID,     // character ID
   long dwCommandID,  // command ID
   long dwCause       // cause 
);

Notifica a un'applicazione client quando l'utente seleziona un comando o un carattere per completare la modalità Guida.

• Nessun valore restituito.

dwCharID

Identificatore del carattere per il quale è stata completata la modalità Guida.

dwCommandID

Identificatore del comando selezionato dall'utente.

dwCause

Causa dell'evento, che può essere il seguente:

Valore	Descrizione
const unsigned shortCSHELPCAUSE_COMMAND = 1;	L'utente ha selezionato un comando fornito dall'applicazione.
const unsigned shortCSHELPCAUSE_OTHERPROGRAM = 2;	L'utente ha selezionato l'oggetto Commands di un altro client.
const unsigned shortCSHELPCAUSE_OPENCOMMANDSWINDOW = 3;	L'utente ha selezionato il comando Apri comandi vocali.
const unsigned shortCSHELPCAUSE_CLOSECOMMANDSWINDOW = 4;	L'utente ha selezionato il comando Chiudi comandi vocali.
const unsigned shortCSHELPCAUSE_SHOWCHARACTER = 5;	L'utente ha selezionato il comando Show CharacterName .
const unsigned shortCSHELPCAUSE_HIDECHARACTER = 6;	L'utente ha selezionato il comando Nascondi characterName .
const unsigned shortCSHELPCAUSE_CHARACTER = 7;	L'utente ha selezionato (selezionato) il carattere.

In genere la modalità Guida viene completata quando l'utente fa clic o trascina il carattere o seleziona un comando dal menu a comparsa del carattere. Facendo clic su un altro carattere o altrove sullo schermo non viene annullata la modalità Guida. Il client che imposta la modalità Guida per il carattere può annullare la modalità Guida impostando IAgentCharacter::HelpModeOn su False. Questo non attiva l'evento IAgentNotifySinkEx::HelpComplete .

Quando l'utente seleziona un comando dal menu a comparsa del carattere in modalità Guida, il server rimuove il menu, chiama la Guida con l'HELPContextID specificato del comando e invia questo evento. Sensibile al contesto (noto anche come Che cos'è questo?) La finestra della Guida viene visualizzata nella posizione del puntatore. Se l'utente seleziona il comando in base all'input vocale, la finestra della Guida viene visualizzata sul carattere. Se il carattere è fuori schermo, la finestra viene visualizzata sullo schermo più vicina alla posizione corrente del carattere.

Se il server restituisce dwCommandID come stringa vuota (""), indica che l'utente ha selezionato un comando fornito dal server.

Questo evento viene inviato solo all'applicazione client che inserisce il carattere in modalità Guida.

Vedere anche

IAgentCharacterEx::SetHelpModeOn, IAgentCharacterEx::SetHelpFileName, IAgentCharacterEx::SetHelpContextID, IAgentCommandsEx::SetHelpContextID