IVsToolboxClipboardCycler Interface

Reference

Definition

Namespace:: Microsoft.VisualStudio.Shell.Interop

Assembly:: Microsoft.VisualStudio.Shell.Interop.dll

Assembly:: Microsoft.VisualStudio.Interop.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Provides support for the clipboard ring to document windows and tool windows.

public interface class IVsToolboxClipboardCycler

public interface class IVsToolboxClipboardCycler

__interface IVsToolboxClipboardCycler

[System.Runtime.InteropServices.Guid("6A2A1D82-C590-4AB1-8CC2-D95BACBBA9E0")]
[System.Runtime.InteropServices.InterfaceType(1)]
public interface IVsToolboxClipboardCycler

[System.Runtime.InteropServices.Guid("6A2A1D82-C590-4AB1-8CC2-D95BACBBA9E0")]
[System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIUnknown)]
public interface IVsToolboxClipboardCycler

[<System.Runtime.InteropServices.Guid("6A2A1D82-C590-4AB1-8CC2-D95BACBBA9E0")>]
[<System.Runtime.InteropServices.InterfaceType(1)>]
type IVsToolboxClipboardCycler = interface

[<System.Runtime.InteropServices.Guid("6A2A1D82-C590-4AB1-8CC2-D95BACBBA9E0")>]
[<System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIUnknown)>]
type IVsToolboxClipboardCycler = interface

Public Interface IVsToolboxClipboardCycler

Derived: Microsoft.VisualStudio.Shell.Interop.IVsToolboxClipboardCycler2

Attributes: GuidAttribute InterfaceTypeAttribute

Remarks

Users can press CTRL+SHIFT+V to cycle through the contents of the clipboard. To know when to implement clipboard support CMDIDPasteNextTBXCBItem in your IOleCommandTarget implementation.

When managing the clipboard ring for the toolbox, call the methods of IVsToolboxClipboardCycler in the following order:

AreDataObjectsAvailableCall this method first to determine whether there are any clipboard objects to cycle through. If there are no items on the Toolbox clipboard, then the environment checks the system clipboard to see if there are any items on it. If there are items on the system clipboard, but not on the Toolbox clipboard, then the clipboard ring is populated with system items.
BeginCycleCall this method to start the clipboard cycle with the first item in the list, rather than the last active clipboard item.
GetAndSelectNextDataObject

Call this method to select the next item in the list.

Notes to Implementers

Implemented by the environment.

Notes to Callers

Called by a document window or tool window that wants to support clipboard cycling.

Methods

AreDataObjectsAvailable(IVsToolboxUser, Int32)	Determines whether any items are available to preview in the clipboard ring.
BeginCycle()	Forces the clipboard cycle to start at the top of the list.
GetAndSelectNextDataObject(IVsToolboxUser, IDataObject)	Gets the next data object for the target Toolbox user's clipboard ring.

Applies to