IVsButtonBarManager::AddButtonBar Method (Int32, IntPtr, IVsButtonBarClient^)

Visual Studio 2015

Adds a set of combo buttons to a code window.

Namespace: Microsoft.VisualStudio.TextManager.Interop
Assembly: Microsoft.VisualStudio.TextManager.Interop (in Microsoft.VisualStudio.TextManager.Interop.dll)

Syntax

C++

int AddButtonBar(
	int cButtons,
	IntPtr hImageList,
	IVsButtonBarClient^ pClient
)

Parameters

cButtons: Type: System::Int32
[in] The number of buttons in the button bar.

hImageList: Type: System::IntPtr
[in] Actually an HIMAGELIST, the list of images of buttons in the button bar.

pClient: Type: Microsoft.VisualStudio.TextManager.Interop::IVsButtonBarClient^
[in] The client to be associated with the button bar.

Return Value

Type: System::Int32

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

Remarks

COM Signature

From textmgr.idl:

C++

HRESULT IVsButtonBarManager::AddButtonBar(
   [in] long cButtons,
   [in] HANDLE hImageList,
   [in] IVsButtonBarClient *pClient
);

AddButtonBar adds a set of combo buttons to a code window. This call wraps the call to Attach. If there is already a button bar attached to the code window AddButtonBar returns E_UNEXPECTED. In general you should call GetButtonBar before calling AddButtonBar to ensure there isn't already a button bar associated with the given code window.