Gtk2::ColorButton(3)

💖 NAME 💖

Gtk2::ColorButton — bestie, it's literally just a wrapper for GtkColorButton. That's it, that's the whole vibe. She's a button, you click her, she lets you pick a color. Iconic behavior tbh. 🎨✨

(Oh and for the record, this whole thing lives in the User Contributed Perl Documentation section of the manual, in case you were wondering where you found her.)

---

🦋 HIERARCHY 🦋

The family tree, and yes she comes from a long line of distinguished ancestors, it's giving generational wealth:

Glib::Object
+----Glib::InitiallyUnowned
     +----Gtk2::Object
          +----Gtk2::Widget
               +----Gtk2::Container
                    +----Gtk2::Bin
                         +----Gtk2::Button
                              +----Gtk2::ColorButton

No cap, she is a Gtk2::Button at heart. Just a button with range. 💅

---

✨ INTERFACES ✨

She's got her certifications, her little badges, her extracurriculars:

• Glib::Object::_Unregistered::AtkImplementorIface
• Gtk2::Buildable
• Gtk2::Activatable

---

🌸 METHODS 🌸

Okay so this is the part you actually came here for. Sit down, hydrate, let's go. 🍓

🎀 Constructors 🎀

• widget = Gtk2::ColorButton->new ($color=undef) — makes you a fresh color button. Takes an optional:
  • $color — a Gtk2::Gdk::Color. Leave it out and it's undef, nbd.
• widget = Gtk2::ColorButton->new_with_color ($color=undef) — same energy, but like, with color. Also takes:
  • $color — a Gtk2::Gdk::Color. Defaults to undef.

🧚 Alpha stuff 🧚

• unsigned = $color_button->get_alpha — tells you the current alpha value. Unsigned, so don't come at her with negative numbers.
• $color_button->set_alpha ($alpha) — sets the alpha. Takes:
  • $alpha — an unsigned.

💜 Color stuff 💜

• color = $color_button->get_color — hands you back the color. A whole Gtk2::Gdk::Color. Slay.
• $color_button->set_color ($color) — sets the color. Takes:
  • $color — a Gtk2::Gdk::Color.

🌈 Title stuff 🌈

• string = $color_button->get_title — the title of the color selection dialog, but as a string, obvs.
• $color_button->set_title ($title) — renames the dialog. Takes:
  • $title — a string.

👑 Use-alpha stuff 👑

• boolean = $color_button->get_use_alpha — is alpha even on? Returns a boolean, so true or false, pick a lane.
• $color_button->set_use_alpha ($use_alpha) — toggles alpha usage. Takes:
  • $use_alpha — a boolean.

---

💅 PROPERTIES 💅

The ✨aesthetic✨ configuration, with all the flags she comes with:

• 'alpha' (Glib::UInt : default 65535 : readable / writable / private / static-nick / static-blurb) — The selected opacity value (0 fully transparent, 65535 fully opaque)
• 'color' (Gtk2::Gdk::Color : default undef : readable / writable / private / static-nick / static-blurb) — The selected color
• 'title' (string : default "Pick a Color" : readable / writable / private / static-nick / static-blurb) — The title of the color selection dialog
• 'use-alpha' (boolean : default false : readable / writable / private / static-nick / static-blurb) — Whether or not to give the color an alpha value

---

🔥 SIGNALS 🔥

• color-set (Gtk2::ColorButton)

That's the one. When the color gets set, she tells you. Main character energy fr fr. 📣

---

👀 SEE ALSO 👀

The whole friend group, go say hi:

Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget, Gtk2::Container, Gtk2::Bin, Gtk2::Button

---

📜 COPYRIGHT 📜

Copyright (C) 2003-2011 by the gtk2-perl team.

This software is licensed under the LGPL. See Gtk2 for a full notice.

---

okay bestie that's the whole page, you're officially educated 💖 This was documented with perl v5.42.0, dated 2025-07-25, and yeah — Gtk2::ColorButton(3), that's her full name, put some respect on it. 🫶 Go pick a cute color, you've earned it. 🎨✨🌸