Export (0) Print
Expand All

IVsToolboxClipboardCycler.GetAndSelectNextDataObject Method

Gets the next data object for the target Toolbox user's clipboard ring.

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

int GetAndSelectNextDataObject (
	[InAttribute] IVsToolboxUser pTarget,
	out IDataObject ppDO
int GetAndSelectNextDataObject (
	/** @attribute InAttribute() */ IVsToolboxUser pTarget, 
	/** @attribute OutAttribute() */ /** @ref */ IDataObject ppDO
JScript does not support passing value-type arguments by reference.



[in] Target Toolbox user to cycle through clipboard items.


[out] Pointer to the next data object in the list.

Return Value

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

COM Signature

From vsshell.idl:

HRESULT IVsToolboxClipboardCycler::GetAndSelectNextDataObject(
   [in] IVsToolboxUser *pTarget,
   [out] IDataObject **ppDO

This method requires you to specify an IVsToolboxUser and does not assume that the IVsToolboxUser for the active document is the target toolbox user. Because IVsToolboxUser is reserved for documents, you need to implement IVsToolboxUser if you want to provide clipboard cycling for a tool window. Once you do this, you can implement clipboard cycling by passing in your tool window's IVsToolboxUser in a call to IVsToolboxClipboardCycler::GetAndSelectNextDataObject.

Community Additions

© 2015 Microsoft