C1TileControl Class

Represents a scrollable surface with tiles.

Inheritance

object

MarshalByRefObject

Component

Control

C1TileControl

Implements

Namespace: C1.Win.Tile

Assembly: C1.Win.TileControl.10.dll

Syntax

[ToolboxBitmap(typeof(C1TileControl), "C1TileControl.png")]
[ComVisible(true)]
public class C1TileControl : Control, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable

<ToolboxBitmap(GetType(C1TileControl), "C1TileControl.png")>
<ComVisible(True)>
Public Class C1TileControl
    Inherits Control
    Implements 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 System.Xml.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 System.Xml.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.