QBoxLayout

Lines up child widgets horizontally or vertically.

This class is a JS wrapper around Qt's QBoxLayout class

Example

// This example arranges two calendars horizontally.

const { QBoxLayout, QCalendarWidget } = require("@nodegui/nodegui");

const centralWidget = new QWidget();
const boxLayout = new QBoxLayout(0);

boxLayout.addWidget(new QCalendarWidget());
boxLayout.addWidget(new QCalendarWidget());
centralWidget.setLayout(boxLayout);

Hierarchy

↳ QLayout‹QBoxLayoutSignals›

↳ QBoxLayout

Index

Constructors

• constructor

Properties

• native
• type

Methods

• _id
• activate
• addEventListener
• addLayout
• addSpacing
• addStretch
• addStrut
• addWidget
• children
• count
• delete
• deleteLater
• direction
• dumpObjectInfo
• dumpObjectTree
• eventProcessed
• inherits
• insertLayout
• insertSpacing
• insertStretch
• insertWidget
• invalidate
• isEnabled
• killTimer
• objectName
• parent
• property
• removeEventListener
• removeWidget
• setContentsMargins
• setDirection
• setEnabled
• setEventProcessed
• setObjectName
• setParent
• setProperty
• setSizeConstraint
• setSpacing
• setStretch
• sizeConstraint
• spacing
• startTimer
• update

Constructors

constructor

+ new QBoxLayout(arg: NativeElement | Direction, parent?: QWidget): QBoxLayout

Overrides QObject.constructor

Parameters:

Name	Type
arg	NativeElement | Direction
parent?	QWidget

Returns: QBoxLayout

Properties

native

• native: NativeElement | null

Inherited from Component.native

---

type

• type: string = "layout"

Inherited from QLayout.type

Methods

_id

▸ _id(): number

Inherited from QObject._id

Get an ID identifying the underlying C++ object.

This can be useful when debugging memory problems with help from setLogCreateQObject() and setLogDestroyQObject(). The number is hash of the memory address of the C++ object.

Returns: number

a unique number which is valid for the lifetime of the C++ object.

---

activate

▸ activate(): boolean

Inherited from QLayout.activate

Returns: boolean

---

addEventListener

▸ addEventListener‹SignalType›(signalType: SignalType, callback: QBoxLayoutSignals[SignalType], options?: EventListenerOptions): void

Inherited from EventWidget.addEventListener

Type parameters:

▪ SignalType: keyof QBoxLayoutSignals

Parameters:

Name	Type	Description
signalType	SignalType	SignalType is a signal from the widgets signals interface.
callback	QBoxLayoutSignals[SignalType]	Corresponding callback for the signal as mentioned in the widget's signal interface
options?	EventListenerOptions	Extra optional options controlling how this event listener is added.

Returns: void

void

For example in the case of QPushButton:

const button = new QPushButton();
button.addEventListener('clicked',(checked)=>console.log("clicked"));
// here clicked is a value from QPushButtonSignals interface

▸ addEventListener(eventType: WidgetEventTypes, callback: function, options?: EventListenerOptions): void

Inherited from EventWidget.addEventListener

Parameters:

▪ eventType: WidgetEventTypes

▪ callback: function

▸ (event?: NativeRawPointer‹"QEvent"›): void

Parameters:

Name	Type
event?	NativeRawPointer‹"QEvent"›

▪Optional options: EventListenerOptions

Extra optional options controlling how this event listener is added.

For example in the case of QPushButton:

const button = new QPushButton();
button.addEventListener(WidgetEventTypes.HoverEnter,()=>console.log("hovered"));

Returns: void

---

addLayout

▸ addLayout(layout: QLayout, stretch: number): void

Parameters:

Name	Type	Default
layout	QLayout	-
stretch	number	0

Returns: void

---

addSpacing

▸ addSpacing(size: number): void

Parameters:

Name	Type
size	number

Returns: void

---

addStretch

▸ addStretch(stretch: number): void

Parameters:

Name	Type	Default
stretch	number	0

Returns: void

---

addStrut

▸ addStrut(size: number): void

Parameters:

Name	Type
size	number

Returns: void

---

addWidget

▸ addWidget(widget: QWidget, stretch: number, alignment: AlignmentFlag): void

Overrides QLayout.addWidget

Parameters:

Name	Type	Default
widget	QWidget	-
stretch	number	0
alignment	AlignmentFlag	0

Returns: void

---

children

▸ children(): QObject[]

Inherited from QObject.children

Returns: QObject[]

---

count

▸ count(): number

Returns: number

---

delete

▸ delete(): void

Inherited from QObject.delete

Returns: void

---

deleteLater

▸ deleteLater(): void

Inherited from QObject.deleteLater

Returns: void

---

direction

▸ direction(): Direction

Returns: Direction

---

dumpObjectInfo

▸ dumpObjectInfo(): void

Inherited from QObject.dumpObjectInfo

Returns: void

---

dumpObjectTree

▸ dumpObjectTree(): void

Inherited from QObject.dumpObjectTree

Returns: void

---

eventProcessed

▸ eventProcessed(): boolean

Inherited from EventWidget.eventProcessed

Get the state of the event processed flag

See setEventProcessed().

Returns: boolean

boolean True if the current event is flagged as processed.

---

inherits

▸ inherits(className: string): boolean

Inherited from QObject.inherits

Parameters:

Name	Type
className	string

Returns: boolean

---

insertLayout

▸ insertLayout(index: number, layout: QLayout, stretch: number): void

Parameters:

Name	Type	Default
index	number	-
layout	QLayout	-
stretch	number	0

Returns: void

---

insertSpacing

▸ insertSpacing(index: number, size: number): void

Parameters:

Name	Type
index	number
size	number

Returns: void

---

insertStretch

▸ insertStretch(index: number, stretch: number): void

Parameters:

Name	Type	Default
index	number	-
stretch	number	0

Returns: void

---

insertWidget

▸ insertWidget(index: number, widget: QWidget, stretch: number): void

Parameters:

Name	Type	Default
index	number	-
widget	QWidget	-
stretch	number	0

Returns: void

---

invalidate

▸ invalidate(): void

Inherited from QLayout.invalidate

Returns: void

---

isEnabled

▸ isEnabled(): boolean

Inherited from QLayout.isEnabled

Returns: boolean

---

killTimer

▸ killTimer(timerId: number): void

Inherited from QObject.killTimer

Parameters:

Name	Type
timerId	number

Returns: void

---

objectName

▸ objectName(): string

Inherited from QObject.objectName

Returns: string

---

parent

▸ parent(): QObject

Inherited from QObject.parent

Returns: QObject

---

property

▸ property(name: string): QVariant

Inherited from QObject.property

Parameters:

Name	Type
name	string

Returns: QVariant

---

removeEventListener

▸ removeEventListener‹SignalType›(signalType: SignalType, callback: QBoxLayoutSignals[SignalType], options?: EventListenerOptions): void

Inherited from EventWidget.removeEventListener

Type parameters:

▪ SignalType: keyof QBoxLayoutSignals

Parameters:

Name	Type
signalType	SignalType
callback	QBoxLayoutSignals[SignalType]
options?	EventListenerOptions

Returns: void

▸ removeEventListener(eventType: WidgetEventTypes, callback: function, options?: EventListenerOptions): void

Inherited from EventWidget.removeEventListener

Parameters:

▪ eventType: WidgetEventTypes

▪ callback: function

▸ (event?: NativeRawPointer‹"QEvent"›): void

Parameters:

Name	Type
event?	NativeRawPointer‹"QEvent"›

▪Optional options: EventListenerOptions

Returns: void

---

removeWidget

▸ removeWidget(widget: QWidget): void

Overrides QLayout.removeWidget

Parameters:

Name	Type
widget	QWidget

Returns: void

---

setContentsMargins

▸ setContentsMargins(left: number, top: number, right: number, bottom: number): void

Inherited from QLayout.setContentsMargins

Parameters:

Name	Type
left	number
top	number
right	number
bottom	number

Returns: void

---

setDirection

▸ setDirection(dir: Direction): void

Parameters:

Name	Type
dir	Direction

Returns: void

---

setEnabled

▸ setEnabled(enable: boolean): void

Inherited from QLayout.setEnabled

Parameters:

Name	Type
enable	boolean

Returns: void

---

setEventProcessed

▸ setEventProcessed(isProcessed: boolean): void

Inherited from EventWidget.setEventProcessed

Mark the current event as having been processed

This method is used to indicate that the currently dispatched event has been processed and no further processing by superclasses is required. It only makes sense to call this method from an event handler.

When set, this flag will cause NodeGui's QObject::event() method to return true and not call the superclass event(), effectively preventing any further processing on this event.

Parameters:

Name	Type	Description
isProcessed	boolean	true if the event has been processed.

Returns: void

---

setObjectName

▸ setObjectName(objectName: string): void

Inherited from QObject.setObjectName

Parameters:

Name	Type
objectName	string

Returns: void

---

setParent

▸ setParent(parent: QObject): void

Inherited from QObject.setParent

Parameters:

Name	Type
parent	QObject

Returns: void

---

setProperty

▸ setProperty(name: string, value: QVariantType): boolean

Inherited from QObject.setProperty

Parameters:

Name	Type
name	string
value	QVariantType

Returns: boolean

---

setSizeConstraint

▸ setSizeConstraint(constraint: SizeConstraint): void

Inherited from QLayout.setSizeConstraint

Parameters:

Name	Type
constraint	SizeConstraint

Returns: void

---

setSpacing

▸ setSpacing(spacing: number): void

Inherited from QLayout.setSpacing

Parameters:

Name	Type
spacing	number

Returns: void

---

setStretch

▸ setStretch(index: number, stretch: number): void

Parameters:

Name	Type
index	number
stretch	number

Returns: void

---

sizeConstraint

▸ sizeConstraint(): SizeConstraint

Inherited from QLayout.sizeConstraint

Returns: SizeConstraint

---

spacing

▸ spacing(): number

Inherited from QLayout.spacing

Returns: number

---

startTimer

▸ startTimer(intervalMS: number, timerType: TimerType): number

Inherited from QObject.startTimer

Parameters:

Name	Type	Default
intervalMS	number	-
timerType	TimerType	TimerType.CoarseTimer

Returns: number

---

update

▸ update(): void

Inherited from QLayout.update

Returns: void