VsHierarchyPropID Enumeration
Specifies the property identifiers associated with the property settings for a hierarchy.
Namespace: Microsoft.VisualStudio.Shell
Assembly: Microsoft.VisualStudio.Shell.11.0 (in Microsoft.VisualStudio.Shell.11.0.dll)
Syntax
'Declaration
Public Enumeration VsHierarchyPropID
public enum VsHierarchyPropID
public enum class VsHierarchyPropID
type VsHierarchyPropID
public enum VsHierarchyPropID
Members
Member name | Description | |
---|---|---|
AddItemTemplatesGuid | An optional alternative project type GUID to use to get add item templates. | |
AllowEditInRunMode | Indicates whether the compiler allows edits during run mode. This property is optional.
If false or E_NOTIMPL, the compiler disallows edits during run mode (which is the most commonly expected behavior). If true, the compiler allows edits. This property enables Visual Studio for Applications scenarios. |
|
AltHierarchy | An IVsHierarchy for SVsTrackSelectionEx. This property is optional | |
AltItemid | An item identifier for SVsTrackSelectionEx. This property is optional. | |
AlwaysBuildOnDebugLaunch | Indicates whether your project always builds on debug launch (F5) when the “Only build startup projects and dependencies on Run” Tools option is set. This property is optional.
Set this property to true in your project hierarchy if you want your project to always build on debug launch in this case. This ensures that your project is built even if your project is not declared as a build dependency of the startup project. This property is a workaround for the fact that currently there is only support for build dependencies (IVsBuildDependency) and not deploy dependencies in the solution build manager. This property will be used rarely in circumstances where you may have a circular set of dependencies involving a combination of build and deploy dependencies between multiple projects (for example, A has a build dependency on B while B has a deploy dependency on A; if B is the startup project, then solution build manager would not realize it needs to build A to satisfy the required deploy dependency when the above mentioned Tools option is set). |
|
AppContainer | Indicates whether the project's output requires running in an app container or not. This property is optional. If true, the project’s output requires running in an app container. If false, the output des not require running in an app container. | |
AppTitleBarTopHierarchyName | The hierarchy’s topmost name (solution or server) to put into the title bar of the application. This property is optional. | |
BrowseObject | An IDispatch for property browsing. This property is optional. | |
BrowseObjectCATID | An intrinsic extender category identifier (CATID) GUID of the BrowseObject for the given IVsHierarchy item identifier. For VSITEMID_ROOT, this corresponds to the object used to build the “Project.Properties” collection. This property is optional. | |
BuildDependencies | A semicolon-separated list of projects required to build this project. This property is optional.
If this property is not implemented, EnumDependencies is used. |
|
CanBuildFromMemory | Indicates if a build can be done from memory. This property is optional.
If true, no prompt to save is required before building. |
|
Caption | The full window caption. | |
CategoryGuid | The GUID to identify the family/category of this non-Solution based Hierarchy (for example, Portfolio Project Hierarchy). | |
CfgBrowseObjectCATID | An intrinsic extender category identifier (CATID) GUID of the configuration BrowseObject for the given IVsHierarchy item identifier. This property is optional. | |
CfgPropertyPagesCLSIDList | A semicolon delimited list of class identifiers (CLSID) of the configuration-dependent property pages. This property is optional. | |
ChildrenEnumerated | Indicates if children have been enumerated. This property is optional.
If true children have been enumerated. Typically, this is only of interest for projects where enumerating children can be expensive (that is, Web projects). |
|
CmdUIGuid | A GUID used to control visibility of toolbars and AutoVisible tool windows. | |
ConfigurationProvider | Obsolete. Use the IVsGetCfgProvider interface instead. | |
Container | Indicates if the item is a container. This property is optional.
If true, the item is a container (it may not be expandable, but it contains items). |
|
DebuggeeProcessId | The process identifier of debuggee (if known), otherwise zero. | |
DebuggerSourcePaths | A semi-colon delimited list of paths in which the debugger looks for source. This property is optional. | |
DefaultEnableBuildProjectCfg | Indicates whether "Build" should be initially checked by default in the solution configuration. This property is optional.
Normally "Build" is checked by default if the project supports IVsBuildableProjectCfg. |
|
DefaultEnableDeployProjectCfg | Indicates whether "Deploy" should be initially checked by default in the solution configuration. This property is optional.
Normally "Deploy" is checked by default if the project supports IVsDeployableProjectCfg. |
|
DefaultNamespace | A string representing the items folder-based namespace. This property is optional.
The format of the string is "rootnamespace.folder.subfolder". |
|
DemandLoadDependencies | Indicates the demand load dependencies. This property is optional.
If true (default) and the project was loaded synchronously, all its dependencies are also loaded synchronously. If false and the project was loaded synchronously, those of its dependencies that support asynchronous load may be loaded asynchronously. |
|
DescriptiveName | A more descriptive name of the item. Replaces the running document table moniker in document windows tooltips or other parts of the UI. This property is optional. | |
DesignerFunctionVisibility | The property that contains how designer functions are marked.
The value of this property is derived from VSDESIGNER_FUNCTIONVISIBILITY. |
|
DesignerHiddenCodeGeneration | The code that is supposed to go to the hidden designer file.
This property contains bit flag values from __VSDESIGNER_HIDDENCODEGENERATION. |
|
DesignerVariableNaming | The case with which the variables are generated. This property is optional.
The value of this property derives from the VSDESIGNER_VARIABLENAMING enumeration. |
|
DesignTimeDependencies | A semicolon-separated list of projects required to support design time features (Intellisense, Form designers, and so on). This property is optional.
If this property is not implemented, GetProperty(VSHPROPID_BuildDependencies) will be used instead. |
|
DisableApplicationSettings | Indicates whether Application Settings design time support in your project should be disabled. This property is optional.
If true in your hierarchy, Application Settings design time support in your project is disabled. |
|
EditLabel | A string to be displayed for the in-place editing node caption. This property is optional. | |
EnableDataSourceWindow | Indicates whether the Data Source Window for this project should be disabled. This property is optional.
If true in your hierarchy, the Data Source Window is disabled. |
|
ExcludeFromExportItemTemplate | Indicates if the project item can be exported using the export item template. This property is optional.
If true, the project item cannot be exported. If false (default), the project item can be exported. |
|
Expandable | Indicates if the Shell displays the “open-this-folder” plus sign.
If true, the plus sign is displayed. If false, the plus sign is not displayed. |
|
ExpandByDefault | Indicates if the Shell should expand this item.
If true, the item should be expanded. If false, the item should not be expanded. |
|
Expanded | Indicates if the node is currently expanded in the UIHierarchyWindow.
If true, the node is currently expanded. If false, the node is not expanded. If this property starts as false, the UIHierarchyWindow will update. |
|
ExternalItem | Indicates if this item is to be considered external to the solution. This property is optional.
If true, the item is considered external. If false, the item is not considered external. |
|
ExtObject | The ext.object for the ITEMID_ROOT item identifier of the project (Project). For other item identifiers, this property contains that item's ext object (ProjectItem), if any. This property is optional. | |
ExtObjectCATID | The intrinsic extender category identifier (CATID) GUID of the ExtObject (Automation Object) for the given IVsHierarchy item identifier. For VSITEMID_ROOT this corresponds to the type of the “Project” object. This property is optional. | |
ExtSelectedItem | A custom SelectedItem object for the given item identifier. This property is optional.
If not supported, then a default implementation is provided. |
|
FaultMessage | A localized message indicating the reason for a faulted project. This property is optional.
This string is used in the fault resolution UI. |
|
FirstChild | The item identifier of the first child node (ITEMID_NIL if there are no children). | |
FirstVisibleChild | Similar to FirstChild but the property specified by this member only walks items to be displayed in the UIHierarchyWindow. This property is optional. However, this property is required if the hierarchy supports multiple (subset or superset) views of its contents. | |
HandlesOwnReload | Indicates if the project handles its own unload and reload. This property is optional.
If true, the project handles its own unload and reload. If false (default), the environment handles the unload and reload. |
|
HasEnumerationSideEffects | Indicates if this hierarchy is to be enumerated for Find In Files and similar hierarchy enumerations. This property is optional.
If true, then this hierarchy will not be enumerated (this is useful if enumerating might cause a login dialog or is unacceptably slow). If false, then this hierarchy will be enumerated. |
|
IconHandle | A handle of an icon; UIHierarchyWindow does not call DestroyIcon on it.
Your hierarchy should support IconHandle or IconImgList/ IconIndex, but not both. |
|
IconImgList | A handle to an image list for an icon. Use only when itemid==VSITEMID_ROOT). | |
IconIndex | An index for an icon.
If Expandable is true, then IconIndex+1 is used for the open icon. |
|
ImplantHierarchy | The IVsHierarchy implant for this hierarchy. This property is optional.
Hold the implant as an UNADDREF ptr in SetProperty. The implant can implement IVsFilterAddProjectItemDlg and/or IVsToolboxUser. |
|
IntellisenseUnknown | The IUnknown of the Intellisense compiler used by the project system. This property is optional. | |
IsFaulted | Indicates if the project has encountered an error. This property is optional.
For project hierarchies, set this property to true to indicate that the project has encountered an error. Implementations should raise property change events to all IVsHierarchyEvents sinks whenever this value changes. |
|
IsFindInFilesForegroundOnly | Indicates where Find In Files runs. This property is optional.
If true, Find In Files runs in the main thread. |
|
IsHiddenItem | Indicates if the item is not displayed in the current UIHierarchyWindow view. This property is optional. However, this property is required if your hierarchy supports multiple (subsetted) views of its contents.
If true, the item is not displayed. |
|
IsLinkFile | true if the file is a link file. This property is optional. | |
IsNewUnsavedItem | Indicates if this is a new unsaved item. This property is optional.
If true, this is a new unsaved item (as obtained from File.New.File). |
|
IsNonLocalStorage | Indicates if project storage is local. This property is optional.
If true, project storage is local. IPersistFileFormat is used for saving a project regardless of whether it is a local "file" or not. |
|
IsNonMemberItem | Indicates if an item is not considered a member of the hierarchy. This property is optional. However, it is required if your hierarchy supports superset views of its contents (for example, ShowAllFiles displaying files in a directory that are not members of the project).
If true, the item is not considered a member of the hierarchy. |
|
IsNonSearchable | Indicates if an item can be searched for or replaced using Find in Files or Replace in Files. This property is optional.
If true, the item cannot be searched for or replaced. This property should be true for the project file. |
|
IsUpgradeRequired | Indicates if an upgrade is required. This property is optional.
If true, the item or any of its children are either already in the process of upgrading or must be upgraded. |
|
ItemDocCookie | The document cookie (VSCOOKIE) of the hierarchy item. This property is optional. | |
ItemSubType | A non-localized string representing the subtype of the item. This property is optional.
It is up to each package to agree on the meaning of this string. |
|
KeepAliveDocument | Indicates if the document should be kept alive in the project regardless of its opened or closed state. This property is optional.
If true, the document should be kept alive. |
|
MinimumDesignTimeCompatVersion | The minimum design time compatible version with which this project is compatible. This property is optional.
The value of this property is mostly set by the IVsAppCompat service during the addition of a new feature in the project that would break compatibility with a previous version of the application. |
|
Name | The name for the project (VSITEMID_ROOT) or item. | |
NextSibling | The item identifier of the next sibling node (ITEMID_NIL if there are no more siblings). | |
NextVisibleSibling | Similar to NextSibling but the property specified by this member only walks items to be displayed in UIHierarchyWindow. This property is optional. However, this property is required if your hierarchy supports multiple (subset or superset) views of its contents. | |
NIL | ||
NoDefaultNestedHierSorting | Indicates if the hierarchy does not want nested hierarchies sorted first and items after, and sorted alphabetically (like solution folders). This property is optional.
If true, the hierarchy does not want nested hierarchies sorted first and items after, and sorted alphabetically. |
|
OpenFolderIconHandle | The handle of an icon for an open folder; UIHierarchyWindow does not call DestroyIcon on it. This property is optional. | |
OpenFolderIconIndex | The open folder’s icon index. This property is optional. | |
OutputType | The output type for a project. This property is optional.
The value of this property derives from the __VSPROJOUTPUTTYPE enumeration. |
|
OverlayIconIndex | The overlay for the item's main icon. This property is optional.
The value of this property derives from the VSOVERLAYICON enumeration. |
|
OwnerKey | The owner key string that identifies the project GUID of the owning project. This property is optional.
Only projects that implement IVsOwnedProjectFactory should support SetProperty for this property. |
|
Parent | The item identifier of the parent node (ITEMID_NIL if no parent exists). | |
ParentHierarchy | The IVsHierarchy that owns this hierarchy.
The value of this property is held as an UNADDREF ptr in SetProperty. |
|
ParentHierarchyItemid | The item identifier of this hierarchy in its parent hierarchy. | |
PreferredLanguageSID | The preferred security identifier (SID) of the text editor language service for the project. This property is optional.
As an example, this property can be used to determine the default language for the Breakpoint dialog. |
|
PriorityPropertyPagesCLSIDList | A semicolon-delimited ordered list of class identifiers of the preferred property pages. This property is optional.
A Project Designer that shows configuration-independent and configuration-dependent property pages in a flat list should use this order as the preferred order for the pages. A project that uses the standard property page frame can ignore this property because the property page frame does not mix the two types of pages in a flat list. |
|
ProductBrandName | The hierarchy branding used to replace the application name in the main window title. This property is optional. | |
ProjectCapabilities | A space-delimited list of the project's capabilities. This property is optional. | |
ProjectDesignerEditor | The GUID of the project designer editor the project uses to edit project properties (SupportsProjectDesigner should return VARIANT_TRUE if a project designer editor GUID is returned). This property is optional.
This GUID corresponds to an IVsEditorFactory that launches an editor for the project properties. A project designer is an editor for project properties that is launched as a document associated with the root of the project (see IVsSpecifyProjectDesignerPages for more information). |
|
ProjectDir | The full path to the project directory (for VSITEMID_ROOT only). This property is optional. | |
ProjectIDGuid | A GUID that identifies a project across solutions. This property is optional.
The value of this property is generated and set when a project is created. It is retrieved when the project is opened. |
|
ProjectName | Obsolete. Use Name instead. | |
ProjectType | Obsolete. Use TypeName instead. | |
ProjectUnloadStatus | The unload status (UNLOADSTATUS_UnloadedByUser, UNLOADSTATUS_LoadPendingIfNeeded, and so on) from the _VSProjectUnloadStatus enumeration, and is implemented only by the stub hierarchy. This property is optional. | |
PropertyPagesCLSIDList | A semicolon-delimited list of class identifiers of the configuration independent property pages. This property is optional. | |
ProvisionalViewingStatus | The provisional viewing status for the item (from the __VSPROVISIONALVIEWINGSTATUS enumeration). This property is optional.
If this property is not supported and the hierarchy implements IVsProject, the provisional viewing status is determined by calling GetProvisionalViewingStatusForFile with the name returned by GetMkDocument. |
|
RefactorExtensions | An array of service GUIDs that implement IVsRefactorNotify and for which this interface should be called for any refactoring operation in the project (only defined for VSITEMID_ROOT). This property is optional.
Add to this property by creating registry values under the local registry root's Projects\<project type GUID>\FileExtensions\<file extension> key with name "RefactorNotify". Then if there is a file with this extension in the project, the VSHPROPID_Extensions property contains the data from this registry value. |
|
ReferenceManagerUser | The implementation of IVsReferenceManagerUser for a project. This property is optional. | |
ReloadableProjectFile | Obsolete. Use HandlesOwnReload instead. | |
RequiresReloadForExternalFileChange | Indicates whether the file on disk was not last written by the project. This property is optional.
If true, the file on disk was not last written by the project and thus the user should be prompted to reload due to an external change to the file. This property is defined for ITEMID_ROOT. It is expected that this property is only called during a FilesChanged event handler. The expected implementation is for projects to record the timestamp on the project file when the file is saved. Later when this property is requested, the project should compare the current timestamp of the file to the last recorded save timestamp. If they are not equal then return true, else return false (that is, a reload is not required). |
|
Root | Obsolete. The item identifier of root must be VSITEMID_ROOT. | |
SaveName | The name to be used during a save.
This property is needed so the shell (that is, the File->Save menu item) can display the name in the UI. |
|
SelContainer | An ISelectionContainer for property browsing. This property is optional. | |
ServiceReferenceSupported | Indicates if the project supports service references. This property is optional.
If true, the project supports service references. |
|
ShowOnlyItemCaption | Indicates if this is an item for which only the caption should be shown in the UI instead of the full moniker. This property is optional.
If true, only the caption is shown. |
|
ShowProjInSolutionPage | Indicates whether to filter the project when Visual Basic or C# calls the component picker for add-reference. This property is optional.
If true, the project is shown in the list. |
|
SortPriority | The sort priority in [UIHierarchyWindow]. This property is optional.
Standard projects have priority 0 (default). A MiscFiles project has priority 10000, and a SolutionItems project has priority 9999. |
|
StartupServices | An IVsProjectStartupServices to add services to be started on the next project load (for VSITEMID_ROOT only). | |
StateIconIndex | The state icon index.
The value of this property is derived from the VsStateIcon enumeration. |
|
StatusBarClientText | The hierarchy scoped text for the Client Text field of the status bar.
This text in this property is displayed while the given hierarchy is the active hierarchy. VT_EMPTY clears hierarchy scoped text and resets to the global text specified by the application. |
|
StorageType | A non-localized string representing the storage type. This property is optional.
This property is the same as the string used in the VSDIR file to differentiate between different location MRU lists. |
|
SupportedMyApplicationTypes | A semicolon-delimited list of application-types supported for project-systems that support My.Application. This property is optional.
The property-page that exposes information about My.Application can use this list to determine which values appear in the application-type dropdown as selectable choices for the user. The current list of supported values for Visual Basic's implementation is:
An example value that supports all types is "WindowsApp;WindowsClassLib;CommandLineApp;WindowsService;WebControl". |
|
SupportedOutputTypes | A list of supported output types (specified as values used by the OutputTypeEx project property). This property is optional.
This property allows a flavor to customize the contents of the output type dropdown in the property pages. This property is checked first by the property pages, so this property effectively overrides the SupportedMyApplicationTypes property used by the Visual Basic property page. |
|
SupportsAspNetIntegration | Indicates if your Web project supports being consumed by Silverlight. This property is optional.
Set this property to true in your project hierarchy if your Web project supports being consumed by Silverlight. |
|
SupportsHierarchicalUpdate | Indicates whether to enable Hierarchical Update for this project. This property is optional.
Set this property to true in your project hierarchy to enable Hierarchical Update for this project. Setting this property to true generates typed datasets with TableAdapterManager and associated methods for enabling Hierarchical Update. |
|
SupportsLinqOverDataSet | Indicates whether to enable LINQ to DataSet for this project. This property is optional.
Set this property to true in your project hierarchy to enable LINQ to DataSet. Setting this property to true generates typed datasets with data tables that inherit from System.Data.TypedTableBase in order to enable LINQ queries. |
|
SupportsNTierDesigner | Indicates whether to enable the N-Tier designer for this project. This property is optional.
Set this property to true in your project hierarchy to enable the N-Tier designer. Setting this property to true creates datasets with the Dataset Project property for generating Datasets and TableAdapters into separate projects. |
|
SupportsProjectDesigner | Indicates if the project uses a Project Designer Editor instead of the property page frame to edit project properties. This property is optional.
If true, the project uses a Project Designer Editor. |
|
SuppressOutOfDateMessageOnBuild | Indicates whether the project participates in the “this configuration is out of date” message on Build (F5). This property is optional.
If true, the project does not participate. |
|
TargetFrameworkMoniker | The format for the target framework moniker.
The format of the target framework moniker is "<Identifier>,Version=<ver>,Profile=<value>" (for example, ".NETFramework,Version=v3.5,Profile=Client"). |
|
TargetFrameworkVersion | The Target Framework version.
The high word is the major version and the low word is the minor version. |
|
TargetPlatformIdentifier | The Target Platform for a project type. This property is optional.
Examples are “Windows”, “Windows Phone”, “Windows Azure”, “XBox 360”, and “Portable”. |
|
TargetPlatformVersion | The version of the target platform (for example, “8.0”). This property is optional. However, it is required if TargetPlatformIdentifier is provided. | |
TargetRuntime | The runtime the project targets (derived from the __VSPROJTARGETRUNTIME enumeration). This property is optional. | |
TypeGuid | The GUID used to identify the type of node/hierarchy (search on GUID_ItemType). | |
TypeName | The display name used to identify the type of node/hierarchy (used in the title bar). | |
UseInnerHierarchyIconList | Indicates if the icon for an inner (nested) hierarchy root is to come from the inner hierarchy image list. This property is optional.
If true in the outer hierarchy, the icon for an inner (nested) hierarchy root comes from the inner hierarchy image list. If false (default), the icon comes from the outer hierarchy image list. |
|
UserContext | The IVsUserContext for the project/item. This property is optional. | |
WebReferenceSupported | Indicates if the project supports Web references. This property is optional.
If true, the project supports Web references. |