Editor Scripting API
    Preparing search index...

    Class StackedWidget

    Container displaying one child widget at a time.

        const root = new Widget(parent);
        const layout = new BoxLayout();
        layout.setDirection(Direction.TopToBottom);
        layout.spacing = 8;
        root.layout = layout;

        // ComboBox to select which page to show
        const selector = new ComboBox(root);
        const pages = ['Page 1 - Settings', 'Page 2 - Info'];
        for (const p of pages) selector.addItem(p);
        layout.addWidget(selector);

        // StackedWidget shows one child widget at a time
        const stack = new StackedWidget(root);

        // Page 1
        const page1 = new Widget(root);
        const page1Layout = new BoxLayout();
        page1Layout.setDirection(Direction.TopToBottom);
        page1.layout = page1Layout;
        const label1 = new Label(page1);
        label1.text = 'Settings Page';
        label1.fontRole = FontRole.Title;
        page1Layout.addWidget(label1);
        const desc1 = new Label(page1);
        desc1.text = 'Configure your preferences here.';
        desc1.wordWrap = true;
        page1Layout.addWidget(desc1);
        stack.addWidget(page1);

        // Page 2
        const page2 = new Widget(root);
        const page2Layout = new BoxLayout();
        page2Layout.setDirection(Direction.TopToBottom);
        page2.layout = page2Layout;
        const label2 = new Label(page2);
        label2.text = 'Info Page';
        label2.fontRole = FontRole.Title;
        page2Layout.addWidget(label2);
        const desc2 = new Label(page2);
        desc2.text = 'Version 1.0 — Plugin information.';
        desc2.wordWrap = true;
        page2Layout.addWidget(desc2);
        stack.addWidget(page2);

        layout.addWidget(stack);

        this.connections.push(
          selector.onCurrentTextChange.connect((text: string) => {
            const idx = pages.indexOf(text);
            if (idx >= 0) {
              stack.currentIndex = idx;
              console.log('Switched to page', idx);
            }
          })
        );

    Hierarchy (View Summary)

    Index

    Constructors

    constructor

    Properties

    autoFillBackground backgroundRole className contextMenuPolicy currentIndex currentWidget devicePixelRatio enabled fontRole foregroundRole hasFocus height hidden isNull isTransparentForMouseEvents layout objectName onClose onFocusIn onFocusOut onHide onKeyPress onMouseDoubleClick onMouseMove onMousePress onMouseRelease onResize onShow toolTip visible width windowTitle

    Methods

    activateWindow addWidget adjustSize blockSignals close deleteLater findChild getProperty getTypeName grab isOfType isSame move raise resize setContentsMargins setCursor setCursorPixmap setFixedHeight setFixedWidth setFocus setMaximumHeight setMaximumWidth setMinimumHeight setMinimumWidth setProperty setSizePolicy setUndoable setUndoableRecursive show unsetCursor

    Constructors

    Properties

    autoFillBackground: boolean

    Whether the widget automatically fills its background before painting.

    backgroundRole: ColorRole

    The color role used for the widget's background.

    className: string
    contextMenuPolicy: ContextMenuPolicy

    Controls how the widget handles context menu requests.

    currentIndex: number

    Index of the currently visible widget.

    currentWidget: Widget

    Reference to the currently visible widget.

    devicePixelRatio: number

    The ratio between physical and logical pixels for the widget's display.

    enabled: boolean

    Whether the widget is interactive and accepts user input.

    fontRole: FontRole

    The font role applied to the widget's text rendering.

    foregroundRole: ColorRole

    The color role used for the widget's foreground elements.

    hasFocus: boolean
    height: number

    Current height of the widget in pixels.

    hidden: boolean

    Whether the widget is hidden from view.

    isNull: boolean

    True if the underlying native widget object has been destroyed.

    isTransparentForMouseEvents: boolean
    layout: Layout

    The layout manager assigned to arrange child widgets.

    objectName: string
    onClose: signal1<CloseEvent, void>

    Signal emitted when the widget is closed.

    onFocusIn: signal0<void>
    onFocusOut: signal0<void>
    onHide: signal0<void>

    Signal emitted when the widget becomes hidden.

    onKeyPress: signal1<number, void>

    Signal emitted when a key is pressed while the widget has focus.

    onMouseDoubleClick: signal1<MouseEvent, void>

    Signal emitted when the user double-clicks on the widget.

    onMouseMove: signal1<MouseEvent, void>

    Signal emitted when the mouse moves over the widget.

    onMousePress: signal1<MouseEvent, void>

    Signal emitted when a mouse button is pressed on the widget.

    onMouseRelease: signal1<MouseEvent, void>

    Signal emitted when a mouse button is released on the widget.

    onResize: signal2<number, number, void>

    Signal emitted when the widget is resized.

    onShow: signal0<void>

    Signal emitted when the widget becomes visible.

    toolTip: string

    Text displayed in a tooltip when the user hovers over the widget.

    visible: boolean

    Whether the widget is currently visible.

    width: number

    Current width of the widget in pixels.

    windowTitle: string

    Title text displayed in the widget's title bar when shown as a window.

    Methods

    • Brings the widget's top-level window to the foreground and gives it focus.

      Returns void

    • Adds a widget to the stack and returns its index.

      Parameters

      Returns number

    • Resizes the widget to fit its contents based on the size hint.

      Returns void

    • Blocks or unblocks signal emission from the widget.

      Parameters

      • blocked: boolean

      Returns void

    • Closes the widget, hiding it and emitting the onClose signal.

      Returns void

    • Schedules the widget for deletion after the current event loop iteration.

      Returns void

    • Parameters

      • name: string

      Returns any

    • Returns the name of this object's type.

      Returns string

    • Captures the widget's current rendered content as a Pixmap.

      Returns Pixmap

    • Returns true if the object is of the specified type.

      Parameters

      • type: string

      Returns boolean

    • Returns true if this object refers to the same instance as the given object.

      Parameters

      Returns boolean

    • Moves the widget to the specified position.

      Parameters

      • ax: number
      • ay: number

      Returns void

    • Raises the widget to the top of the parent widget's stack.

      Returns void

    • Resizes the widget to the specified width and height.

      Parameters

      • width: number
      • height: number

      Returns void

    • Sets the margins around the widget's contents.

      Parameters

      • left: number
      • top: number
      • right: number
      • bottom: number

      Returns void

    • Sets a custom pixmap as the cursor when the mouse is over the widget.

      Parameters

      Returns void

    • Locks the widget's height to the given value, preventing resizing.

      Parameters

      • height: number

      Returns void

    • Locks the widget's width to the given value, preventing resizing.

      Parameters

      • width: number

      Returns void

    • Gives keyboard input focus to the widget.

      Returns void

    • Sets the maximum height the widget can be resized to.

      Parameters

      • height: number

      Returns void

    • Sets the maximum width the widget can be resized to.

      Parameters

      • width: number

      Returns void

    • Sets the minimum height the widget must maintain.

      Parameters

      • height: number

      Returns void

    • Sets the minimum width the widget must maintain.

      Parameters

      • width: number

      Returns void

    • Parameters

      • name: string
      • value: any

      Returns boolean

    • Marks property changes on this widget as undoable via the undo stack.

      Parameters

      • undoable: boolean

      Returns void

    • Marks property changes on this widget and all its children as undoable.

      Parameters

      • undoable: boolean

      Returns void

    • Makes the widget visible.

      Returns void

    • Resets the cursor to the parent widget's cursor.

      Returns void

    Settings

    Member Visibility

    On This Page

    Constructors
    Properties
    Methods