Infos about event functions – parameters and return values

Bugs / FRs / Support
, ,
1
Hyprland version 
Hyprland 0.56.0 built from branch v0.56.0 at commit 36b2e0cfe0c6094dbc47bd42a437431315bb3087 clean (version: bump to 0.56.0).
Date: Mon Jul 20 07:50:48 2026
Tag: v0.56.0, commits: 7625

Libraries:
Hyprgraphics: built against 0.5.1, system has 0.5.1
Hyprutils: built against 0.14.0, system has 0.14.0
Hyprcursor: built against 0.1.13, system has 0.1.13
Hyprlang: built against 0.6.8, system has 0.6.8
Aquamarine: built against 0.13.0, system has 0.13.0

Version ABI string: 36b2e0cfe0c6094dbc47bd42a437431315bb3087_aq_0.13_hu_0.14_hg_0.5_hc_0.1_hlg_0.6
no flags were set

(there are not backticks)

I want to create an event function to be able to abort the closing process of a window eventually. I read about window.close in the wiki, but there are not hints, what parameters the event function gets and which return values are possible, so if my plan is possible or not.

Where can I find detailed infos about all these event functions?

Regards

Peter

2

on the wiki: Expanding functionality – Hyprland Wiki

3

Yes, thank you for this hint. But I knew this chapter in the wiki. From here I knew about window.close.

But how to know about parameters of each event? How to know about a return value (perhaps) to manipulate the ongoing event?

4

there is no return value. Parameters are in the table I linked.

5

Parameters are in the table I linked.

Oh, that’s embarrassing. Yes, they are. I didn’t recognize the last column, perhaps because there was not, what I was searching for (other parameters I can use for my plan). Thank you for open my eyes ;-)

there is no return value

So I see, there is no way to abort the closing of a window by this window.close event and no other one.

Any other ideas?

6

you can’t abort the closing, when close is emitted, the window already closed. It’s the app closing it, not hyprland.