Come registrare e implementare un gestore foglio proprietà per un tipo di file
Quando l'utente fa clic con il pulsante destro del mouse su un membro di un tipo di file per visualizzare il foglio proprietà Proprietà, shell chiama i gestori del foglio delle proprietà registrati per il tipo di file. Ogni gestore può aggiungere una pagina personalizzata al foglio delle proprietà predefinite.
Informazioni importanti
Tecnologie
- Shell
Prerequisiti
- Informazioni sui menu di scelta rapida
Istruzioni
Passaggio 1: Registrazione di un gestore foglio proprietà per un tipo di file
Oltre alla normale registrazione di Component Object Model (COM), aggiungere una sottochiave PropertySheetHandlers alla sottochiave shellex della chiave ProgID dell'applicazione associata al tipo di file. Creare una sottochiave di PropertySheetHandlers con il nome del gestore e impostare il valore predefinito sulla forma stringa del GUID (CLSID) del gestore delle proprietà.
Per aggiungere più pagine al foglio delle proprietà, registrare un gestore per ogni pagina. Il numero massimo di pagine supportate da un foglio delle proprietà è 32. Per registrare più gestori, creare una chiave sotto la chiave shellex per ogni gestore, con il valore predefinito impostato sul GUID CLSID del gestore. Non è necessario creare un oggetto distinto per ogni gestore, ovvero che più gestori possono avere lo stesso valore GUID. Le pagine verranno visualizzate nell'ordine in cui le chiavi sono elencate in shellex.
Nell'esempio seguente viene illustrata una voce del Registro di sistema che consente due gestori di estensioni del foglio di proprietà per un tipo di file .myp di esempio. In questo esempio viene usato un oggetto separato per ogni pagina, ma un singolo oggetto può essere usato anche per entrambi.
HKEY_CLASSES_ROOT
.myp
(Default) = MyProgram.1
CLSID
{Page 1 Property Sheet Handler CLSID GUID}
InProcServer32
(Default) = C:\MyDir\MyPropSheet1.dll
ThreadingModel = Apartment
{Page 2 Property Sheet Handler CLSID GUID}
InProcServer32
(Default) = C:\MyDir\MyPropSheet2.dll
ThreadingModel = Apartment
MyProgram.1
(Default) = MyProgram Application
shellex
PropertySheetHandlers
MyPropSheet1
(Default) = {Page1 Property Sheet Handler CLSID GUID}
MyPropSheet2
(Default) = {Page2 Property Sheet Handler CLSID GUID}
Passaggio 2: Implementazione di un gestore foglio proprietà per un tipo di file
Oltre all'implementazione generale descritta in How Property Sheet Handlers Work, un gestore di fogli di proprietà per un tipo di file deve avere anche un'implementazione appropriata dell'interfaccia IShellPropSheetExt . Solo il metodo IShellPropSheetExt::AddPages richiede un'implementazione nonken. La shell non chiama IShellPropSheetExt::ReplacePage.
Il metodo IShellPropSheetExt::AddPages consente a un gestore del foglio delle proprietà di aggiungere una pagina a un foglio delle proprietà. Il metodo ha due parametri di input. Il primo, lpfnAddPage, è un puntatore a una funzione di callback AddPropSheetPageProc usata per fornire alla Shell le informazioni necessarie per aggiungere la pagina al foglio delle proprietà. Il secondo, lParam, è un valore definito da Shell che non viene elaborato dal gestore. Viene semplicemente passato alla Shell quando viene chiamata la funzione di callback.
La procedura generale per l'implementazione di AddPages è la seguente.
Implementazione del metodo AddPages
- Assegnare valori appropriati ai membri di una struttura PROPSHEETPAGE . In particolare:
- Assegnare la variabile che contiene il conteggio dei riferimenti del gestore al membro pcRefParent . Questa procedura impedisce che l'oggetto gestore venga scaricato mentre il foglio delle proprietà è ancora in corso di visualizzazione.
- È anche possibile implementare una funzione di callback PropSheetPageProc e assegnarne il puntatore a un membro pfnCallback . Questa funzione viene chiamata quando viene creata la pagina e quando sta per essere distrutta.
- Creare l'handle HPAGE della pagina passando la struttura PROPSHEETPAGE alla funzione CreatePropertySheetPage .
- Chiamare la funzione a cui punta lpfnAddPage. Impostare il primo parametro sull'handle HPAGE creato nel passaggio precedente. Impostare il secondo parametro sul valore lParam passato a AddPages da Shell.
- Tutti i messaggi associati alla pagina verranno passati alla procedura della finestra di dialogo assegnata al membro pfnDlgProc della struttura PROPSHEETPAGE .
- Se è stata assegnata una funzione di callback PropSheetPageProc a pfnCallback, verrà chiamata quando la pagina sta per essere eliminata. Il gestore può quindi eseguire operazioni di pulizia necessarie, ad esempio rilasciando eventuali riferimenti che contiene.
Nell'esempio di codice seguente viene illustrata una semplice implementazione di AddPages .
STDMETHODIMP CShellPropSheetExt::AddPages(LPFNADDPROPSHEETPAGE, lpfnAddPage, LPARAM lParam)
{
PROPSHEETPAGE psp;
HPROPSHEETPAGE hPage;
psp.dwSize = sizeof(psp);
psp.dwFlags = PSP_USEREFPARENT | PSP_USETITLE | PSP_USECALLBACK;
psp.hInstance = g_hInst;
psp.pszTemplate = MAKEINTRESOURCE(IDD_PAGEDLG);
psp.hIcon = 0;
psp.pszTitle = TEXT("Extension Page");
psp.pfnDlgProc = (DLGPROC)PageDlgProc;
psp.pcRefParent = &g_DllRefCount;
psp.pfnCallback = PageCallbackProc;
psp.lParam = (LPARAM)this;
hPage = CreatePropertySheetPage(&psp);
if(hPage)
{
if(lpfnAddPage(hPage, lParam))
{
this->AddRef();
return S_OK;
}
else
{
DestroyPropertySheetPage(hPage);
}
}
else
{
return E_OUTOFMEMORY;
}
return E_FAIL;
}
La variabile g_hInst è l'handle dell'istanza della DLL e IDD_PAGEDLG è l'ID risorsa del modello della finestra di dialogo della pagina. La funzione PageDlgProc è la procedura della finestra di dialogo che gestisce i messaggi della pagina. La variabile g_DllRefCount contiene il conteggio dei riferimenti dell'oggetto. Il metodo AddPages chiama AddRef per incrementare il conteggio. Tuttavia, il conteggio dei riferimenti viene rilasciato dalla funzione di callback, PageCallbackProc, quando la pagina sta per essere eliminata.
Commenti
Per una discussione generale su come registrare i gestori di estensioni shell, vedere Creazione di gestori estensioni shell.
Argomenti correlati