IPropertySheetProvider ::Show, méthode (mmc.h)
Si le type qui a été défini dans IPropertySheetProvider ::CreatePropertySheet est une feuille de propriétés, IPropertySheetProvider ::Show affiche un cadre de feuille de propriétés qui est parenté à une fenêtre masquée. Si le type qui a été défini dans IPropertySheetProvider ::CreatePropertySheet est un Assistant, IPropertySheetProvider ::Show affiche un cadre de feuille de propriétés parenté au handle passé à cette méthode.
Syntaxe
HRESULT Show(
[in] LONG_PTR window,
[in] int page
);
Paramètres
[in] window
Valeur qui spécifie le handle de la fenêtre parente.
[in] page
Valeur qui spécifie la page affichée dans la feuille de propriétés. Il est indexé à zéro.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
Remarques
IPropertySheetProvider ::Show( –1, 0) retourne E_FAIL. Ce code de retour peut être ignoré dans ce cas.
Dans les situations où le composant logiciel enfichable crée une feuille de propriétés dans un appel à IPropertySheetProvider ::CreatePropertySheet, appelle éventuellement IPropertySheetProvider ::AddPrimaryPages et IPropertySheetProvider ::AddExtensionPages, puis décide de ne pas afficher la feuille de propriétés, il doit appeler IPropertySheetProvider ::Show( –1, 0) pour supprimer la feuille de propriétés et libérer ses ressources. Dans ce cas, le composant logiciel enfichable doit supprimer les descripteurs de page de propriétés qu’il a créés. Cette opération peut être effectuée avant ou après que le composant logiciel enfichable appelle IPropertySheetProvider ::Show( –1, 0), car MMC n’utilise pas les handles de page de propriétés.
IPropertySheetProvider ::Show( –1, 0) supprime uniquement la feuille de propriétés actuelle, c’est-à-dire une feuille qui a été créée, mais qui n’est pas encore affichée. Une fois qu’une feuille de propriétés est affichée, le composant logiciel enfichable ne peut pas la fermer par programmation. Seul l’utilisateur peut fermer une feuille de propriétés affichée. Dans ce cas, MMC supprime automatiquement toutes les pages de propriétés associées (structures PROPSHEETPAGE ) fournies par le composant logiciel enfichable.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | mmc.h |
| DLL | Mmcndmgr.dll |