Share via


__VSGSIFLAGS Enum

Definition

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
__VSGSIFLAGS
Attributes

Fields

Name Value Description
GSI_fOmitHierPtrs 1

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