IVsPackage.ResetDefaults(UInt32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Сбрасывает значения по умолчанию Панели элементов.
public:
int ResetDefaults(System::UInt32 grfFlags);
public:
int ResetDefaults(unsigned int grfFlags);
int ResetDefaults(unsigned int grfFlags);
public int ResetDefaults (uint grfFlags);
abstract member ResetDefaults : uint32 -> int
Public Function ResetDefaults (grfFlags As UInteger) As Integer
Параметры
- grfFlags
- UInt32
[in] Флаги, значения которых берутся из перечисления __VSPKGRESETFLAGS.
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.
Комментарии
Подпись COM
Из всшелл. IDL:
HRESULT IVsPackage::ResetDefaults(
[in] VSPKGRESETFLAGS grfFlags
);
Реализуйте этот метод при установке элементов или средств на панели элементов. При установке среда загружает пакет VSPackage и вызывает его IVsPackage::ResetDefaults реализацию. После успешной настройки пакета VSPackage ResetDefaults метод не будет вызываться при последующих установках, если не увеличить ключ элементов по умолчанию в реестре (находится в HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\7.1\Packages\<пакета GUID > \тулбокс]) или если пользователь переустановит панель элементов. При увеличении раздела реестра "элементы по умолчанию" ResetDefaults метод вызывается с параметром grfFlags и, PKGRF_TOOLBOXSETUP Если панель элементов сброшена, ResetDefaults метод вызывается с grfFlags PKGRF_TOOLBOXITEMS параметром. Для получения дополнительной информации см. Registering Toolbox Item Providers.
Пользователь может сбросить область элементов , выбрав область элементов в меню вид , щелкнув правой кнопкой мыши в разделе компоненты панели элементов и выбрав пункт Добавить или удалить элементы. Откроется диалоговое окно Настройка панели элементов , в котором содержится кнопка Сброс . Нажатие кнопки Сброс приводит к сбросу панели элементов.
Если IVsPackage.ResetDefaults метод должен вызываться только во время установки, не нужно реализовывать IVsToolboxDataProvider интерфейс или указывать раздел реестра formats (в [ <VS Reg Root> \ПАККАЖЕС \<пакет GUID > \тулбокс]). Дополнительные сведения см. в разделе How to: Include Toolbox Support и IVsToolboxDataProvider интерфейс. Если IVsPackage::ResetDefaults реализация вызывается со значением PKGRF_ADDSTDPREVIEWER в grfFlags параметре, вызовите AddStandardPreviewer в это время, чтобы заполнить диалоговое окно Просмотр с конкретным браузером. Например, этот подход можно использовать для предоставления особого эмулятора для вашего продукта.