InsertRange Method
- Namespace
TXTextControl.Windows. Forms. Ribbon
- Package
TXTextControl.asTextControl. WinForms. SDK TXTextControl.from the private NuGet feed or Text Control Offline PackagesWindows. Forms. dll
Description
Inserts an array of controls at the specified index. These controls must be objects of type RibbonButton, RibbonComboBox, RibbonLabel, RibbonListView, RibbonTextBox or RibbonSeperator.
Syntax
public void InsertRange(int index, Control[] items, int row);Public Sub InsertRange(index As Integer, items As Control(), row As Integer)Parameters
| Parameter | Description |
|---|---|
| index | The zero-based index at which the controls should be inserted. |
| items | An array of controls to be inserted to this group. |
| row | The row where to insert the controls. Valid values are 0, 1 or 2. |
Examples
The following example uses Insert Range in a focused Horizontal Ribbon Group workflow. The created object is then available to the surrounding document workflow.
horizontalRibbonGroup.InsertRange(1, new System.Windows.Forms.Control[] { new System.Windows.Forms.Control() }, 1);
Console.WriteLine("Horizontal Ribbon Group is ready for use.");horizontalRibbonGroup.InsertRange(1, New System.Windows.Forms.Control() { New System.Windows.Forms.Control() }, 1)
Console.WriteLine("Horizontal Ribbon Group is ready for use.")Limitations
RibbonButtons where the DisplayMode property is set to IconTextRelation.LargeIconLabeled cannot be added to a horizontal ribbon group.