Item.EditCaption Property (ExRibbon)

The EditCaption property specifies the caption to be shown on the item's Edit text box. Use the AllowEdit property to add a text-box inside the item, so the user can type any characters inside. The EditWidth property specifies the width of the text-box inside the item. The EditBorder property specifies the border to be shown around the item's text box. You can use the Get method to collect all items of Edit type. The EditChange event notifies your application once the user alters the item's text-box caption. The EditValue property indicates the edit's value.

How can I change the edit's caption?

VBA (MS Access, Excell...)

With Ribbon1
	With .Items
		With .Add("Text")
			.AllowEdit = 1
			.EditCaption = "caption"
		End With
	End With
	.Refresh 
End With

VB6

With Ribbon1
	With .Items
		With .Add("Text")
			.AllowEdit = exItemEditText
			.EditCaption = "caption"
		End With
	End With
	.Refresh 
End With

VB.NET

With Exribbon1
	With .Items
		With .Add("Text")
			.AllowEdit = exontrol.EXRIBBONLib.AllowEditEnum.exItemEditText
			.EditCaption = "caption"
		End With
	End With
	.Refresh()
End With

VB.NET for /COM

With AxRibbon1
	With .Items
		With .Add("Text")
			.AllowEdit = EXRIBBONLib.AllowEditEnum.exItemEditText
			.EditCaption = "caption"
		End With
	End With
	.Refresh()
End With

C++

/*
	Copy and paste the following directives to your header file as
	it defines the namespace 'EXRIBBONLib' for the library: 'ExRibbon 1.0 Control Library'

	#import <ExRibbon.dll>
	using namespace EXRIBBONLib;
*/
EXRIBBONLib::IRibbonPtr spRibbon1 = GetDlgItem(IDC_RIBBON1)->GetControlUnknown();
EXRIBBONLib::IItemsPtr var_Items = spRibbon1->GetItems();
	EXRIBBONLib::IItemPtr var_Item = var_Items->Add(L"Text",vtMissing,vtMissing);
		var_Item->PutAllowEdit(EXRIBBONLib::exItemEditText);
		var_Item->PutEditCaption(L"caption");
spRibbon1->Refresh();

C++ Builder

Exribbonlib_tlb::IItemsPtr var_Items = Ribbon1->Items;
	Exribbonlib_tlb::IItemPtr var_Item = var_Items->Add(L"Text",TNoParam(),TNoParam());
		var_Item->AllowEdit = Exribbonlib_tlb::AllowEditEnum::exItemEditText;
		var_Item->EditCaption = L"caption";
Ribbon1->Refresh();

exontrol.EXRIBBONLib.Items var_Items = exribbon1.Items;
	exontrol.EXRIBBONLib.Item var_Item = var_Items.Add("Text",null,null);
		var_Item.AllowEdit = exontrol.EXRIBBONLib.AllowEditEnum.exItemEditText;
		var_Item.EditCaption = "caption";
exribbon1.Refresh();

JScript/JavaScript

<BODY onload='Init()'>
<OBJECT CLASSID="clsid:DDF58CFA-750F-45E0-8A00-CFBE431702E2" id="Ribbon1"></OBJECT>

<SCRIPT LANGUAGE="JScript">
function Init()
{
	var var_Items = Ribbon1.Items;
		var var_Item = var_Items.Add("Text",null,null);
			var_Item.AllowEdit = 1;
			var_Item.EditCaption = "caption";
	Ribbon1.Refresh();
}
</SCRIPT>
</BODY>

VBScript

<BODY onload='Init()'>
<OBJECT CLASSID="clsid:DDF58CFA-750F-45E0-8A00-CFBE431702E2" id="Ribbon1"></OBJECT>

<SCRIPT LANGUAGE="VBScript">
Function Init()
	With Ribbon1
		With .Items
			With .Add("Text")
				.AllowEdit = 1
				.EditCaption = "caption"
			End With
		End With
		.Refresh 
	End With
End Function
</SCRIPT>
</BODY>

C# for /COM

EXRIBBONLib.Items var_Items = axRibbon1.Items;
	EXRIBBONLib.Item var_Item = var_Items.Add("Text",null,null);
		var_Item.AllowEdit = EXRIBBONLib.AllowEditEnum.exItemEditText;
		var_Item.EditCaption = "caption";
axRibbon1.Refresh();

X++ (Dynamics Ax 2009)

public void init()
{
	COM com_Item,com_Items;
	anytype var_Item,var_Items;
	;

	super();

	var_Items = exribbon1.Items(); com_Items = var_Items;
		var_Item = com_Items.Add("Text"); com_Item = var_Item;
			com_Item.AllowEdit(1/*exItemEditText*/);
			com_Item.EditCaption("caption");
	exribbon1.Refresh();
}

Delphi 8 (.NET only)

with AxRibbon1 do
begin
	with Items do
	begin
		with Add('Text',Nil,Nil) do
		begin
			AllowEdit := EXRIBBONLib.AllowEditEnum.exItemEditText;
			EditCaption := 'caption';
		end;
	end;
	Refresh();
end

Delphi (standard)

with Ribbon1 do
begin
	with Items do
	begin
		with Add('Text',Null,Null) do
		begin
			AllowEdit := EXRIBBONLib_TLB.exItemEditText;
			EditCaption := 'caption';
		end;
	end;
	Refresh();
end

VFP

with thisform.Ribbon1
	with .Items
		with .Add("Text")
			.AllowEdit = 1
			.EditCaption = "caption"
		endwith
	endwith
	.Refresh
endwith

dBASE Plus

local oRibbon,var_Item,var_Items

oRibbon = form.Activex1.nativeObject
var_Items = oRibbon.Items
	var_Item = var_Items.Add("Text")
		var_Item.AllowEdit = 1
		var_Item.EditCaption = "caption"
oRibbon.Refresh()

XBasic (Alpha Five)

Dim oRibbon as P
Dim var_Item as P
Dim var_Items as P

oRibbon = topparent:CONTROL_ACTIVEX1.activex
var_Items = oRibbon.Items
	var_Item = var_Items.Add("Text")
		var_Item.AllowEdit = 1
		var_Item.EditCaption = "caption"
oRibbon.Refresh()

Visual Objects

local var_Item as IItem
local var_Items as IItems

var_Items := oDCOCX_Exontrol1:Items
	var_Item := var_Items:Add("Text",nil,nil)
		var_Item:AllowEdit := exItemEditText
		var_Item:EditCaption := "caption"
oDCOCX_Exontrol1:Refresh()

PowerBuilder

OleObject oRibbon,var_Item,var_Items

oRibbon = ole_1.Object
var_Items = oRibbon.Items
	var_Item = var_Items.Add("Text")
		var_Item.AllowEdit = 1
		var_Item.EditCaption = "caption"
oRibbon.Refresh()

Visual DataFlex

Procedure OnCreate
	Forward Send OnCreate
	Variant voItems
	Get ComItems to voItems
	Handle hoItems
	Get Create (RefClass(cComItems)) to hoItems
	Set pvComObject of hoItems to voItems
		Variant voItem
		Get ComAdd of hoItems "Text" Nothing Nothing to voItem
		Handle hoItem
		Get Create (RefClass(cComItem)) to hoItem
		Set pvComObject of hoItem to voItem
			Set ComAllowEdit of hoItem to OLEexItemEditText
			Set ComEditCaption of hoItem to "caption"
		Send Destroy to hoItem
	Send Destroy to hoItems
	Send ComRefresh
End_Procedure

XBase++

#include "AppEvent.ch"
#include "ActiveX.ch"

PROCEDURE Main
 	LOCAL oForm
	LOCAL nEvent := 0, mp1 := NIL, mp2 := NIL, oXbp := NIL
	LOCAL oItem
	LOCAL oItems
	LOCAL oRibbon

	oForm := XbpDialog():new( AppDesktop() )
	oForm:drawingArea:clipChildren := .T.
	oForm:create( ,,{100,100}, {640,480},, .F. )
	oForm:close  := {|| PostAppEvent( xbeP_Quit )}

	oRibbon := XbpActiveXControl():new( oForm:drawingArea )
	oRibbon:CLSID  := "Exontrol.Ribbon.1" /*{DDF58CFA-750F-45E0-8A00-CFBE431702E2}*/
	oRibbon:create(,, {10,60},{610,370} )

		oItems := oRibbon:Items()
			oItem := oItems:Add("Text")
				oItem:AllowEdit := 1/*exItemEditText*/
				oItem:EditCaption := "caption"
		oRibbon:Refresh()

	oForm:Show()
	DO WHILE nEvent != xbeP_Quit
		nEvent := AppEvent( @mp1, @mp2, @oXbp )
		oXbp:handleEvent( nEvent, mp1, mp2 )
	ENDDO 
RETURN

		Type	Description
		String	A String expression that specifies the caption to be shown on the item's text box.