IVsAddProjectItemDlg2.AddProjectItemDlgTitledEx(UInt32, Guid, IVsProject, UInt32, String, String, String, String, String, String, String, Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет дополнительные функциональные возможности методу AddProjectItemDlgTitled(UInt32, Guid, IVsProject, UInt32, String, String, String, String, String, Int32), такие как представление в виде дерева, справка и выбор и расширение каталога по умолчанию.
public:
int AddProjectItemDlgTitledEx(System::UInt32 itemidLoc, Guid % rguidProject, Microsoft::VisualStudio::Shell::Interop::IVsProject ^ pProject, System::UInt32 grfAddFlags, System::String ^ lpszDlgTitle, System::String ^ lpszTreeViewTitle, System::String ^ lpszHelpTopic, System::String ^ lpszExpand, System::String ^ lpszSelect, [Runtime::InteropServices::Out] System::String ^ % pbstrLocation, [Runtime::InteropServices::Out] System::String ^ % pbstrFilter, [Runtime::InteropServices::Out] int % pfDontShowAgain);
public int AddProjectItemDlgTitledEx (uint itemidLoc, ref Guid rguidProject, Microsoft.VisualStudio.Shell.Interop.IVsProject pProject, uint grfAddFlags, string lpszDlgTitle, string lpszTreeViewTitle, string lpszHelpTopic, string lpszExpand, string lpszSelect, out string pbstrLocation, out string pbstrFilter, out int pfDontShowAgain);
abstract member AddProjectItemDlgTitledEx : uint32 * Guid * Microsoft.VisualStudio.Shell.Interop.IVsProject * uint32 * string * string * string * string * string * string * string * int -> int
Public Function AddProjectItemDlgTitledEx (itemidLoc As UInteger, ByRef rguidProject As Guid, pProject As IVsProject, grfAddFlags As UInteger, lpszDlgTitle As String, lpszTreeViewTitle As String, lpszHelpTopic As String, lpszExpand As String, lpszSelect As String, ByRef pbstrLocation As String, ByRef pbstrFilter As String, ByRef pfDontShowAgain As Integer) As Integer
Параметры
- itemidLoc
- UInt32
[in] Идентификатор элемента папки проекта, куда должны быть добавлены элементы. Это полезно только для проектов на основе каталогов. Проекты, не основанные на каталогах, передают VSITEMID_ROOT. Диалоговое окно Добавление элемента не использует параметр, за исключением передачи обратно в AddItem(UInt32, VSADDITEMOPERATION, String, UInt32, String[], IntPtr, VSADDRESULT[]) .
- rguidProject
- Guid
[in] Идентификатор для типа проекта. Этот идентификатор должен быть зарегистрирован в подразделе Projects раздела реестра Microsoft Visual Studio. В этом диалоговом окне используются следующие сведения в этом ключе: Итемтемплатедир value, который должен содержать путь к каталогу, содержащему шаблоны элементов для этого типа проекта.
Filters ключ, который используется для создания открытых фильтров для существующей вкладки. В диалоговом окне отображаются элементы и фильтры, относящиеся к этому типу проекта.
- pProject
- IVsProject
[in] Указатель на интерфейс IVsProject3, с помощью которого диалоговое окно формирует имена по умолчанию для каждого элемента, вызывая метод GenerateUniqueItemName(UInt32, String, String, String) интерфейса, а также добавляет элементы в проект, вызывая метод AddItem(UInt32, VSADDITEMOPERATION, String, UInt32, String[], IntPtr, VSADDRESULT[]).
- grfAddFlags
- UInt32
[in] Значения флага, изменяющие поведение диалогового окна. Значения берутся из перечисления __VSADDITEMFLAGS.
- lpszDlgTitle
- String
[in] Заголовок диалогового окна.
- lpszTreeViewTitle
- String
окне Заголовок TreeView. null == "Категории".
- lpszHelpTopic
- String
окне Имя раздела справки. null = = "VS. Add [новый | существующий] элемент".
- lpszExpand
- String
[in] Каталог, который необходимо выбрать или развернуть по умолчанию.
- lpszSelect
- String
[in] Выбираемый элемент.
- pbstrLocation
- String
[in, out] Указатель на поле расположения (начальное или конечное значение). Этот параметр используется, только если задать значение VSADDITEM_ShowLocationField. Чтобы проект реализовывал поведение залипания для поля фильтра, что рекомендуется, для поля расположения передайте последнее значение поля расположения обратно при повторном открытии диалогового окна.
- pbstrFilter
- String
[вход, выход] Значение строки фильтра на существующей вкладке. Укажите вместо параметра значение VSADDITEM_AllowStickyFilter VSADDITEM_AllowStickyFilter . Чтобы проект реализовывал поведение залипания для поля фильтра, что рекомендуется, передайте последнее значение поля фильтра обратно при повторном открытии диалогового окна.
- pfDontShowAgain
- Int32
заполняет Признак того, выбран ли пользователь или снят флажок больше не показывать это диалоговое окно. Этот параметр используется, только если задается VSADDITEM_ShowDontShowAgain. Для реализации параметра, что рекомендуется, вызовите напрямую метод AddItem(UInt32, VSADDITEMOPERATION, String, UInt32, String[], IntPtr, VSADDRESULT[]) последнего выбранного шаблона элемента. Обычно проект имеет отдельный параметр "Больше не показывать" для каждого типа элемента, как форма модуль и класс.
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.
Комментарии
Подпись COM
Из всшелл. IDL:
HRESULT IVsAddProjectItemDlg2::AddProjectItemDlgTitledEx(
[in] VSITEMID itemidLoc,
[in] REFGUID rguidProject,
[in] IVsProject *pProject,
[in] VSADDITEMFLAGS grfAddFlags,
[in] LPCOLESTR lpszDlgTitle,
[in] LPCOLESTR lpszTreeViewTitle,
[in] LPCOLESTR lpszHelpTopic,
[in] LPCOLESTR lpszExpand,
[in] LPCOLESTR lpszSelect,
[in, out] BSTR *pbstrLocation,
[in, out] BSTR *pbstrFilter,
[out] BOOL *pfDontShowAgain
);