Defines the base class represents the grid layout.
constructor(options?: any): GridLayout
Initializes a new instance of the GridLayout class.
JavaScript object containing initialization data for the layout.
Gets the DashboardLayout control which the layout is applied in.
Gets or sets the current layout settings as a JSON string.
This property is typically used to persist the layout settings. The maximum state of the tile is temporary and it will not be persisted.
Gets the full type name of the current object.
It should be overrided for every class which extends from this class..
Gets or sets the maximum number of the row count or the column count.
If the tiles are laid out vertically, it is used to specify the max count of columns the layout could hold. The tiles shown in the column can not exceed this value. For AutoGridLayout, if there are no enough column spans to hold the next tile, it will be shown in the next row. For ManualGridLayout, if the tile's Column is specified to exceed the max value, it will be shown at the cell with the max column index in the row.
If the tiles are laid out horizontally, it is used to specify the max count of rows the layout could hold. For AutoGridLayout, if there are no enough row spans to hold the next tile, it will moved to next column. For ManualGridLayout, if the tile's Row exceeds this value, it will be shown at the cell with the max row index in the column.
addEventListener(target: EventTarget, type: string, fn: any, capture?: boolean): void
Adds an event listener to an element owned by this Control.
The control keeps a list of attached listeners and their handlers, making it easier to remove them when the control is disposed (see the dispose and removeEventListener methods).
Failing to remove event listeners may cause memory leaks.
Target element for the event.
String that specifies the event.
Function to execute when the event occurs.
Whether the listener is capturing.
attachTo(dashboard: DashboardLayout): void
Applies this layout to the specified DashboardLayout control.
A DashboardLayout control which the layout is applied to.
detach(): void
Detaches this layout from the DashboardLayout control.
It is often used when applying the new layout, the old layout should be detached.
A boolean value decides wehter to keep the current status when disposing. If true, all the current status will be cleared. Otherwise, keep the current status.
draw(): void
Draws the layout.
endMove(movedTile: Tile, endPosition: Point): void
Ends moving the tile at the specified postion.
The tile to be moved.
The position where the tile is moved to. It is the coordinate within the browser visible area.
initialize(options: any): void
Initializes the layout by copying the properties from a given object.
This method allows you to initialize the object using plain data objects instead of setting the value of each property in code.
Object that contains the initialization data.
invalidate(fullUpdate?: boolean): void
Invalidates the dashboard causing an asynchronous refresh.
Whether to update the dashboard layout as well as the content.
move(movedTile: Tile, position: Point): void
Moves the tile.
The tile to be moved.
The position of the moving mouse. It is the coordinate within the browser visible area.
moveTo(tile: Tile, pt: Point): void
Moves the tile to the specified postion.
The tile to be moved.
The position where the tile is moved to in relation to the dashboard.
refresh(fullUpdate?: boolean): void
Refreshes the layout.
A boolean value decides whether to update the content completely. If true, the layout refreshes without keeping the current status(moving, resizing and etc.). Otherwise, the status is kept after refreshing.
remove(removedTile: Tile): boolean
Removes the tile from the layout.
The tile to be removed.
removeEventListener(target?: EventTarget, type?: string, fn?: any, capture?: boolean): number
Removes one or more event listeners attached to elements owned by this Control.
Target element for the event. If null, removes listeners attached to all targets.
String that specifies the event. If null, removes listeners attached to all events.
Handler to remove. If null, removes all handlers.
Whether the listener is capturing. If null, removes capturing and non-capturing listeners.
resize(resizedTile: Tile, toPosition?: Point): boolean
Resize the tile to the specified postion.
The tile to be resized.
The position where the tile is resized to. It is the coordinate within the browser visible area.
resizeTo(resizedTile: Tile, newSize: Size): boolean
Resizes the tile to the specified size.
Adds the codes to resize the tile to the specified size by pxWidth and pxHeight.
startMove(movedTile: Tile, startPosition: Point): boolean
Starts to move the tile.
The tile to be moved.
The started position where the tile will be moved from. It is the coordinate within the browser visible area.
toggleSize(currentTile: Tile): void
Toggles the tile size.
The tile to be toggled.