ElementControl Class

Represents a control element.

Inheritance

object

MarshalByRefObject

ElementControl

Implements

Namespace: FarPoint.Win

Assembly: FarPoint.Win.dll

Syntax

public class ElementControl : Control, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable

Public Class ElementControl
    Inherits Control
    Implements IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable

Constructors

Name	Description
ElementControl()	Creates a control element (ElementControl object).
ElementControl(object)	Creates a control element (ElementControl object) based on the specified object.

Fields

Name	Description
BACK_COLOR_DEFAULT	Represents the default color background for the element, namely SystemColors.Control.
FORE_COLOR_DEFAULT	Represents the default text color for the element, namely SystemColors.ControlText.
PICTURE_MARGIN_DEFAULT	Represents the default picture margin for the element, namely 2 pixels.

Properties

Name	Description
About	Displays information about the control.
AlignHorz	Gets or sets the horizontal alignment of the contents of the control.
AlignText	Gets or sets the alignment of the text in the control.
AlignVert	Gets or sets the vertical alignment of the contents of the control.
BackColor	Gets or sets the background color for the control.
BackgroundImage	Gets or sets the background image for the control.
Border	Gets or sets the border for the control.
CanFocus	Gets or sets whether the control can receive focus.
ContainsFocus	Gets whether the element currently has the input focus.
DrawFocusRectangle	Gets or sets the drawing style of the focus rectangle in the control.
Elements	Gets the collection of IElement-derived objects that the current ElementControl contains.
Enabled	Gets or sets whether the control can receive focus and respond to user actions.
Focused	Gets whether the control has focus.
Font	Gets or sets the font for the control.
ForeColor	Gets or sets the text color for the control.
ForegroundImage	Gets or sets the foreground image for the control.
MarginBottom	Gets or sets the margin between the bottom of the control and its contents.
MarginLeft	Gets or sets the margin between the left edge of the control and its contents.
MarginRight	Gets or sets the margin between the right edge of the control and its contents.
MarginTop	Gets or sets the margin between the top of the control and its contents.
Name	Gets or sets the name used in code to identify the control.
Picture	Gets or sets the picture for the control.
PictureMargin	Gets or sets the margin between the text and the picture.
PictureOrientation	Gets or sets the orientation of the picture in the control.
PictureTransparencyColor	Gets or sets the transparency color for the picture in the control.
PictureTransparencyTolerance	Gets or sets the picture transparency tolerance for the element.
Rectangle	Gets or sets the rectangle in the client area of the control.
Redraw	Gets or sets whether the element is allowed to paint.
Selectable	Gets or sets whether the control can receive focus.
State	Gets or sets the element state for the control.
Text	Gets or sets the contents of the control as a string matching exactly what is displayed.
TextOrientation	Gets or sets the orientation of the text in the control.
TextWrap	Gets or sets whether to automatically wrap text without line breaks in the element.
Visible	Gets or sets whether the control is visible.

Methods

Name	Description
Focus(bool)	Moves the focus to the control.
GetControl()	Gets the control.
GetElementStyle()	Gets the style for the element.
GetFont()	Gets the current font or the default font if no font is specified.
OnBackgroundImageChanged(object, EventArgs)	Raises the BackgroundImageChanged event when the background picture has changed.
OnClick(EventArgs)	Raises the Click event when the user clicks with the cursor over the control.
OnDoubleClick(EventArgs)	Raises the DoubleClick event when the user double clicks with the cursor over the control.
OnForegroundImageChanged(object, EventArgs)	Raises the ForegroundImageChanged event when the foreground picture has changed.
OnMouseDown(MouseEventArgs)	Raises the MouseDown event when the pointer button is pressed while the cursor is over the control.
OnMouseMove(MouseEventArgs)	Raises the MouseMove event when the pointer is moved within the control and the cursor is over the control.
OnMouseUp(MouseEventArgs)	Raises the MouseUp event when the pointer button is released while the cursor is over the control.
OnPaint(Graphics, Rectangle)	Paints the control (text and picture).
OnPaint(Graphics, Rectangle, ElementStyle)	Paints the control (both text and picture) with an overriding style.
OnPaint(PaintEventArgs)	Raises the Paint event when the element has been asked to repaint itself.
OnPaintBackground(Graphics, Rectangle)	Paints the background of the element.
OnPaintBackground(Graphics, Rectangle, ElementStyle)	Paints the background of the control with an overriding style.
OnPaintBackground(PaintEventArgs)	Occurs when the background of the control is painted.
OnParentChanged(EventArgs)	Raises the ParentChanged event when the parent control has changed.
OnPictureChanged(object, EventArgs)	Raises the PictureChanged event when the picture has changed.
ResetBackColor()	Resets the background color of the control to its default value.
ResetBorder()	Resets the border of the control to its default settings.
ResetElements()	Resets the elements to their default settings.
ResetFont()	Resets the font of the control to its default value.
ResetForeColor()	Resets the text color of the control to its default value.
ResetPicture()	Resets the picture for the control to its default value.
ResetPictureTransparencyColor()	Resets the picture transparency color to its default color.
ResetPictureTransparencyTolerance()	Resets the transparency tolerance for a picture in the element to its default value.
ResetText()	Resets the contents to the default value.
Select(bool)	Activates the control.
SetBounds(Rectangle)	Sets the bounds of the element to the position and size of the specified bounding rectangle object.
SetBounds(int, int, int, int)	Sets the bounds of the element to the position and size of the bounding rectangle of the specified dimensions.
SetElementStyle(ElementStyle)	Sets the style for the element.
ShouldSerializePictureTransparencyTolerance()	Indicates whether the PictureTransparencyTolerance property should be persisted.
ToggleState()	Toggles the state of the control.
Update()	Causes the control to redraw the invalidated regions within its client area.

Events

Name	Description
ForegroundImageChanged	Occurs when the foreground image in the control has changed.
PictureChanged	Occurs when the picture in the control has changed.