# C1.Win.Ribbon.RibbonColorPickerItem

## Content

<div class="doc-site-dotnet-api-container">



  <h1 id="C1_Win_Ribbon_RibbonColorPickerItem" data-uid="C1.Win.Ribbon.RibbonColorPickerItem" class="text-break">RibbonColorPickerItem Class
</h1>
  <div class="markdown level0 summary"><p>Represents a color palette used to build custom color picker elements.</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"><span class="xref">RibbonColorPickerItem</span></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>
  <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_RibbonColorPickerItem_syntax">Syntax</h5>
  <div class="codewrapper">
    <pre><code class="lang-csharp hljs">public class RibbonColorPickerItem : RibbonItem, IComponent, IDisposable</code></pre>
  </div>
  <div class="codewrapper">
    <pre><code class="lang-vbnet hljs">Public Class RibbonColorPickerItem
    Inherits RibbonItem
    Implements IComponent, IDisposable</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_RibbonColorPickerItem__ctor" data-uid="C1.Win.Ribbon.RibbonColorPickerItem.#ctor">
          <a class="xref" href="C1.Win.Ribbon.RibbonColorPickerItem.-ctor.html#C1_Win_Ribbon_RibbonColorPickerItem__ctor">RibbonColorPickerItem()</a>
        </td>
        <td class="markdown level1 summary"><p>Creates a new instance of <a class="xref" href="C1.Win.Ribbon.RibbonColorPickerItem.html">RibbonColorPickerItem</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_RibbonColorPickerItem_Color" data-uid="C1.Win.Ribbon.RibbonColorPickerItem.Color">
          <a class="xref" href="C1.Win.Ribbon.RibbonColorPickerItem.Color.html#C1_Win_Ribbon_RibbonColorPickerItem_Color">Color</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the currently selected color.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonColorPickerItem_ColorsPerRow" data-uid="C1.Win.Ribbon.RibbonColorPickerItem.ColorsPerRow">
          <a class="xref" href="C1.Win.Ribbon.RibbonColorPickerItem.ColorsPerRow.html#C1_Win_Ribbon_RibbonColorPickerItem_ColorsPerRow">ColorsPerRow</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the number of color elements that should be displayed per row.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonColorPickerItem_ExpandColors" data-uid="C1.Win.Ribbon.RibbonColorPickerItem.ExpandColors">
          <a class="xref" href="C1.Win.Ribbon.RibbonColorPickerItem.ExpandColors.html#C1_Win_Ribbon_RibbonColorPickerItem_ExpandColors">ExpandColors</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets whether the palette should be expanded to include five additional
entries with different brightness for each color in the main palette.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonColorPickerItem_LargeButtons" data-uid="C1.Win.Ribbon.RibbonColorPickerItem.LargeButtons">
          <a class="xref" href="C1.Win.Ribbon.RibbonColorPickerItem.LargeButtons.html#C1_Win_Ribbon_RibbonColorPickerItem_LargeButtons">LargeButtons</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets whether the color picker buttons should be large or small.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonColorPickerItem_OfficeColorPalette" data-uid="C1.Win.Ribbon.RibbonColorPickerItem.OfficeColorPalette">
          <a class="xref" href="C1.Win.Ribbon.RibbonColorPickerItem.OfficeColorPalette.html#C1_Win_Ribbon_RibbonColorPickerItem_OfficeColorPalette">OfficeColorPalette</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the predefined color palette.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonColorPickerItem_Palette" data-uid="C1.Win.Ribbon.RibbonColorPickerItem.Palette">
          <a class="xref" href="C1.Win.Ribbon.RibbonColorPickerItem.Palette.html#C1_Win_Ribbon_RibbonColorPickerItem_Palette">Palette</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the array of colors to choose from.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonColorPickerItem_ToolTipColorNames" data-uid="C1.Win.Ribbon.RibbonColorPickerItem.ToolTipColorNames">
          <a class="xref" href="C1.Win.Ribbon.RibbonColorPickerItem.ToolTipColorNames.html#C1_Win_Ribbon_RibbonColorPickerItem_ToolTipColorNames">ToolTipColorNames</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets whether to show the color names in tooltips.</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_RibbonColorPickerItem_GetColorIndex_System_Drawing_Color_" data-uid="C1.Win.Ribbon.RibbonColorPickerItem.GetColorIndex(System.Drawing.Color)">
          <a class="xref" href="C1.Win.Ribbon.RibbonColorPickerItem.GetColorIndex.html#C1_Win_Ribbon_RibbonColorPickerItem_GetColorIndex_System_Drawing_Color_">GetColorIndex(Color)</a>
        </td>
        <td class="markdown level1 summary"><p>Returns the color index from the palette.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonColorPickerItem_OnClick_System_EventArgs_" data-uid="C1.Win.Ribbon.RibbonColorPickerItem.OnClick(System.EventArgs)">
          <a class="xref" href="C1.Win.Ribbon.RibbonColorPickerItem.OnClick.html#C1_Win_Ribbon_RibbonColorPickerItem_OnClick_System_EventArgs_">OnClick(EventArgs)</a>
        </td>
        <td class="markdown level1 summary"><p>Raises the <a class="xref" href="C1.Win.Ribbon.RibbonColorPickerItem.Click.html">Click</a> event.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonColorPickerItem_OnSelectedColorChanged_System_EventArgs_" data-uid="C1.Win.Ribbon.RibbonColorPickerItem.OnSelectedColorChanged(System.EventArgs)">
          <a class="xref" href="C1.Win.Ribbon.RibbonColorPickerItem.OnSelectedColorChanged.html#C1_Win_Ribbon_RibbonColorPickerItem_OnSelectedColorChanged_System_EventArgs_">OnSelectedColorChanged(EventArgs)</a>
        </td>
        <td class="markdown level1 summary"><p>Raises the <a class="xref" href="C1.Win.Ribbon.RibbonColorPickerItem.SelectedColorChanged.html">SelectedColorChanged</a> event.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonColorPickerItem_ResetColor" data-uid="C1.Win.Ribbon.RibbonColorPickerItem.ResetColor">
          <a class="xref" href="C1.Win.Ribbon.RibbonColorPickerItem.ResetColor.html#C1_Win_Ribbon_RibbonColorPickerItem_ResetColor">ResetColor()</a>
        </td>
        <td class="markdown level1 summary"></td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonColorPickerItem_ShouldSerializeColor" data-uid="C1.Win.Ribbon.RibbonColorPickerItem.ShouldSerializeColor">
          <a class="xref" href="C1.Win.Ribbon.RibbonColorPickerItem.ShouldSerializeColor.html#C1_Win_Ribbon_RibbonColorPickerItem_ShouldSerializeColor">ShouldSerializeColor()</a>
        </td>
        <td class="markdown level1 summary"></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_RibbonColorPickerItem_Click" data-uid="C1.Win.Ribbon.RibbonColorPickerItem.Click">
          <a class="xref" href="C1.Win.Ribbon.RibbonColorPickerItem.Click.html">Click</a>
        </td>
        <td class="markdown level1 summary"><p>Occurs when the item is clicked.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Win_Ribbon_RibbonColorPickerItem_SelectedColorChanged" data-uid="C1.Win.Ribbon.RibbonColorPickerItem.SelectedColorChanged">
          <a class="xref" href="C1.Win.Ribbon.RibbonColorPickerItem.SelectedColorChanged.html">SelectedColorChanged</a>
        </td>
        <td class="markdown level1 summary"><p>Occurs when the <a class="xref" href="C1.Win.Ribbon.RibbonColorPickerItem.Color.html#C1_Win_Ribbon_RibbonColorPickerItem_Color">Color</a> property has changed.</p>
</td>
      </tr>
    </tbody>
  </table>

</div>
