IVsMonitorSelection.GetCmdUIContextCookie Method (Microsoft.VisualStudio.Shell.Interop)

GetCmdUIContextCookie Method

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2005/.NET Framework 2.0

Other versions are also available for the following:

Visual Studio SDK

IVsMonitorSelection.GetCmdUIContextCookie Method

Registers a command UI context GUID and returns cookie value.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (in microsoft.visualstudio.shell.interop.dll)

Syntax

Visual Basic (Declaration)

Function GetCmdUIContextCookie ( _
	<InAttribute> ByRef rguidCmdUI As Guid, _
	<OutAttribute> ByRef pdwCmdUICookie As UInteger _
) As Integer

Visual Basic (Usage)

Dim instance As IVsMonitorSelection
Dim rguidCmdUI As Guid
Dim pdwCmdUICookie As UInteger
Dim returnValue As Integer

returnValue = instance.GetCmdUIContextCookie(rguidCmdUI, pdwCmdUICookie)

int GetCmdUIContextCookie (
	[InAttribute] ref Guid rguidCmdUI,
	out uint pdwCmdUICookie
)

C++

int GetCmdUIContextCookie (
	[InAttribute] Guid% rguidCmdUI, 
	[OutAttribute] unsigned int% pdwCmdUICookie
)

int GetCmdUIContextCookie (
	/** @attribute InAttribute() */ /** @ref */ Guid rguidCmdUI, 
	/** @attribute OutAttribute() */ /** @ref */ UInt32 pdwCmdUICookie
)

JScript

JScript does not support passing value-type arguments by reference.

Parameters

rguidCmdUI: [in] GUID representing a specific command UI context. Command UI context GUID values are defined by the environment and by VSPackages to meet specific needs. See the Remarks section below for a list of command UI GUIDs defined by the environment.

pdwCmdUICookie: [out] Pointer to a DWORD representing the GUID value in rguidCmdUI.

Return Value

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

COM Signature

From vsshell.idl:

C++

HRESULT IVsMonitorSelection::GetCmdUIContextCookie(
   [in]  REFGUID   rguidCmdUI,
   [out] VSCOOKIE *pdwCmdUICookie
);

This method registers the specified GUID and returns a cookie to represent that GUID. The active state of the GUID can be changed by calls to the SetCmdUIContext method and can be read by calls to the IsCmdUIContextActive method.

Note Once a GUID is registered through this method, the GUID remains registered until the IDE exits.

Command UI contexts involve associating a GUID to an action or a change in the UI. They are used in a variety of situations. VSPackages often define command UI contexts to associate a GUID to the activation of a toolbar or to the availability of a command. The environment defines the following command UI contexts. VSPackages are free to define additional context GUIDs but a VSPackage must change only the context GUIDs it registers.

Command UI Context	Description
UICONTEXT_SolutionBuilding	Build solution or build project mode is in effect.
UICONTEXT_Debugging	Debug mode is in effect. This includes running and break mode.
UICONTEXT_Dragging	Drag/drop operation is taking place. The environment turns this UI context on when a drag operation begins and turns it off when the drop occurs.
UICONTEXT_FullScreenMode	Full Screen command from the View menu has been selected.
UICONTEXT_DesignMode	Design mode is in effect.
UICONTEXT_NoSolution	There is no current solution.
UICONTEXT_EmptySolution	There are no current projects. The user has created a blank solution.
UICONTEXT_SolutionHasSingleProject	The current solution has one project.
UICONTEXT_SolutionHasMultipleProjects	The current solution has more than one project.

Reference

IVsMonitorSelection Interface
IVsMonitorSelection Members
Microsoft.VisualStudio.Shell.Interop Namespace