[]
        
(Showing Draft Content)

C1.Win.C1Tile.C1TileControl

C1TileControl Class

Represents a scrollable surface with tiles.

Inheritance
C1TileControl
Namespace: C1.Win.C1Tile
Assembly: C1.Win.C1TileControl.4.8.dll
Syntax
[ToolboxBitmap(typeof(C1TileControl), "C1TileControl.png")]
[ClassInterface(ClassInterfaceType.AutoDispatch)]
[ComVisible(true)]
public class C1TileControl : Control, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable

Constructors

Name Description
C1TileControl()

Initializes a new instance of a C1TileControl.

Properties

Name Description
AllowChecking

Gets or sets whether the user can check/uncheck tiles using a swipe gesture or mouse right-click.

AllowPanningFeedback

Gets or sets whether the owner form has to display a visual cue when a user reaches the end of a pannable area.

AllowRearranging

Gets or sets whether the user can move tiles with the mouse or touch device.

AutomaticLayout

Gets or sets whether the tiles should be arranged automatically or manually. The LeftCell and TopCell properties are ignored in automatic mode.

BackImageLayout

Gets or sets the background image layout.

CellHeight

Gets or sets the height of a single tile cell.

CellSpacing

Gets or sets the gap between tile cells in a group.

CellWidth

Gets or sets the width of a single tile cell.

CheckBackColor

Gets or sets the color that replaces BackColor when a tile is checked.

CheckBorderColor

Gets or sets the color of tile border when the tile is checked.

CheckForeColor

Gets or sets the color that replaces ForeColor when a tile is checked and CheckBackColor is set.

CheckMarkColor

Gets or sets the color of the check mark for checked tiles.

CheckMarkImage

Gets or sets the check mark image for checked tiles.

CheckWaitingColor

Gets or sets the color of the supposed check mark.

CheckedTiles

Gets an array of all visible checked tiles.

CommonImage1

Gets the first common image.

CommonImage2

Gets the second common image.

CommonImage3

Gets the third common image.

Cursor

Gets or sets the cursor that is displayed when the mouse pointer is over the control.

DataMember

Gets or sets the specific list in a DataSource that is bound to the tile control.

DataSource

Gets or sets the data source object for the tile control.

DefaultSize

Gets the default size of the C1TileControl.

DefaultTemplate

Gets the default template for tiles.

FocusedBorderColor

Gets or sets the color of tile border when the tile is selected with keyboard.

FocusedTile

Gets or sets the tile that has the keyboard focus.

GroupFont

Gets or sets the font for group captions.

GroupForeColor

Gets or sets the foreground color of a group caption.

GroupPadding

Gets or sets the interior spacing of a tile group.

GroupSpacing

Gets or sets the gap between groups on the scrollable surface.

GroupTextBold

Gets or sets a value that indicates whether the group caption font is bold.

GroupTextSize

Gets or sets the font size for group captions.

GroupTextX

Gets or sets the horizontal offset of a group caption.

GroupTextY

Gets or sets the vertical offset of a group caption.

Groups

Gets the collection of tile groups.

HotBackColor

Gets or sets the color that replaces BackColor when a tile is hovered with the mouse.

HotBorderColor

Gets or sets the color of tile border when the tile is hovered with the mouse.

HotCheckBackColor

Gets or sets the color that replaces BackColor when a checked tile is hovered with the mouse.

HotCheckForeColor

Gets or sets the color that replaces ForeColor when a checked tile is hovered with the mouse.

HotForeColor

Gets or sets the color that replaces ForeColor when a tile is hovered with the mouse and HotBackColor is set.

ImageList

Gets or sets the ImageList that contains the images to display on the tiles.

ImeMode

This property is not relevant to this class.

MaximumRowsOrColumns

Gets or sets the maximum number of cell rows (for horizontal orientation) or cell columns (for vertical orientation) in automatic layout mode.

MovingBackground

Gets or sets whether the background image should be scrolled with the tiles.

MovingTileOpacity

Gets or sets the opacity level of a tile being moved by the user.

OffsetLimit

Gets the minimal negative offset of the scrolling area.

Orientation

Gets or sets whether the groups are arranged horizontally or vertically.

Padding

Gets or sets the interior spacing of the C1TileControl.

PassthroughNavigation

Gets or sets whether the keyboard should navigate to the next row/column after focusing the last tile in the current row/column (for vertical/horizontal layout).

PropertyMappings

Gets the collection of tile property mappings.

SBThumbBorderColor

Gets or sets the color of the scroll bar thumb border.

SBThumbInnerColor

Gets or sets the color of the scroll bar thumb interior.

ScrollBarStyle

Gets or sets whether the default or system scroll bar should appear.

ScrollOffset

Gets or sets the negative or zero offset of the scrollable area.

ShowToolTips

Gets or sets whether the tooltips should appear for tiles and partially visible group captions.

SurfaceContentAlignment

Gets or sets the alignment of groups on the scrollable surface.

SurfacePadding

Gets or sets the interior spacing of the scrollable surface.

SwipeDistance

Gets or sets the distance for a swipe gesture to select a tile.

SwipeRearrangeDistance

Gets or sets the distance for a swipe gesture to start rearranging tiles.

Templates

Gets the collection of custom tile templates.

Text

Gets or sets the main caption text.

TextBold

Gets or sets a value that indicates whether the caption text font is bold.

TextSize

Gets or sets the font size for the caption text.

TextX

Gets or sets the x-coordinate of the text caption.

TextY

Gets or sets the y-coordinate of the text caption.

TileBackColor

Gets or sets the default background color of tiles.

TileBorderColor

Gets or sets the color of a thin border that is drawn around tiles.

TileForeColor

Gets or sets the default foreground color of tiles.

TileRoundedCorners

Gets or sets a value indicating whether tiles are displayed with rounded corners.

ToolTipInitialDelay

Gets or sets the time that passes before the tooltips appear, in milliseconds.

UncheckTilesOnClick

Gets or sets a value indicating whether all tiles are unchecked after clicking a tile.

Methods

Name Description
BeginUpdate()

Maintains drawing performance while applying massive changes to C1TileControl.

ClearCache()

Releases memory occupied by internal cached images. It doesn't force garbage collection though.

CreateAccessibilityInstance()

Returns the custom AccessibleObject for the C1TileControl.

Dispose(bool)

Clean up any resources being used.

EndUpdate()

Resumes processing after it has been suspended by a call to BeginUpdate().

GetTileAt(Point)

Gets a Tile at the point specified in C1TileControl's client coordinates.

IsInputKey(Keys)

Determines whether the specified key is regular input key or a special key that requires preprocessing.

LoadXml(Stream)

Loads the layout of C1TileControl from a Stream.

LoadXml(string)

Loads the layout of C1TileControl from an XML file.

LoadXml(XmlDocument)

Loads the layout of C1TileControl from an XmlDocument.

OnBackColorChanged(EventArgs)

Raises the BackColorChanged event.

OnBackgroundImageChanged(EventArgs)

Raises the BackgroundImageChanged event.

OnBindingContextChanged(EventArgs)

Raises the BindingContextChanged event.

OnChangeUICues(UICuesEventArgs)

Raises the ChangeUICues event.

OnClick(EventArgs)

Raises the Click event.

OnCompareGroups(CompareGroupsEventArgs)

Raises the CompareGroups event.

OnCompareTiles(CompareTilesEventArgs)

Raises the CompareTiles event.

OnFilterItem(FilterItemEventArgs)

Raises the FilterItem event.

OnFontChanged(EventArgs)

Raises the FontChanged event.

OnFormatValue(FormatValueEventArgs)

Raises the FormatValue event.

OnGotFocus(EventArgs)

Raises the GotFocus event.

OnKeyDown(KeyEventArgs)

Raises the KeyDown event.

OnKeyPress(KeyPressEventArgs)

Raises the KeyPress event.

OnLostFocus(EventArgs)

Raises the LostFocus event.

OnMouseClick(MouseEventArgs)

Raises the MouseClick event.

OnMouseDoubleClick(MouseEventArgs)

Raises the MouseDoubleClick event.

OnMouseDown(MouseEventArgs)

Raises the MouseDown event.

OnMouseEnter(EventArgs)

Raises the MouseEnter event.

OnMouseLeave(EventArgs)

Raises the MouseLeave event.

OnMouseMove(MouseEventArgs)

Raises the MouseMove event.

OnMouseUp(MouseEventArgs)

Raises the MouseUp event.

OnPaint(PaintEventArgs)

Raises the Paint event.

OnResize(EventArgs)

Raises the Resize event.

OnRightToLeftChanged(EventArgs)

Raises the RightToLeftChanged event.

OnTileChecked(TileEventArgs)

Raises the TileChecked event.

OnTileClicked(TileEventArgs)

Raises the TileClicked event.

OnTileMoved(TileEventArgs)

Raises the TileMoved event.

OnTileUnchecked(TileEventArgs)

Raises the TileUnchecked event.

ResetCheckBackColor()

Resets the value of the CheckBackColor property.

ResetCheckBorderColor()

Resets the value of the CheckBorderColor property.

ResetCheckForeColor()

Resets the value of the CheckForeColor property.

ResetCheckMarkColor()

Resets the value of the CheckMarkColor property.

ResetCheckWaitingColor()

Resets the value of the CheckWaitingColor property.

ResetFocusedBorderColor()

Resets the value of the FocusedBorderColor property.

ResetGroupForeColor()

Resets the value of the GroupForeColor property.

ResetGroupPadding()

Resets the value of the GroupPadding property.

ResetHotBackColor()

Resets the value of the HotBackColor property.

ResetHotBorderColor()

Resets the value of the HotBorderColor property.

ResetHotCheckBackColor()

Resets the value of the HotCheckBackColor property.

ResetHotCheckForeColor()

Resets the value of the HotCheckForeColor property.

ResetHotForeColor()

Resets the value of the HotForeColor property.

ResetPadding()

Resets the value of the Padding property.

ResetSBThumbBorderColor()

Resets the value of the SBThumbBorderColor property.

ResetSBThumbInnerColor()

Resets the value of the SBThumbInnerColor property.

ResetSurfacePadding()

Resets the value of the SurfacePadding property.

ResetTileBackColor()

Resets the value of the TileBackColor property.

ResetTileBorderColor()

Resets the value of the TileBorderColor property.

ResetTileForeColor()

Resets the value of the TileForeColor property.

SaveXml(Stream)

Saves the layout of C1TileControl into a Stream.

SaveXml(Stream, Encoding)

Saves the layout of C1TileControl into a Stream.

SaveXml(string)

Saves the layout of C1TileControl into an XML file.

SaveXml(string, Encoding)

Saves the layout of C1TileControl into an XML file.

SaveXml(XmlWriter)

Saves the layout of C1TileControl into an XmlWriter.

ScaleControl(SizeF, BoundsSpecified)

Scales a control's location, size, padding and margin.

ScrollToGroup(Group, bool)

Scrolls the surface and make the specified Group visible.

ScrollToTile(Tile, bool)

Scrolls the surface and make the specified Tile visible.

SetDataBinding(object, string)

Sets the DataSource and DataMember properties at run time.

ShouldSerializeGroupPadding()
ShouldSerializePadding()
ShouldSerializeSurfacePadding()
UncheckAllTiles()

Removes a check mark from all tiles.

WndProc(ref Message)

Processes Windows messages.

Events

Name Description
CompareGroups

Occurs when sorting groups in C1TileControl to compare two groups before their reordering.

CompareTiles

Occurs when sorting tiles in a Group to compare two tiles before their reordering.

FilterItem

Occurs when loading an item from the data source. It allows to skip some items if necessary.

FormatValue

Occurs when a data value has to be mapped to a tile property.

TileChecked

Occurs when some tile is checked.

TileClicked

Occurs when some tile is clicked.

TileMoved

Occurs when some tile is moved.

TileUnchecked

Occurs when some tile is unchecked.