Метод IPropertySheetProvider::Show (mmc.h)

Статья
08/24/2023

Если тип, заданный в IPropertySheetProvider::CreatePropertySheet , является листом свойств, IPropertySheetProvider::Show отображает фрейм листа свойств, родительский для скрытого окна. Если тип, заданный в IPropertySheetProvider::CreatePropertySheet , является мастером, IPropertySheetProvider::Show отображает фрейм листа свойств, родительский для дескриптора, передаваемого этому методу.

Синтаксис

HRESULT Show(
  [in] LONG_PTR window,
  [in] int      page
);

Параметры

[in] window

Значение типа , указывающее дескриптор родительского окна.

[in] page

Значение типа , указывающее, какая страница на странице свойств отображается. Индексируется с нуля.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

В ситуациях, когда оснастка создает страницу свойств при вызове IPropertySheetProvider::CreatePropertySheet, при необходимости вызывает IPropertySheetProvider::AddPrimaryPages и IPropertySheetProvider::AddExtensionPages, а затем решает не отображать страницу свойств, она должна вызвать IPropertySheetProvider::Show( –1, 0), чтобы удалить страницу свойств и освободить ее ресурсы. В этом случае оснастка должна удалить созданные маркеры страницы свойств. Это можно сделать до или после вызова оснастки IPropertySheetProvider::Show( –1, 0), так как MMC не использует дескрипторы страниц свойств.

IPropertySheetProvider::Show( –1, 0) удаляет только текущую страницу свойств, то есть созданную, но еще не показанную. После отображения страницы свойств оснастка не может закрыть ее программным способом. Только пользователь может закрыть отображаемый лист свойств. В этом случае MMC автоматически удаляет все связанные страницы свойств (структуры PROPSHEETPAGE ), предоставляемые оснасткой.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	mmc.h
DLL	Mmcndmgr.dll

См. также раздел

IPropertySheetProvider

Поделиться через