Difference between revisions of "RibbonX Collections"
From Ribbon Commander Documentation
(→VBA) |
(→VBA) |
||
| Line 44: | Line 44: | ||
Set myButton = New rxButton | Set myButton = New rxButton | ||
myButton.ID = "my_button" | myButton.ID = "my_button" | ||
| − | + | ||
| − | + | ||
' Add the button to the group's buttons collection | ' Add the button to the group's buttons collection | ||
myGroup.Buttons.Add myButton | myGroup.Buttons.Add myButton | ||
| Line 66: | Line 65: | ||
' Remove an item by index | ' Remove an item by index | ||
myGroup.Buttons.Remove 1 | myGroup.Buttons.Remove 1 | ||
| + | |||
| + | ' Print number of buttons in the group (prints 0) | ||
| + | Debug.Print myGroup.Buttons.Count | ||
' Add the item back and remove it by object reference | ' Add the item back and remove it by object reference | ||
Revision as of 16:00, 14 March 2013
This section is under construction. Please do not rely on any information it contains.
Contents
Description
The section describes the generic interface of Dynamic RibbonX collection and the operations that can be performed on them.
Properties
Property Name
|
Description
|
| count | Read-only property; returns the count of items in a collection |
| isEmpty | Read-only property; returns true if the control is empty |
| isLive | Read-only property; returns true if the control is live |
| item | (VBA/VB.NET-specific) Returns a reference to a collection member by index or id |
| parent | The control's parent object |
Methods
Method Name
|
Description
|
| add | Adds an item to the collection |
| getItemIfExists | Returns a reference to a collection member by index or id. Does not throw if the index or id is out of bounds. |
| remove | Removes an item from the collection (by index or item reference) |
| removeAll | Removes all items from the collection |
| operator[] | (C#-specific) Returns a reference to a collection member by index or id |
| operator() | (VBA/VB.NET-specific) Returns are reference to a collection member by index or id |
Remarks
Examples
VBA
Public Sub ColectionsVBASample()
' Create a new group and play with its buttons collectionDim myGroup As rxGroup
Set myGroup = New rxGroup
' Print number of buttons in the group (prints 0)Debug.Print myGroup.Buttons.Count' Create a new button and give it an idDim myButton As rxButton
Set myButton = New rxButton
myButton.ID = "my_button"' Add the button to the group's buttons collectionmyGroup.Buttons.Add myButton
' Print number of buttons in the group (prints 1)Debug.Print myGroup.Buttons.Count' Access an item by indexDim myButton2 As rxButton
Set myButton2 = myGroup.Buttons.Item(1)' Or alternativelySet myButton2 = myGroup.Buttons(1)' Access an item by idDim myButton3 As rxButton
Set myButton3 = myGroup.Buttons.Item("my_button")
' Or alternativelySet myButton3 = myGroup.Buttons("my_button")
' Remove an item by indexmyGroup.Buttons.Remove 1
' Print number of buttons in the group (prints 0)Debug.Print myGroup.Buttons.Count' Add the item back and remove it by object referencemyGroup.Buttons.Add myButton
' Get another ref to the buttonDim myButton4 As rxButton
Set myButton4 = myGroup.Buttons("my_button")
' RemovemyGroup.Buttons.Remove myButton4
End Sub
