__VSGSIFLAGS Enumeration

Provides information about selection items and the VSITEMSELECTION structure.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

Namespace:  Microsoft.VisualStudio.Shell.Interop
Assembly:  Microsoft.VisualStudio.Shell.Interop (in Microsoft.VisualStudio.Shell.Interop.dll)

Syntax

'Declaration
<FlagsAttribute> _
Public Enumeration __VSGSIFLAGS
[FlagsAttribute]
public enum __VSGSIFLAGS
[FlagsAttribute]
public enum class __VSGSIFLAGS
[<FlagsAttribute>]
type __VSGSIFLAGS
public enum __VSGSIFLAGS

Members

Member name Description
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 or through OnSelectionChanged.

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 nulla null reference (Nothing in Visual Basic) 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.

See Also

Reference

Microsoft.VisualStudio.Shell.Interop Namespace