__VSGSIFLAGS Enum

Reference

Definition

Namespace:: Microsoft.VisualStudio.Shell.Interop

Assembly:: Microsoft.VisualStudio.Shell.Interop.dll

Assembly:: Microsoft.VisualStudio.Interop.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Provides information about selection items and the VSITEMSELECTION structure.

This enumeration supports a bitwise combination of its member values.

public enum class __VSGSIFLAGS

public enum class __VSGSIFLAGS

enum __VSGSIFLAGS

[System.Flags]
public enum __VSGSIFLAGS

[<System.Flags>]
type __VSGSIFLAGS =

Public Enum __VSGSIFLAGS

Inheritance: Enum
__VSGSIFLAGS

Attributes: FlagsAttribute

Fields

GSI_fOmitHierPtrs

Indicates that the pHier field of VSITEMSELECTION structure should not be filled in (and therefore not AddRef()'d). This is useful in a case where a selection is within one hierarchy, as this value does not need to be filled. The pHier was already obtained through GetCurrentSelection(IntPtr, UInt32, IVsMultiItemSelect, IntPtr) or through OnSelectionChanged(IVsHierarchy, UInt32, IVsMultiItemSelect, ISelectionContainer, IVsHierarchy, UInt32, IVsMultiItemSelect, ISelectionContainer).

Remarks

COM Signature

From vsshell.idl:

Currently there is only one element of the __VSGSIFLAGS enumeration: GSI_fOmitHierPtrs. When set, GSI_fOmitHierPtrs indicates that the pHier member of the VSITEMSELECTION structure should not contain an IVsHierarchy pointer; it should remain null and therefore not be added to the reference count with IUnknown::AddRef.

Setting the GSI_fOmitHierPtrs flag is an optimization that is useful if a selection resides within one hierarchy. Because the IVsHierarchy pointer for the selection was already obtained through GetCurrentSelection or OnSelectionChanged, it need not be retrieved again.

Applies to