Skip to main content

Function: fireEvent()

fireEvent(element, signalName, ...args): Promise<void>

Defined in: fire-event.ts:30

Emits a GTK signal on a widget or event controller.

Low-level utility for triggering signals directly. Prefer userEvent for common interactions like clicking and typing.

Parameters

ParameterTypeDescription
elementWidget | EventControllerThe widget or event controller to emit the signal on
signalNamestringGTK signal name (e.g., "clicked", "activate", "drag-begin")
...argsValue[]Additional signal arguments as GValues

Returns

Promise<void>

Example

import { fireEvent } from "@gtkx/testing";
import { Value } from "@gtkx/ffi/gobject";

// Emit signal on widget
await fireEvent(widget, "clicked");

// Emit signal on gesture controller
const gesture = widget.observeControllers().getObject(0) as Gtk.GestureDrag;
await fireEvent(gesture, "drag-begin", Value.newFromDouble(100), Value.newFromDouble(100));

See

userEvent for high-level user interactions