RibbonDropDownColorPicker - harborsiem/WinForms-Ribbon GitHub Wiki
RibbonDropDownColorPicker
In the markup file this control is called DropDownColorPicker
Public constructors, methods, properties and events:
Constructors:
| Name | Description |
|---|---|
| RibbonDropDownColorPicker(RibbonStrip, uint) | Initializes a new instance of the RibbonDropDownColorPicker class. |
Methods:
Properties:
| Name | Description |
|---|---|
| CommandId | Get the Id; set by constructor. |
| CommandType | Get the CommandType. Before this control is in view by the UI, the CommandType is Unknown. After this control is first time in UI view the CommandType is ColorAnchor. |
| Enabled | Get, Set the enabled state. |
| Name | Get, Set an optional Name. |
| Ribbon | Get the RibbonStrip (set by constructor). |
| ResourceIds | Get class MarkupResIds. This class delivers all markup resource ids for a Command. Only available if RibbonStrip.Markupheader is set. |
| Keytip | Get, Set a Keytip string. See Note below. |
| Label | Get, Set a Label (LabelTitle) string. See Note below. |
| TooltipTitle | Get, Set a TooltipTitle string. See Note below. |
| TooltipDescription | Get, Set a TooltipDescription string. See Note below. |
| LargeImage | Get, Set UIImage. See Note below. |
| SmallImage | Get, Set UIImage. See Note below. |
| LargeHighContrastImage | Get, Set UIImage. See Note below. |
| SmallHighContrastImage | Get, Set UIImage. See Note below. |
| Tag | Get, Set an optional Tag. |
| AutomaticColorLabel | Get, Set Defines the label for the “Automatic” color button. |
| Color | Get, Set The selected color. |
| ColorType | Get, Set The type of selected color. Can be: NoColor, Automatic or RGB (meaning specific color). |
| MoreColorsLabel | Get, Set Defines the label for the “More colors…” button. |
| NoColorLabel | Get, Set Defines the label for the “No color” button. |
| RecentColorsCategoryLabel | Get, Set Defines the label for the “Recent colors” category. |
| StandardColors | Get, Set Standard Colors. |
| StandardColorsCategoryLabel | Get, Set Defines the label for the “Standard colors” category. |
| StandardColorsTooltips | Get, Set Tooltips for “Standard colors” category. |
| ThemeColors | Get, Set an optional Tag. |
| ThemeColorsCategoryLabel | Get, Set Defines the label for the “Theme colors” category. |
| ThemeColorsTooltips | Get, Set Tooltips for “Theme colors” category. |
Events:
| Name | Description |
|---|---|
| ColorChanged | User can handle changed color. EventArgs are ColorPickerEventArgs. |
| Preview | User can handle changed selected item. EventArgs are ColorPickerEventArgs. |
| CancelPreview | User can handle changed selected item. EventArgs are ColorPickerEventArgs. |
| CreateUICommand | Control is created by the Ribbon Framework |
| DestroyUICommand | Control is destroyed by the Ribbon Framework |
!Note:
For properties Keytip, LableTitle, LabelDescription, TooltipTitle and TooltipDescription: If listed property value is only set by Markup resource you get a value of null (nothing). But if you set RibbonStrip property MarkupHeader to the 'Embedded Resource' RibbonMarkup.h file, you will get the correct string.
!Note:
For properties SmallImage, LargeImage, SmallHighContrastImage and LargeHighContrastImage: If listed property value is only set by Markup resource you get a value of null (nothing).