| Name | Description | |
|---|---|---|
 | _bounds | The System.Drawing.Rectangle that defines the position of the Element within its parent. (Inherited from C1.Framework.Element) |
| _flags | An Element.ElementFlags value that defines the behavior of this Element. (Inherited from C1.Framework.Element) |
| _parent | The parent Element. (Inherited from C1.Framework.Element) |
| _style | The Element.Style object that defines the appearance of this Element. (Inherited from C1.Framework.Element) |
| DEFAULT_HEIGHT | The default height of an icon. |
| DEFAULT_WIDTH | The default width of an icon. |
IconElement Class Members
In This Topic
The following tables list the members exposed by IconElement.
Protected Fields
Public Properties
| Name | Description | |
|---|---|---|
 | AutoHeight | Gets or sets the System.Boolean value specifying whether element height is automatically determined by its style and contents. (Inherited from C1.Framework.Element) |
| AutoSize | Gets the System.Boolean value specifying whether element size is automatically determined by its style and contents. (Inherited from C1.Framework.Element) |
| AutoWidth | Gets or sets the System.Boolean value specifying whether element width is automatically determined by its style and contents. (Inherited from C1.Framework.Element) |
| Bounds | Gets or sets the element's bounds (size and location) within its parent element, in pixels. (Inherited from C1.Framework.Element) |
| Children | Gets a list of child elements. (Inherited from C1.Framework.Element) |
| Color | Gets or sets the color used to paint the icon. |
| ContainsFocus | Gets a value that indicates whether this Element or one of its children has the focus. (Inherited from C1.Framework.Element) |
| ContentBounds | Client rectangle, in pixels. This discounts margins, borders, and padding. (Inherited from C1.Framework.Element) |
| Enabled | Gets or sets whether the element is enabled (can receive mouse and keyboard messages). (Inherited from C1.Framework.Element) |
| Focusable | Gets or sets whether the element is focusable (receives keyboard messages). (Inherited from C1.Framework.Element) |
| Focused | Gets a value that indicates whether this Element has the focus. (Inherited from C1.Framework.Element) |
| ForceLineBreak | Gets a Element.LineBreak value that determines whether there should be line breaks before and/or after this Element when it occurs in a paragraph. (Inherited from C1.Framework.Element) |
| HasChildren | Gets a value that indicates the element has a non-empty Element.Children collection. (Inherited from C1.Framework.Element) |
| Height | Element height. Set to -1 to let the element calculate it automatically. (Inherited from C1.Framework.Element) |
| HitTestable | Gets or sets whether the element is hit-testable (receives mouse messages). (Inherited from C1.Framework.Element) |
| HostControl | Gets the System.Windows.Forms.Control that is hosting this Element. (Inherited from C1.Framework.Element) |
| InheritedRtl | Gets or sets whether the value of RightToLeft property is inherited from the parent element. (Inherited from C1.Framework.Element) |
| IsDirty | Gets a value that indicates this element needs to be laid out. (Inherited from C1.Framework.Element) |
| IsEnabled | Gets whether this element and all its ancestors are enabled. (Inherited from C1.Framework.Element) |
| IsFocusable | Gets whether this element can currently receive the focus. (Inherited from C1.Framework.Element) |
| IsHot | Gets or sets whether the element should be displayed using the Style.Hot style. (Inherited from C1.Framework.Element) |
| IsPressed | Gets or sets whether the element should be displayed using the Style.Pressed style. (Inherited from C1.Framework.Element) |
| IsVisible | Gets whether this element and all its ancestors are visible. (Inherited from C1.Framework.Element) |
| Key | Gets or sets the key used to retrieve the image. |
| Left | Gets or sets the horizontal position of the element within its parent. (Inherited from C1.Framework.Element) |
| LineDescent | Gets the portion of the element that renders below the baseline. Usually non-zero only for text elements, depends on font. (Inherited from C1.Framework.Element) |
| Location | Gets or sets the location of the element within its parent. (Inherited from C1.Framework.Element) |
| Padding | Gets or sets the padding of the icon. |
| Parent | Gets the element's parent, or null if this is the root element. (Inherited from C1.Framework.Element) |
| RenderStyle | Gets the element's style, or a default style if the element doesn't have one. This never returns null. (Inherited from C1.Framework.Element) |
| RightToLeft | Gets or sets whether the element should be drawn using right-to-left layout. (Inherited from C1.Framework.Element) |
| Root | Gets the element's top-level parent. (Inherited from C1.Framework.Element) |
| ShowFocusRectangle | Gets or sets whether the element should display a focus rectangle when it has focus. (Inherited from C1.Framework.Element) |
| Size | Gets or sets the size of the element. (Inherited from C1.Framework.Element) |
| Style | Gets or sets the Style object used to render this Element. (Inherited from C1.Framework.Element) |
| Top | Gets or sets the vertical position of the element within its parent. (Inherited from C1.Framework.Element) |
| Validated | Gets or sets a value indicating if the contents was successfully validated. (Inherited from C1.Framework.Element) |
| Visible | Gets or sets whether the element is visible. (Inherited from C1.Framework.Element) |
| Width | Element width. Set to -1 to let the element calculate it automatically. (Inherited from C1.Framework.Element) |
Protected Properties
| Name | Description | |
|---|---|---|
 | IsIconDirty | |
| RenderBox | Returns rectangle (in the icon coordinates) to render icon. |
| ShouldDispose | |
| ShouldRasterize | Determines whether icon needs bitmap cache for drawing. |
| ShouldResize | Determines whether icon image should be resized according to the C1Icon element size. |
Public Methods
| Name | Description | |
|---|---|---|
 | Clone | Returns a clone of this element. (Inherited from C1.Framework.Element) |
 | CreateElement | Overloaded. Creates the IconElement to show the C1Icon. |
| Focus | Sets the focus to the host control and to this Element within the host control. (Inherited from C1.Framework.Element) |
| GetBounds | Overloaded. Gets the element's bounds (size and location) within an arbitrary ancestor, in pixels. Ancestor element (parent, grand-parent, etc). A System.Drawing.Rectangle that corresponds to the element's position within the given ancestor. (Inherited from C1.Framework.Element) |
| GetFlags | (Inherited from C1.Framework.Element) |
| GetParentOfType | Navigates up the tree to find an ancestor of a given type. (Inherited from C1.Framework.Element) |
| GetScrollOrigin | Returns the scroll origin (override to implement non-scrolling areas). (Inherited from C1.Framework.Element) |
| HitTest | Returns the element at a given point. (Inherited from C1.Framework.Element) |
| Invalidate | Overloaded. Invalidates this Element within the host control. (Inherited from C1.Framework.Element) |
| IsChildOf | Determines whether this element is a child of another element. (Inherited from C1.Framework.Element) |
| IsInputKey | Determines whether the specified key is a regular input key or a special key that requires preprocessing. (Inherited from C1.Framework.Element) |
| Layout | Overloaded. Overridden. Lays out this element based on its style and contents. |
| Measure | Overloaded. Provides the size, in pixels, of the specified content drawn on the specified System.Drawing.Graphics surface. (Inherited from C1.Framework.Element) |
| Offset | Adjusts the location of this element by the specified amount. (Inherited from C1.Framework.Element) |
| OnClick | Called by the host control when the user clicks this Element. (Inherited from C1.Framework.Element) |
| OnDoubleClick | Called by the host control when the user double-clicks this Element. (Inherited from C1.Framework.Element) |
| OnGotFocus | Called by the host control when this Element receives the focus. (Inherited from C1.Framework.Element) |
| OnKeyDown | Called by the host control when the user presses a key and this Element has the focus. (Inherited from C1.Framework.Element) |
| OnKeyPress | Called by the host control when the user presses a character key and this Element has the focus. (Inherited from C1.Framework.Element) |
| OnKeyUp | Called by the host control when the user releases a key and this Element has the focus. (Inherited from C1.Framework.Element) |
| OnLostFocus | Called by the host control when this Element loses the focus. (Inherited from C1.Framework.Element) |
| OnMouseDown | Called by the host control when the user presses a mouse button over this Element. (Inherited from C1.Framework.Element) |
| OnMouseEnter | Called by the host control when the mouse enters this Element. (Inherited from C1.Framework.Element) |
| OnMouseEnterHover | Called by the host control when the mouse enters this Element, even if another element has captured the mouse. (Inherited from C1.Framework.Element) |
| OnMouseLeave | Called by the host control when the mouse leaves this Element. (Inherited from C1.Framework.Element) |
| OnMouseLeaveHover | Called by the host control when the mouse leaves this Element, even if another element has captured the mouse. (Inherited from C1.Framework.Element) |
| OnMouseLostCapture | Called by the host control when the user releases the left mouse button over a disabled Element. (Inherited from C1.Framework.Element) |
| OnMouseMove | Called by the host control when the mouse moves over this Element. (Inherited from C1.Framework.Element) |
| OnMouseUp | Called by the host control when the user releases a mouse button over this Element. (Inherited from C1.Framework.Element) |
| OnMouseWheel | Handles MouseWheel events. (Inherited from C1.Framework.Element) |
| OnValidated | Called by the host control after the element has been validated. (Inherited from C1.Framework.Element) |
| OnValidating | Called by the host control when the element is about to lose focus. (Inherited from C1.Framework.Element) |
| PointToClient | Computes the location of the specified screen point into client coordinates. (Inherited from C1.Framework.Element) |
| PointToScreen | Computes the location of the specified client point into screen coordinates. (Inherited from C1.Framework.Element) |
| Render | Renders the element into a given rectangle. (Inherited from C1.Framework.Element) |
| RenderChildren | Renders the child elements into a given rectangle. (Inherited from C1.Framework.Element) |
| RenderContent | Overridden. Renders the element contents into the specified System.Drawing.Graphics object at the specified location. |
| RescaleConstantsForDpi | Overloaded. Overridden. Provides constants for rescaling the control when a DPI change occurs. |
| SetDirty | Overloaded. Marks this element as dirty, forcing all parent and child elements to be laid out. (Inherited from C1.Framework.Element) |
| SetFlags | Overloaded. (Inherited from C1.Framework.Element) |
| ToString | Gets a string representation of this C1BitmapIcon. |
Protected Methods
| Name | Description | |
|---|---|---|
 | FinalizeUI | Overridden. Finalizes the user interface. This method is called when element is removed from UI. |
| GetDeviceDPI | Gets the DPI value for the display device where the Element.HostControl is currently being displayed. (Inherited from C1.Framework.Element) |
| GetImage | Gets the image represented by this C1Icon. |
| InitializeUI | Initializes the UI. |
| OnIconChanged | Updates element properties on icon property changes. |
| OnRightToLeftChanged | (Inherited from C1.Framework.Element) |
| OnStateChanged | Called by the host control when the state of this Element changes. (Inherited from C1.Framework.Element) |
| RenderIcon | |
| ScaleToDeviceDPI | Overloaded. Scales the Style instance uses the DeviceDpi value if this element has a Element.HostControl. (Inherited from C1.Framework.Element) |
| ScaleToDPI | Overloaded. Scales the Style instance to custom display device dpi. (Inherited from C1.Framework.Element) |
| SetIconDirty | Notifies C1Icon element that UI should be re-initialized for the next drawing operation. |
| UpdateStyle | (Inherited from C1.Framework.Element) |
See Also