IPropertySheetProvider::CreatePropertySheet, méthode (mmc.h)

La méthode IPropertySheetProvider::CreatePropertySheet crée un cadre de feuille de propriétés.

Syntaxe

HRESULT CreatePropertySheet(
  [in] LPCWSTR      title,
  [in] boolean      type,
  [in] MMC_COOKIE   cookie,
  [in] LPDATAOBJECT pIDataObjectm,
  [in] DWORD        dwOptions
);

Paramètres

[in] title

Pointeur vers une chaîne terminée par null qui contient le titre de la page de propriétés. Ce paramètre ne peut pas être NULL.

[in] type

TRUE crée une feuille de propriétés et FALSE crée un Assistant.

[in] cookie

Valeur de cookie de l’élément actuellement sélectionné. Cette valeur peut être NULL lorsque CreatePropertySheet est appelé par un composant logiciel enfichable d’extension.

[in] pIDataObjectm

Pointeur vers l’interface IDataObject sur l’objet de données du cookie. Si la valeur de ce paramètre est NULL, MMC n’appelle aucune des méthodes IExtendPropertySheet2 implémentées par les composants logiciels enfichables d’extension.

[in] dwOptions

Valeur qui spécifie les indicateurs qui peuvent être définis par l’appel de méthode. Le paramètre peut être une combinaison des valeurs suivantes :

MMC_PSO_NOAPPLYNOW

Supprimer le bouton Appliquer maintenant.

MMC_PSO_HASHELP

Ajouter un bouton d’aide .

MMC_PSO_NO_PROPTITLE

Ignoré pour les Assistants. Pour les feuilles de propriétés, si cette option est spécifiée, les mots « Propriétés pour » ne sont pas insérés au début de la barre de titre de la feuille de propriétés.

MMC_PSO_NEWWIZARDTYPE

Utilisez le style Assistant 97.

Par exemple, pour créer une feuille de propriétés contenant un bouton Aide et qui n’a pas de bouton Appliquer maintenant, le paramètre dwOptions doit être MMC_PSO_NOAPPLYNOW | MMC_PSO_HASHELP.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Notes

Cette méthode crée un objet qui collecte toutes les informations requises pour créer une feuille de propriétés. Si l’appel CreatePropertySheet réussit, mais que les erreurs suivantes se produisent, vous devez appeler IPropertySheetProvider::Show( –1, 0) pour libérer des objets. Le 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 , puis 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 handles de page de propriétés qu’il a créés. Cette opération peut être effectuée avant ou après les appels du composant logiciel enfichable IPropertySheetProvider::Show( –1, 0), car MMC n’utilise pas les descripteurs de page de propriétés.

Pour un composant logiciel enfichable qui cible MMC 1.1, le composant logiciel enfichable doit conserver une référence supplémentaire sur l’interface IDataObject qu’il transmet à MMC dans l’appel IPropertySheetProvider::CreatePropertySheet . Cette référence doit être conservée avant l’appel IPropertySheetProvider::CreatePropertySheet jusqu’à ce que la feuille de propriétés soit éventuellement fermée avec un appel à IPropertySheetProvider::Show( –1, 0).

Spécifications

Voir aussi

Idataobject

IPropertySheetProvider

IPropertySheetProvider::Show