Theia API Documentation v1.65.0
    Preparing search index...

    A layout which arranges its widgets in a grid.

    Hierarchy (View Summary)

    Index

    Constructors

    Accessors

    • get columnCount(): number

      Get the number of columns in the layout.

      Returns number

    • set columnCount(value: number): void

      Set the number of columns in the layout.

      The minimum column count is 1.

      Parameters

      • value: number

      Returns void

    • get columnSpacing(): number

      Get the column spacing for the layout.

      Returns number

    • set columnSpacing(value: number): void

      Set the col spacing for the layout.

      Parameters

      • value: number

      Returns void

    • get fitPolicy(): FitPolicy

      Get the fit policy for the layout.

      The fit policy controls the computed size constraints which are applied to the parent widget by the layout.

      Some layout implementations may ignore the fit policy.

      Returns FitPolicy

    • set fitPolicy(value: FitPolicy): void

      Set the fit policy for the layout.

      The fit policy controls the computed size constraints which are applied to the parent widget by the layout.

      Some layout implementations may ignore the fit policy.

      Changing the fit policy will clear the current size constraint for the parent widget and then re-fit the parent.

      Parameters

      Returns void

    • get isDisposed(): boolean

      Test whether the layout is disposed.

      Returns boolean

    • get parent(): null | Widget

      Get the parent widget of the layout.

      Returns null | Widget

    • set parent(value: null | Widget): void

      Set the parent widget of the layout.

      This is set automatically when installing the layout on the parent widget. The parent widget should not be set directly by user code.

      Parameters

      Returns void

    • get rowCount(): number

      Get the number of rows in the layout.

      Returns number

    • set rowCount(value: number): void

      Set the number of rows in the layout.

      The minimum row count is 1.

      Parameters

      • value: number

      Returns void

    • get rowSpacing(): number

      Get the row spacing for the layout.

      Returns number

    • set rowSpacing(value: number): void

      Set the row spacing for the layout.

      Parameters

      • value: number

      Returns void

    Methods

    • Create an iterator over the widgets in the layout.

      Returns IterableIterator<Widget>

      A new iterator over the widgets in the layout.

    • Add a widget to the grid layout.

      Parameters

      • widget: Widget

        The widget to add to the layout.

        If the widget is already contained in the layout, this is no-op.

      Returns void

    • Attach a widget to the parent's DOM node.

      Parameters

      • widget: Widget

        The widget to attach to the parent.

      Returns void

    • Get the stretch factor for a specific column.

      Parameters

      • index: number

        The column index of interest.

      Returns number

      The stretch factor for the column.

      This returns -1 if the index is out of range.

    • Detach a widget from the parent's DOM node.

      Parameters

      • widget: Widget

        The widget to detach from the parent.

      Returns void

    • Dispose of the resources held by the layout.

      Returns void

    • Perform layout initialization which requires the parent widget.

      Returns void

    • A message handler invoked on an 'after-attach' message.

      The default implementation of this method forwards the message to all widgets. It assumes all widget nodes are attached to the parent widget node.

      This may be reimplemented by subclasses as needed.

      Parameters

      Returns void

    • A message handler invoked on an 'after-detach' message.

      The default implementation of this method forwards the message to all widgets. It assumes all widget nodes are attached to the parent widget node.

      This may be reimplemented by subclasses as needed.

      Parameters

      Returns void

    • A message handler invoked on an 'after-hide' message.

      The default implementation of this method forwards the message to all non-hidden widgets. It assumes all widget nodes are attached to the parent widget node.

      This may be reimplemented by subclasses as needed.

      Parameters

      Returns void

    • A message handler invoked on an 'after-show' message.

      The default implementation of this method forwards the message to all non-hidden widgets. It assumes all widget nodes are attached to the parent widget node.

      This may be reimplemented by subclasses as needed.

      Parameters

      Returns void

    • A message handler invoked on a 'before-attach' message.

      Parameters

      Returns void

    • A message handler invoked on a 'before-detach' message.

      The default implementation of this method forwards the message to all widgets. It assumes all widget nodes are attached to the parent widget node.

      This may be reimplemented by subclasses as needed.

      Parameters

      Returns void

    • A message handler invoked on a 'before-hide' message.

      The default implementation of this method forwards the message to all non-hidden widgets. It assumes all widget nodes are attached to the parent widget node.

      This may be reimplemented by subclasses as needed.

      Parameters

      Returns void

    • A message handler invoked on a 'before-show' message.

      Parameters

      Returns void

    • A message handler invoked on a 'child-hidden' message.

      Parameters

      Returns void

    • A message handler invoked on a 'child-removed' message.

      This will remove the child widget from the layout.

      Subclasses should not typically reimplement this method.

      Parameters

      Returns void

    • A message handler invoked on a 'child-shown' message.

      Parameters

      Returns void

    • A message handler invoked on a 'fit-request' message.

      Parameters

      Returns void

    • A message handler invoked on an 'update-request' message.

      Parameters

      Returns void

    • Process a message sent to the parent widget.

      Parameters

      • msg: Message

        The message sent to the parent widget.

        This method is called by the parent widget to process a message.

        Subclasses may reimplement this method as needed.

      Returns void

    • Remove a widget from the grid layout.

      Parameters

      • widget: Widget

        The widget to remove from the layout.

        A widget is automatically removed from the layout when its parent is set to null. This method should only be invoked directly when removing a widget from a layout which has yet to be installed on a parent widget.

        This method does not modify the widget's parent.

      Returns void

    • Get the stretch factor for a specific row.

      Parameters

      • index: number

        The row index of interest.

      Returns number

      The stretch factor for the row.

      This returns -1 if the index is out of range.

    • Set the stretch factor for a specific column.

      Parameters

      • index: number

        The column index of interest.

      • value: number

        The stretch factor for the column.

        This is a no-op if the index is out of range.

      Returns void

    • Set the stretch factor for a specific row.

      Parameters

      • index: number

        The row index of interest.

      • value: number

        The stretch factor for the row.

        This is a no-op if the index is out of range.

      Returns void