EmojiChooser#

class EmojiChooser(**properties: Any)#

Superclasses: Popover, Widget, InitiallyUnowned, Object

Implemented Interfaces: Accessible, Buildable, ConstraintTarget, Native, ShortcutManager

The GtkEmojiChooser is used by text widgets such as GtkEntry or GtkTextView to let users insert Emoji characters.

https://docs.gtk.org/gtk4/emojichooser.png

GtkEmojiChooser emits the emoji_picked signal when an Emoji is selected.

Shortcuts and Gestures#

GtkEmojiChooser supports the following keyboard shortcuts:

  • Ctrl`+:kbd:`N scrolls th the next section.

  • Ctrl`+:kbd:`P scrolls th the previous section.

Actions#

GtkEmojiChooser 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 GtkEmojiChooser 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.

Constructors#

class EmojiChooser
classmethod new() Widget#

Creates a new GtkEmojiChooser.

Signals#

class EmojiChooser.signals
emoji_picked(text: str) None#

The type of the None singleton.

Parameters:

text – the Unicode sequence for the picked Emoji, in UTF-8