# C1.Win.Ribbon.RibbonSplitButton

## Content

<div class="doc-site-dotnet-api-container">



  <h1 id="C1_Win_Ribbon_RibbonSplitButton" data-uid="C1.Win.Ribbon.RibbonSplitButton" class="text-break">RibbonSplitButton Class
</h1>
  <div class="markdown level0 summary"><p>Element that combines a regular button and a drop-down.</p>
</div>
  <div class="markdown level0 conceptual"></div>
  <div class="inheritance">
    <h5>Inheritance</h5>
    <div class="level0"><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.object">object</a></div>
    <div class="level1"><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.marshalbyrefobject">MarshalByRefObject</a></div>
    <div class="level2"><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.componentmodel.component">Component</a></div>
    <div class="level3"><a class="xref" href="C1.Win.Ribbon.RibbonItem.html">RibbonItem</a></div>
    <div class="level4"><a class="xref" href="C1.Win.Ribbon.RibbonIconItem.html">RibbonIconItem</a></div>
    <div class="level5"><a class="xref" href="C1.Win.Ribbon.RibbonDropDownBase.html">RibbonDropDownBase</a></div>
    <div class="level6"><span class="xref">RibbonSplitButton</span></div>
      <div class="level7"><a class="xref" href="C1.Win.Ribbon.RibbonColorPicker.html">RibbonColorPicker</a></div>
  </div>
  <div class="implements">
    <h5>Implements</h5>
    <div><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.componentmodel.icomponent">IComponent</a></div>
    <div><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.idisposable">IDisposable</a></div>
    <div><span class="xref">ISupportUiaContainer</span></div>
    <div><span class="xref">IUiaSplitButton</span></div>
    <div><span class="xref">IUiaInvokeProvider</span></div>
    <div><span class="xref">IUiaExpandCollapseProvider</span></div>
    <div><span class="xref">IUiaScrollItemProvider</span></div>
  </div>
  <h6><strong>Namespace</strong>: <a class="xref" href="C1.Win.Ribbon.html">C1.Win.Ribbon</a></h6>
  <h6><strong>Assembly</strong>: C1.Win.Ribbon.10.dll</h6>
  <h5 id="C1_Win_Ribbon_RibbonSplitButton_syntax">Syntax</h5>
  <div class="codewrapper">
    <pre><code class="lang-csharp hljs">public class RibbonSplitButton : RibbonDropDownBase, IComponent, IDisposable, ISupportUiaContainer, IUiaSplitButton, IUiaInvokeProvider, IUiaExpandCollapseProvider, IUiaScrollItemProvider</code></pre>
  </div>
  <div class="codewrapper">
    <pre><code class="lang-vbnet hljs">Public Class RibbonSplitButton
    Inherits RibbonDropDownBase
    Implements IComponent, IDisposable, ISupportUiaContainer, IUiaSplitButton, IUiaInvokeProvider, IUiaExpandCollapseProvider, IUiaScrollItemProvider</code></pre>
  </div>
  <h3 id="constructors">Constructors
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton__ctor" data-uid="C1.Win.Ribbon.RibbonSplitButton.#ctor">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.-ctor.html#C1_Win_Ribbon_RibbonSplitButton__ctor">RibbonSplitButton()</a>
        </td>
        <td class="markdown level1 summary"><p>Creates a new instance of <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.html">RibbonSplitButton</a>.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton__ctor_System_String_" data-uid="C1.Win.Ribbon.RibbonSplitButton.#ctor(System.String)">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.-ctor.html#C1_Win_Ribbon_RibbonSplitButton__ctor_System_String_">RibbonSplitButton(string)</a>
        </td>
        <td class="markdown level1 summary"><p>Creates a new instance of <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.html">RibbonSplitButton</a>.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton__ctor_System_String_System_Drawing_Image_" data-uid="C1.Win.Ribbon.RibbonSplitButton.#ctor(System.String,System.Drawing.Image)">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.-ctor.html#C1_Win_Ribbon_RibbonSplitButton__ctor_System_String_System_Drawing_Image_">RibbonSplitButton(string, Image)</a>
        </td>
        <td class="markdown level1 summary"><p>Creates a new instance of <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.html">RibbonSplitButton</a>.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton__ctor_System_String_System_Drawing_Image_System_Drawing_Image_" data-uid="C1.Win.Ribbon.RibbonSplitButton.#ctor(System.String,System.Drawing.Image,System.Drawing.Image)">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.-ctor.html#C1_Win_Ribbon_RibbonSplitButton__ctor_System_String_System_Drawing_Image_System_Drawing_Image_">RibbonSplitButton(string, Image, Image)</a>
        </td>
        <td class="markdown level1 summary"><p>Creates a new instance of <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.html">RibbonSplitButton</a>.</p>
</td>
      </tr>
    </tbody>
  </table>
  <h3 id="properties">Properties
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton_ButtonEnabled" data-uid="C1.Win.Ribbon.RibbonSplitButton.ButtonEnabled">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.ButtonEnabled.html#C1_Win_Ribbon_RibbonSplitButton_ButtonEnabled">ButtonEnabled</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a value indicating whether the button portion of the split button is enabled or disabled. It doesn't affect the state of the drop-down.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton_CanBeAddedToQat" data-uid="C1.Win.Ribbon.RibbonSplitButton.CanBeAddedToQat">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.CanBeAddedToQat.html#C1_Win_Ribbon_RibbonSplitButton_CanBeAddedToQat">CanBeAddedToQat</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets whether the user can add this <a class="xref" href="C1.Win.Ribbon.RibbonItem.html">RibbonItem</a> to the Quick Access Toolbar at runtime.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton_DropDownAlign" data-uid="C1.Win.Ribbon.RibbonSplitButton.DropDownAlign">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.DropDownAlign.html#C1_Win_Ribbon_RibbonSplitButton_DropDownAlign">DropDownAlign</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the alignment of the drop-down portion relative to this component.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton_GripHandleVisible" data-uid="C1.Win.Ribbon.RibbonSplitButton.GripHandleVisible">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.GripHandleVisible.html#C1_Win_Ribbon_RibbonSplitButton_GripHandleVisible">GripHandleVisible</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a value indicating whether the drop-down can be resized.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton_KeyTip" data-uid="C1.Win.Ribbon.RibbonSplitButton.KeyTip">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.KeyTip.html#C1_Win_Ribbon_RibbonSplitButton_KeyTip">KeyTip</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the KeyTip providing keyboard access to a RibbonSplitButton.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton_LargeItemDropDownWidth" data-uid="C1.Win.Ribbon.RibbonSplitButton.LargeItemDropDownWidth">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.LargeItemDropDownWidth.html#C1_Win_Ribbon_RibbonSplitButton_LargeItemDropDownWidth">LargeItemDropDownWidth</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the width of a drop-down menu with large items if the value is greater than 100.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton_MaxDropDownItems" data-uid="C1.Win.Ribbon.RibbonSplitButton.MaxDropDownItems">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.MaxDropDownItems.html#C1_Win_Ribbon_RibbonSplitButton_MaxDropDownItems">MaxDropDownItems</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the maximum number of items to display in the drop-down list.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton_PreferredItemSize" data-uid="C1.Win.Ribbon.RibbonSplitButton.PreferredItemSize">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.PreferredItemSize.html#C1_Win_Ribbon_RibbonSplitButton_PreferredItemSize">PreferredItemSize</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a value specifies the size of the drop down items.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton_Pressed" data-uid="C1.Win.Ribbon.RibbonSplitButton.Pressed">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.Pressed.html#C1_Win_Ribbon_RibbonSplitButton_Pressed">Pressed</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a value that indicates whether the split button is pressed (toggled).</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton_PressedIconSet" data-uid="C1.Win.Ribbon.RibbonSplitButton.PressedIconSet">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.PressedIconSet.html#C1_Win_Ribbon_RibbonSplitButton_PressedIconSet">PressedIconSet</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the icon set for the Pressed state.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton_ShortcutKeys" data-uid="C1.Win.Ribbon.RibbonSplitButton.ShortcutKeys">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.ShortcutKeys.html#C1_Win_Ribbon_RibbonSplitButton_ShortcutKeys">ShortcutKeys</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the shortcut keys associated with the split button.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton_ShowInMore" data-uid="C1.Win.Ribbon.RibbonSplitButton.ShowInMore">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.ShowInMore.html#C1_Win_Ribbon_RibbonSplitButton_ShowInMore">ShowInMore</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a value indicating if this <a class="xref" href="C1.Win.Ribbon.RibbonItem.html">RibbonItem</a> can be shown in drop down part of the More button when ribbon is simplified.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton_Text" data-uid="C1.Win.Ribbon.RibbonSplitButton.Text">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.Text.html#C1_Win_Ribbon_RibbonSplitButton_Text">Text</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the label used to identify this <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.html">RibbonSplitButton</a>.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton_ToggleOnClick" data-uid="C1.Win.Ribbon.RibbonSplitButton.ToggleOnClick">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.ToggleOnClick.html#C1_Win_Ribbon_RibbonSplitButton_ToggleOnClick">ToggleOnClick</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a value indicating whether the split button should remain in pressed state after clicking on it.</p>
</td>
      </tr>
    </tbody>
  </table>
  <h3 id="methods">Methods
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton_Dispose_System_Boolean_" data-uid="C1.Win.Ribbon.RibbonSplitButton.Dispose(System.Boolean)">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.Dispose.html#C1_Win_Ribbon_RibbonSplitButton_Dispose_System_Boolean_">Dispose(bool)</a>
        </td>
        <td class="markdown level1 summary"><p>Clean up any resources being used.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton_OnClick_System_EventArgs_" data-uid="C1.Win.Ribbon.RibbonSplitButton.OnClick(System.EventArgs)">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.OnClick.html#C1_Win_Ribbon_RibbonSplitButton_OnClick_System_EventArgs_">OnClick(EventArgs)</a>
        </td>
        <td class="markdown level1 summary"><p>Raises the <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.Click.html">Click</a> event.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton_OnPressedChanged_System_EventArgs_" data-uid="C1.Win.Ribbon.RibbonSplitButton.OnPressedChanged(System.EventArgs)">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.OnPressedChanged.html#C1_Win_Ribbon_RibbonSplitButton_OnPressedChanged_System_EventArgs_">OnPressedChanged(EventArgs)</a>
        </td>
        <td class="markdown level1 summary"><p>Raises the <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.PressedChanged.html">PressedChanged</a> event.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton_ResetText" data-uid="C1.Win.Ribbon.RibbonSplitButton.ResetText">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.ResetText.html#C1_Win_Ribbon_RibbonSplitButton_ResetText">ResetText()</a>
        </td>
        <td class="markdown level1 summary"><p>Restores the default value of the <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.Text.html#C1_Win_Ribbon_RibbonSplitButton_Text">Text</a> property.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton_ShouldSerializeText" data-uid="C1.Win.Ribbon.RibbonSplitButton.ShouldSerializeText">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.ShouldSerializeText.html#C1_Win_Ribbon_RibbonSplitButton_ShouldSerializeText">ShouldSerializeText()</a>
        </td>
        <td class="markdown level1 summary"><p>Specifies whether to save the value of the <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.Text.html#C1_Win_Ribbon_RibbonSplitButton_Text">Text</a> property.</p>
</td>
      </tr>
    </tbody>
  </table>
  <h3 id="events">Events
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton_Click" data-uid="C1.Win.Ribbon.RibbonSplitButton.Click">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.Click.html">Click</a>
        </td>
        <td class="markdown level1 summary"><p>Occurs when the button is clicked.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonSplitButton_PressedChanged" data-uid="C1.Win.Ribbon.RibbonSplitButton.PressedChanged">
          <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.PressedChanged.html">PressedChanged</a>
        </td>
        <td class="markdown level1 summary"><p>Occurs whenever the <a class="xref" href="C1.Win.Ribbon.RibbonSplitButton.Pressed.html#C1_Win_Ribbon_RibbonSplitButton_Pressed">Pressed</a> property is changed.</p>
</td>
      </tr>
    </tbody>
  </table>

</div>
