Package: gtk

Class gtk:emoji-chooser

Superclasses

Documented Subclasses

None

Direct Slots

None

Details

The gtk:emoji-chooser widget is used by text widgets such as the gtk:entry or gtk:text-view widgets to offer users a convenient way to insert Emoji characters.


Figure: GtkEmojiChooser


The gtk:emoji-chooser widget emits the "emoji-picked" signal when an Emoji is selected.

Shortcuts and Gestures

The gtk:emoji-chooser installation supports the following keyboard shortcuts:
Ctrl+N
scrolls to the next section.
Ctrl+P
scrolls to the previous section.

Action Details

The gtk:emoji-chooser installation defines a set of built-in actions:
scroll.section
scrolls to the next or previous section.

CSS nodes

popover
├── box.emoji-searchbar
│   ╰── entry.search
╰── box.emoji-toolbar
    ├── button.image-button.emoji-section
    ├── ...
    ╰── button.image-button.emoji-section    
Every gtk:emoji-chooser widget consists of a main node called popover. The contents of the popover are largely implementation defined and supposed to inherit general styles. The top searchbar used to search emoji and gets the .emoji-searchbar style class itself. The bottom toolbar used to switch between different emoji categories consists of buttons with the .emoji-section style class and gets the .emoji-toolbar style class itself.

Signal Details

The "emoji-picked" signal
lambda (chooser text)    :run-last      
chooser
The gtk:emoji-chooser widget.
text
The string for the Unicode sequence for the picked Emoji, in UTF-8.
The signal is emitted when the user selects an Emoji.
 

Inherited Slot Access Functions

See also

2026-01-31