Share via

Metodo IOleWindow::ContextSensitiveHelp (oleidl.h)

  • Articolo

Determina se la modalità guida sensibile al contesto deve essere immessa durante una sessione di attivazione sul posto.

Sintassi

HRESULT ContextSensitiveHelp(
  [in] BOOL fEnterMode
);

Parametri

[in] fEnterMode

TRUE se la modalità guida deve essere immessa; FALSE se deve essere chiuso.

Valore restituito

Questo metodo restituisce S_OK se la modalità della Guida è stata immessa o chiusa correttamente, a seconda del valore passato in fEnterMode. Gli altri valori restituiti possibili includono i seguenti:

Codice restituito Descrizione
E_INVALIDARG
 Il valore fEnterMode specificato non è valido.
E_OUTOFMEMORY
 Per questa operazione è disponibile memoria insufficiente.
E_UNEXPECTED
 Si è verificato un errore imprevisto.

Commenti

Le applicazioni possono richiamare la Guida sensibile al contesto quando l'utente:

  • preme MAIUSC+F1, quindi fa clic su un argomento
  • preme F1 quando viene selezionata una voce di menu
Quando MAIUSC+F1 viene premuto, il frame o l'oggetto attivo possono ricevere le sequenze di tasti. Se il frame del contenitore riceve le sequenze di tasti, chiama il relativo metodo IOleWindow::ContextSensitiveHelp con fEnterMode impostato su TRUE. In questo modo viene propagato lo stato della Guida a tutti gli oggetti sul posto in modo che possano gestire correttamente il clic del mouse o WM_COMMAND.

Se un oggetto attivo riceve le sequenze di tasti MAIUSC+F1, chiama il metodo IOleWindow::ContextSensitiveHelp del contenitore con fEnterModeTRUE, che quindi chiama in modo ricorsivo ogni sito sul posto fino a quando non ci sono più notifiche. Il contenitore chiama quindi il metodo IOleWindow::ContextSensitiveHelp del documento o del documento con fEnterModeTRUE.

Quando in modalità guida sensibile al contesto, un oggetto che riceve il clic del mouse può:

  • Ignorare il clic se non supporta la Guida sensibile al contesto.
  • Indicare a tutti gli altri oggetti di uscire dalla modalità guida sensibile al contesto con ContextSensitiveHelp impostata su FALSE e quindi fornire assistenza per tale contesto.
Un oggetto in modalità guida sensibile al contesto che riceve un WM_COMMAND deve indicare a tutti gli altri oggetti sul posto di uscire dalla modalità guida sensibile al contesto e quindi fornire assistenza per il comando.

Se un'applicazione contenitore supporta la guida sensibile al contesto nelle voci di menu, deve specificare il proprio filtro messaggi in modo che possa intercettare la chiave F1 o chiedere alla libreria OLE di aggiungere un filtro di messaggio chiamando OleSetMenuDescriptor, passando valori validi e non NULL per i parametri lpFrame e lpActiveObj .

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione oleidl.h

Vedi anche

IOleWindow

OleSetMenuDescriptor