Metodo IShellExtInit::Initialize (shobjidl_core.h)

Articolo
03/15/2023

Inizializza un'estensione della finestra delle proprietà, un'estensione del menu di scelta rapida o un gestore di trascinamento della selezione.

Sintassi

HRESULT Initialize(
  [in] PCIDLIST_ABSOLUTE pidlFolder,
  [in] IDataObject       *pdtobj,
  [in] HKEY              hkeyProgID
);

Parametri

[in] pidlFolder

Tipo: PCIDLIST_ABSOLUTE

Puntatore a una struttura ITEMIDLIST che identifica in modo univoco una cartella. Per le estensioni della finestra delle proprietà, questo parametro è NULL. Per le estensioni del menu di scelta rapida, è l'elenco di identificatori di elemento per la cartella che contiene l'elemento il cui menu di scelta rapida viene visualizzato. Per le estensioni del menu di trascinamento non predefinite, questo parametro specifica la cartella di destinazione.

[in] pdtobj

Tipo: IDataObject*

Puntatore a un oggetto interfaccia IDataObject che può essere utilizzato per recuperare gli oggetti su cui agiscono.

[in] hkeyProgID

Tipo: HKEY

Chiave del Registro di sistema per l'oggetto file o il tipo di cartella.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

I significati di alcuni parametri dipendono dal tipo di estensione. Per i gestori di trascinamento della selezione, il parametro pidlFolder specifica la cartella di destinazione (destinazione di rilascio), il parametro pdtobj identifica gli elementi eliminati e il parametro hkeyProgID specifica il tipo di file della cartella di destinazione.

Per le estensioni del menu di scelta rapida, pdtobj identifica gli oggetti file selezionati, hkeyProgID identifica il tipo di file dell'oggetto con stato attivo e pidlFolder è NULL (per gli oggetti file) o specifica la cartella per cui viene richiesto il menu di scelta rapida (per i menu di scelta rapida in background della cartella).

Per le estensioni della finestra delle proprietà, pidlFolder è NULL, pdtobj identifica gli oggetti file selezionati e hkeyProgID specifica il tipo di file dell'oggetto file con lo stato attivo.

Note per gli implementatori

Questo è il primo metodo che shell chiama dopo aver creato un'istanza di un'estensione della finestra delle proprietà, l'estensione del menu di scelta rapida o il gestore di trascinamento della selezione.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll (versione 4.0 o successiva)

Condividi tramite