Difference between revisions of "RibbonX Collections"

From Ribbon Commander Documentation
Jump to: navigation, search
(→‎VBA)
(→‎C#)
Line 85: Line 85:
 
=== C# ===
 
=== C# ===
 
<syntaxhighlight lang="csharp" line>
 
<syntaxhighlight lang="csharp" line>
 +
private void CollectionsCSSample()
 +
{
 +
    // Create a new tab and play with its groups collection
 +
    rxTab myTab = new rxTab();
 +
           
 +
    // Print the number of groups in the tab (prints 0)
 +
    System.Diagnostics.Debug.WriteLine(myTab.groups.count);
 +
 +
    // Create a new group and give it an id
 +
    rxGroup myGroup = new rxGroup();
 +
    myGroup.id = "my_group";
 +
 +
    // Add the group to the tab's groups collection
 +
    myTab.groups.add(myGroup);
 +
 +
    // Print the number of groups in the tab (prints 1)
 +
    System.Diagnostics.Debug.WriteLine(myTab.groups.count);
 +
 +
    // Access an item by index
 +
    rxGroup myGroup2 = myTab.groups[1];
 +
 +
    // Access an item by id
 +
    rxGroup myGroup3 = myTab.groups["my_group"];
 +
 +
    // Remove an item by index
 +
    myTab.groups.remove(1);
 +
 +
    // Print the number of groups in the tab (prints 0)
 +
    System.Diagnostics.Debug.WriteLine(myTab.groups.count);
 +
 +
    // Add the item back and remove it by object reference
 +
    myTab.groups.add(myGroup);
 +
    myTab.groups.remove(myTab.groups["my_group"]);
 +
 +
    // Print the number of groups in the tab (prints 0)
 +
    System.Diagnostics.Debug.WriteLine(myTab.groups.count);
 +
}
 
</syntaxhighlight>
 
</syntaxhighlight>
  

Revision as of 16:09, 14 March 2013

This section is under construction. Please do not rely on any information it contains.


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

  1. Public Sub ColectionsVBASample()
  2.  
  3.     ' Create a new group and play with its buttons collection
  4.     Dim myGroup As rxGroup
  5.     Set myGroup = New rxGroup
  6.  
  7.     ' Print number of buttons in the group (prints 0)
  8.     Debug.Print myGroup.Buttons.Count
  9.  
  10.     ' Create a new button and give it an id
  11.     Dim myButton As rxButton
  12.     Set myButton = New rxButton
  13.     myButton.ID = "my_button"
  14.  
  15.     ' Add the button to the group's buttons collection
  16.     myGroup.Buttons.Add myButton
  17.  
  18.     ' Print number of buttons in the group (prints 1)
  19.     Debug.Print myGroup.Buttons.Count
  20.  
  21.     ' Access an item by index
  22.     Dim myButton2 As rxButton
  23.     Set myButton2 = myGroup.Buttons.Item(1)
  24.     ' Or alternatively
  25.     Set myButton2 = myGroup.Buttons(1)
  26.  
  27.     ' Access an item by id
  28.     Dim myButton3 As rxButton
  29.     Set myButton3 = myGroup.Buttons.Item("my_button")
  30.     ' Or alternatively
  31.     Set myButton3 = myGroup.Buttons("my_button")
  32.  
  33.     ' Remove an item by index
  34.     myGroup.Buttons.Remove 1
  35.  
  36.     ' Print number of buttons in the group (prints 0)
  37.     Debug.Print myGroup.Buttons.Count
  38.  
  39.     ' Add the item back and remove it by object reference
  40.     myGroup.Buttons.Add myButton
  41.     ' Get another ref to the button
  42.     Dim myButton4 As rxButton
  43.     Set myButton4 = myGroup.Buttons("my_button")
  44.     ' Remove
  45.     myGroup.Buttons.Remove myButton4
  46.  
  47.     ' Print number of buttons in the group (prints 0)
  48.     Debug.Print myGroup.Buttons.Count
  49.  
  50. End Sub

C#

  1. private void CollectionsCSSample()
  2. {
  3.     // Create a new tab and play with its groups collection
  4.     rxTab myTab = new rxTab();
  5.  
  6.     // Print the number of groups in the tab (prints 0)
  7.     System.Diagnostics.Debug.WriteLine(myTab.groups.count);
  8.  
  9.     // Create a new group and give it an id
  10.     rxGroup myGroup = new rxGroup();
  11.     myGroup.id = "my_group";
  12.  
  13.     // Add the group to the tab's groups collection
  14.     myTab.groups.add(myGroup);
  15.  
  16.     // Print the number of groups in the tab (prints 1)
  17.     System.Diagnostics.Debug.WriteLine(myTab.groups.count);
  18.  
  19.     // Access an item by index
  20.     rxGroup myGroup2 = myTab.groups[1];
  21.  
  22.     // Access an item by id
  23.     rxGroup myGroup3 = myTab.groups["my_group"];
  24.  
  25.     // Remove an item by index
  26.     myTab.groups.remove(1);
  27.  
  28.     // Print the number of groups in the tab (prints 0)
  29.     System.Diagnostics.Debug.WriteLine(myTab.groups.count);
  30.  
  31.     // Add the item back and remove it by object reference
  32.     myTab.groups.add(myGroup);
  33.     myTab.groups.remove(myTab.groups["my_group"]);
  34.  
  35.     // Print the number of groups in the tab (prints 0)
  36.     System.Diagnostics.Debug.WriteLine(myTab.groups.count);
  37. }

VB.NET

  1.  

C++

  1.  
Retrieved from ‘https://documentation.ribboncommander.com/index.php?title=RibbonX_Collections&oldid=1916’