Struttura CMINVOKECOMMANDINFOEX (shobjidl_core.h)

Contiene informazioni estese su un comando di menu di scelta rapida. Questa struttura è una versione estesa di CMINVOKECOMMANDINFO che consente l'uso di valori Unicode.

Sintassi

typedef struct _CMINVOKECOMMANDINFOEX {
  DWORD   cbSize;
  DWORD   fMask;
  HWND    hwnd;
  LPCSTR  lpVerb;
  LPCSTR  lpParameters;
  LPCSTR  lpDirectory;
  int     nShow;
  DWORD   dwHotKey;
  HANDLE  hIcon;
  LPCSTR  lpTitle;
  LPCWSTR lpVerbW;
  LPCWSTR lpParametersW;
  LPCWSTR lpDirectoryW;
  LPCWSTR lpTitleW;
  POINT   ptInvoke;
} CMINVOKECOMMANDINFOEX;

Members

cbSize

Tipo: DWORD

Dimensioni di questa struttura, in byte. Questo membro deve essere compilato dai chiamanti di IContextMenu::InvokeCommand e testato dalle implementazioni per sapere che la struttura è una struttura CMINVOKECOMMANDINFOEX anziché CMINVOKECOMMANDINFOINFO.

fMask

Tipo: DWORD

Zero o uno o più dei flag seguenti sono impostati per indicare il comportamento desiderato e indicare che devono essere usati altri campi nella struttura.

CMIC_MASK_HOTKEY

Il membro dwHotKey è valido.

CMIC_MASK_ICON

Il membro hIcon è valido. A partire da Windows Vista questo flag non viene usato.

CMIC_MASK_FLAG_NO_UI

L'implementazione di IContextMenu::InvokeCommand non consente di visualizzare elementi dell'interfaccia utente (ad esempio, messaggi di errore) durante l'esecuzione di un comando.

CMIC_MASK_UNICODE

Il gestore del menu di scelta rapida deve usare i membri lpVerbW, lpParametersW, lpDirectoryW e lpTitleW anziché i relativi equivalenti ANSI. Poiché alcuni gestori di menu di scelta rapida potrebbero non supportare Unicode, è necessario passare anche stringhe ANSI valide nei membri lpVerb, lpParameters, lpDirectory e lpTitle .

CMIC_MASK_NO_CONSOLE

Se un gestore di menu di scelta rapida deve creare un nuovo processo, in genere creerà una nuova console. L'impostazione del flag CMIC_MASK_NO_CONSOLE elimina la creazione di una nuova console.

CMIC_MASK_HASLINKNAME

Il membro lpTitle contiene un percorso completo di un file di collegamento. Usare in combinazione con CMIC_MASK_HASTITLE.

CMIC_MASK_HASTITLE

Il membro lpTitle è valido.

CMIC_MASK_FLAG_SEP_VDM

Questo flag è valido solo quando si fa riferimento a un'applicazione basata su Windows a 16 bit. Se impostata, l'applicazione a cui punta il collegamento viene eseguita in una macchina virtuale privata (VDM). Vedere la sezione Osservazioni.

CMIC_MASK_ASYNCOK

L'implementazione di IContextMenu::InvokeCommand può attivare un nuovo thread o processo per gestire la chiamata e non deve bloccare il completamento della funzione richiamata. Ad esempio, se il verbo è "delete" la chiamata IContextMenu::InvokeCommand può restituire prima che tutti gli elementi siano stati eliminati. Poiché si tratta di un avviso, la chiamata di applicazioni che specificano questo flag non può garantire che questa richiesta venga rispettata se non hanno familiarità con l'implementazione del verbo che richiamano.

CMIC_MASK_NOASYNC

Windows Vista e versioni successive. L'implementazione di IContextMenu::InvokeCommand deve essere sincrona e non deve essere restituita prima del completamento. Poiché ciò è consigliato, la chiamata di applicazioni che specificano questo flag non può garantire che questa richiesta venga rispettata se non hanno familiarità con l'implementazione del verbo che richiamano.

CMIC_MASK_SHIFT_DOWN

Il tasto MAIUSC viene premuto. Usare questa opzione anziché eseguire il polling dello stato corrente della tastiera che può essere stata modificata dopo la chiamata del verbo.

CMIC_MASK_CONTROL_DOWN

Il tasto CTRL viene premuto. Usare questa opzione anziché eseguire il polling dello stato corrente della tastiera che può essere stata modificata dopo la chiamata del verbo.

CMIC_MASK_FLAG_LOG_USAGE

Indica che l'implementazione di IContextMenu::InvokeCommand potrebbe voler tenere traccia dell'elemento richiamato per funzionalità come il menu "Documenti recenti".

CMIC_MASK_NOZONECHECKS

Non eseguire un controllo della zona. Questo flag consente a ShellExecuteEx di ignorare il controllo della zona inserito da IAttachmentExecute.

CMIC_MASK_PTINVOKE

Il membro ptInvoke è valido.

hwnd

Tipo: HWND

Handle per la finestra proprietaria del menu di scelta rapida. Un'estensione può anche usare questo handle come proprietario di qualsiasi finestra di messaggio o finestra di dialogo visualizzata. I chiamanti devono specificare un HWND legittimo che può essere usato come finestra del proprietario per qualsiasi interfaccia utente che può essere visualizzata. Se non si specifica un HWND quando si chiama da un thread dell'interfaccia utente (uno con finestre già create), la reentrancy e i possibili bug nell'implementazione di una chiamata IContextMenu::InvokeCommand .

lpVerb

Tipo: LPCSTR

Indirizzo di una stringa con terminazione Null che specifica il nome indipendente dalla lingua del comando da eseguire. Questo membro è in genere una stringa quando un comando viene attivato da un'applicazione. Il sistema fornisce valori costanti predefiniti per le stringhe di comando seguenti.

Questo non è un set fisso; I nuovi verbi canonici possono essere inventati dai gestori di menu di scelta rapida e le applicazioni possono richiamarli.

Se esiste un verbo canonico e un gestore di menu non implementa il verbo canonico, deve restituire un codice di errore per consentire al gestore successivo di gestire questo verbo. Se non si esegue questa operazione, la funzionalità verrà interrotta nel sistema, incluso ShellExecute.

In alternativa, anziché un puntatore, questo parametro può essere MAKEINTRESOURCE(offset) dove offset è l'offset dell'identificatore di menu del comando da eseguire. Le implementazioni possono usare la macro IS_INTRESOURCE per rilevare che questa alternativa è in uso. Shell usa questa alternativa quando l'utente sceglie un comando di menu.

lpParameters

Tipo: LPCSTR

Parametri facoltativi. Questo membro è sempre NULL per le voci di menu inserite da un'estensione shell.

lpDirectory

Tipo: LPCSTR

Nome facoltativo della directory di lavoro. Questo membro è sempre NULL per le voci di menu inserite da un'estensione shell.

nShow

Tipo: int

Set di valori SW_ da passare alla funzione ShowWindow se il comando visualizza una finestra o avvia un'applicazione.

dwHotKey

Tipo: DWORD

Scelta rapida da tastiera facoltativa da assegnare a qualsiasi applicazione attivata dal comando . Se il membro fMask non specifica CMIC_MASK_HOTKEY, questo membro viene ignorato.

hIcon

Tipo: HANDLE

Icona da usare per qualsiasi applicazione attivata dal comando . Se il membro fMask non specifica CMIC_MASK_ICON, questo membro viene ignorato.

lpTitle

Tipo: LPCSTR

Titolo ASCII.

lpVerbW

Tipo: LPCWSTR

Verbo Unicode, per i comandi che possono usarlo.

lpParametersW

Tipo: LPCWSTR

Parametri Unicode, per tali comandi che possono usarli.

lpDirectoryW

Tipo: LPCWSTR

Una directory Unicode, per tali comandi che possono usarla.

lpTitleW

Tipo: LPCWSTR

Titolo Unicode.

ptInvoke

Tipo: POINT

Punto in cui viene richiamato il comando. Se il membro fMask non specifica CMIC_MASK_PTINVOKE, questo membro viene ignorato. Questo membro non è valido prima di Internet Explorer 4.0.

Commenti

Anche se la dichiarazione IContextMenu::InvokeCommand specifica una struttura CMINVOKECOMMANDINFO per il parametro pici , può anche accettare una struttura CMINVOKECOMMANDINFOEX . Se si implementa questo metodo, è necessario controllare cbSize per determinare quale struttura è stata passata.

Per impostazione predefinita, tutte le applicazioni basate su Windows a 16 bit vengono eseguite come thread in una singola VDM condivisa. Il vantaggio di eseguire separatamente è che un arresto anomalo termina solo il singolo VDM; tutti gli altri programmi in esecuzione in macchine virtuali distinte continuano a funzionare normalmente. Inoltre, le applicazioni basate su Windows a 16 bit eseguite in macchine virtuali separate hanno code di input separate. Ciò significa che se un'applicazione smette di rispondere in modo momentaneo, le applicazioni in macchine virtuali separate continuano a ricevere l'input. Lo svantaggio dell'esecuzione separatamente è che richiede molto più memoria a tale scopo.

CMINVOKECOMMANDINFOEX è definito in Shobjidl.h, ma è necessario includere anche Shellapi.h per avere accesso completo a tutti i flag.

Requisiti