VSConstants.VSSELELEMID Enumeration
Constants used in IVsSelectionEvents to indicate a new selection state. The selections may be propagated through OnElementValueChanged.
Namespace: Microsoft.VisualStudio
Assembly: Microsoft.VisualStudio.Shell.12.0 (in Microsoft.VisualStudio.Shell.12.0.dll)
Syntax
'Declaration
Public Enumeration VSSELELEMID
public enum VSSELELEMID
public enum class VSSELELEMID
type VSSELELEMID
public enum VSSELELEMID
Members
| Member name | Description | |
|---|---|---|
| SEID_DocumentFrame | Visual Studio tracks this selection automatically so it cannot be set via OnElementValueChanged, but the value may be observed by calling GetCurrentElementValue | |
| SEID_LastWindowFrame | The value of SEID_WindowFrame before it received its current value. It is guaranteed to be different from SEID_WindowFrame unless both are empty. | |
| SEID_PropertyBrowserSID | IID_IUnknown of the active IVsPropertyBrowser. | |
| SEID_ResultList | IID_IUnknown of the active IOleCommandTarget for list navigation commands. | |
| SEID_StartupProject | IID_IUnknown of the active StartupProject. | |
| SEID_UndoManager | IID_IUnknown of the active IOleUndoManager object. | |
| SEID_UserContext | An event that indicates selection only by document windows that do not push selection context to the property browser. The alternative case is VSFPROPID_UserContext. | |
| SEID_WindowFrame | Visual Studio tracks this selection automatically so it cannot be set via OnElementValueChanged, but the value may be observed by calling GetCurrentElementValue |
Remarks
If your code only needs to know when a window is activated, first implement the IVsSelectionEvents interface then query the shell for the selection monitoring service. This means: QueryService the shell for the service SID_SVsShellMonitorSelection and its interface IID_IVsMonitorSelection, retrieving IVsMonitorSelection. Next on that interface IVsMonitorSelection call AdviseSelectionEvents and send it a pointer to the IVsSelectionEvents handler that you implemented above. In your handler for the OnElementValueChanged call, look for elementid == SEID_WindowFrame or elementid == SEID_DocumentFrame. Test the varValueNew parameter for a pointer to the window frame you are looking for. The following describes the significance of the OnElementValueChanged values:
SEID_WindowFrame |
Fires for both tool window and document window activation. |
SEID_DocumentFrame |
Fires only for document window activation. |
To get more selection information implement the IVsWindowFrameNotify interface. In previous versions of Visual Studio only the object set as the VSFPROPID_ViewHelper object was available. Visual Studio contains the new interface IVsWindowFrame2 which allows multiple parties to subscribe to these events.
Note
These element IDs are the only element IDs that can be used with the selection service. Do not attempt to pass any other element IDs.
Note
SEID_UserContext should be used only by document windows that do not push selection context to the property browser see VSFPROPID_UserContext for the alternative case.
Note
You can also use this mechanism to detect when you lose selection