Gtk2::Style(3)

📦
version 1.24993 · 2 versions
, in fedora 43

🎀 Gtk2::Style(3) 🎀

User Contributed Perl Documentation

okay bestie, this is the Gtk2::Style page and it is long, so buckle up 💅 we're doing this in parts.

💖 NAME 💖

Gtk2::Style — a wrapper for GtkStyle. that's the whole pitch, that's the vibe, periodt. 🫶

🌈 HIERARCHY 🌈

Glib::Object
+----Gtk2::Style

so Gtk2::Style sits right under Glib::Object. no cap. ✨

✨ METHODS ✨

style = Gtk2::Style->new

brand new style object, fresh out the box. 🎀

$style->apply_default_background ($window, $set_bg, $state_type, $area, $x, $y, $width, $height)

  • $window — a Gtk2::Gdk::Window
  • $set_bg — boolean
  • $state_type — a Gtk2::StateType
  • $area — a Gtk2::Gdk::Rectangle or undef
  • $x — integer
  • $y — integer
  • $width — integer
  • $height — integer

style = $style->attach ($window)

  • $window — a Gtk2::Gdk::Window

gives you back a style. 🦋

boolean = $style->attached

hands you a boolean, bestie. that's it. that's the method. 💅

$style->set_background ($window, $state_type)

  • $window — a Gtk2::Gdk::Window
  • $state_type — a Gtk2::StateType

color = $style->base ($state)

  • $state — a Gtk2::StateType

you get a color back. 🌸

gc = $style->base_gc ($state)

  • $state — a Gtk2::StateType

you get a gc back. 👑

color = $style->bg ($state)

  • $state — a Gtk2::StateType

color. 🎀

gc = $style->bg_gc ($state)

  • $state — a Gtk2::StateType

gc. ✨

pixmap = $style->bg_pixmap ($state, $pixmap=undef)

  • $state — a Gtk2::StateType
  • $pixmap — a Gtk2::Gdk::Pixmap or undef (and note the $pixmap=undef in the signature — it defaults to undef 🫶)

you get a pixmap. 💜

scalar = $style->black

scalar. yes. that's literally it. 🖤

scalar = $style->black_gc

also a scalar. 💀

style = $style->copy

gives you a style back — a copy. obviously. 🙈

color = $style->dark ($state)

  • $state — a Gtk2::StateType

color. 🌈

gc = $style->dark_gc ($state)

  • $state — a Gtk2::StateType

gc. ⭐

$style->detach

no args, no return listed, just vibes. 🧚

Gtk2->draw_insertion_cursor ($widget, $drawable, $area, $location, $is_primary, $direction, $draw_arrow)

okay heads up: this one is called on Gtk2 itself, not on $style. don't @ me, that's just how it's written. 💅

  • $widget — a Gtk2::Widget
  • $drawable — a Gtk2::Gdk::Drawable
  • $area — a Gtk2::Gdk::Rectangle
  • $location — a Gtk2::Gdk::Rectangle
  • $is_primary — boolean
  • $direction — a Gtk2::TextDirection
  • $draw_arrow — boolean
Since: gtk+ 2.4 🌱

color = $style->fg ($state)

  • $state — a Gtk2::StateType

color. 🍓

gc = $style->fg_gc ($state)

  • $state — a Gtk2::StateType

gc. ✨

scalar = $style->font_desc

a scalar, and it's your font description. 🎀

list = $style->get (widget_package, ...)

list = $style->get_style_property (widget_package, ...)

  • $widget_package — string, the widget package name (ex: 'Gtk2::TreeView')
  • ... — list, the list of property names

okay so here's the tea ☕ — this fetches and returns the values for the style properties you name in ... for a widget of type widget_package. and <hotpink>get</hotpink> is just an alias for get_style_property. same method, two names, iconic behavior. 👑

my $size = $style->get_style_property ("expander-size");
⚠️ Note: the get method shadows Glib::Object::get (see "get and set" in Glib::Object). this shouldn't be a problem since Gtk2::Style defines no properties (as of gtk+ 2.16). but if you have a class that's derived from Gtk2::Style and adds a property, or if a new version of gtk+ adds a property to Gtk2::Style, then that property can be accessed with get_property. noted, bestie. 📝
Since: gtk+ 2.16 🌱

color = $style->light ($state)

  • $state — a Gtk2::StateType

color. 🌟

gc = $style->light_gc ($state)

  • $state — a Gtk2::StateType

gc. 💫

color = $style->lookup_color ($color_name)

  • $color_name — string

color. 🎨

Since: gtk+ 2.10 🌱

iconset = $style->lookup_icon_set ($stock_id)

  • $stock_id — string

you get an iconset. cute. 🖼️

color = $style->mid ($state)

  • $state — a Gtk2::StateType

color. 🍒

gc = $style->mid_gc ($state)

  • $state — a Gtk2::StateType

gc. ✨

$style->paint_arrow ($window, $state_type, $shadow_type, $area, $widget, $detail, $arrow_type, $fill, $x, $y, $width, $height)

  • $window — a Gtk2::Gdk::Drawable
  • $state_type — a Gtk2::StateType
  • $shadow_type — a Gtk2::ShadowType
  • $area — a Gtk2::Gdk::Rectangle or undef
  • $widget — a Gtk2::Widget or undef
  • $detail — string or undef
  • $arrow_type — a Gtk2::ArrowType
  • $fill — boolean
  • $x — integer
  • $y — integer
  • $width — integer
  • $height — integer

$style->paint_box ($window, $state_type, $shadow_type, $area, $widget, $detail, $x, $y, $width, $height)

  • $window — a Gtk2::Gdk::Drawable
  • $state_type — a Gtk2::StateType
  • $shadow_type — a Gtk2::ShadowType
  • $area — a Gtk2::Gdk::Rectangle or undef
  • $widget — a Gtk2::Widget or undef
  • $detail — string or undef
  • $x — integer
  • $y — integer
  • $width — integer
  • $height — integer

$style->paint_box_gap ($window, $state_type, $shadow_type, $area, $widget, $detail, $x, $y, $width, $height, $gap_side, $gap_x, $gap_width)

  • $window — a Gtk2::Gdk::Drawable
  • $state_type — a Gtk2::StateType
  • $shadow_type — a Gtk2::ShadowType
  • $area — a Gtk2::Gdk::Rectangle or undef
  • $widget — a Gtk2::Widget or undef
  • $detail — string or undef
  • $x — integer
  • $y — integer
  • $width — integer
  • $height — integer
  • $gap_side — a Gtk2::PositionType
  • $gap_x — integer
  • $gap_width — integer

$style->paint_check ($window, $state_type, $shadow_type, $area, $widget, $detail, $x, $y, $width, $height)

  • $window — a Gtk2::Gdk::Drawable
  • $state_type — a Gtk2::StateType
  • $shadow_type — a Gtk2::ShadowType
  • $area — a Gtk2::Gdk::Rectangle or undef
  • $widget — a Gtk2::Widget 👀 (no or undef on this one, bestie — it's just Gtk2::Widget)
  • $detail — string or undef
  • $x — integer
  • $y — integer
  • $width — integer
  • $height — integer

$style->paint_diamond ($window, $state_type, $shadow_type, $area, $widget, $detail, $x, $y, $width, $height)

  • $window — a Gtk2::Gdk::Drawable
  • $state_type — a Gtk2::StateType
  • $shadow_type — a Gtk2::ShadowType
  • $area — a Gtk2::Gdk::Rectangle or undef
  • $widget — a Gtk2::Widget or undef
  • $detail — string or undef
  • $x — integer
  • $y — integer
  • $width — integer
  • $height — integer

$style->paint_expander ($window, $state_type, $area, $widget, $detail, $x, $y, $expander_style)

  • $window — a Gtk2::Gdk::Drawable
  • $state_type — a Gtk2::StateType
  • $area — a Gtk2::Gdk::Rectangle or undef
  • $widget — a Gtk2::Widget (again, no or undef 💅)
  • $detail — string or undef
  • $x — integer
  • $y — integer
  • $expander_style — a Gtk2::ExpanderStyle

$style->paint_extension ($window, $state_type, $shadow_type, $area, $widget, $detail, $x, $y, $width, $height, $gap_side)

  • $window — a Gtk2::Gdk::Drawable
  • $state_type — a Gtk2::StateType
  • $shadow_type — a Gtk2::ShadowType
  • $area — a Gtk2::Gdk::Rectangle or undef
  • $widget — a Gtk2::Widget or undef
  • $detail — string or undef
  • $x — integer
  • $y — integer
  • $width — integer
  • $height — integer
  • $gap_side — a Gtk2::PositionType

$style->paint_flat_box ($window, $state_type, $shadow_type, $area, $widget, $detail, $x, $y, $width, $height)

  • $window — a Gtk2::Gdk::Drawable
  • $state_type — a Gtk2::StateType
  • $shadow_type — a Gtk2::ShadowType
  • $area — a Gtk2::Gdk::Rectangle or undef
  • $widget — a Gtk2::Widget or undef
  • $detail — string or undef
  • $x — integer
  • $y — integer
  • $width — integer
  • $height — integer

$style->paint_focus ($window, $state_type, $area, $widget, $detail, $x, $y, $width, $height)

  • $window — a Gtk2::Gdk::Drawable
  • $state_type — a Gtk2::StateType
  • $area — a Gtk2::Gdk::Rectangle or undef
  • $widget — a Gtk2::Widget or undef
  • $detail — string or undef
  • $x — integer
  • $y — integer
  • $width — integer
  • $height — integer

$style->paint_handle ($window, $state_type, $shadow_type, $area, $widget, $detail, $x, $y, $width, $height, $orientation)

  • $window — a Gtk2::Gdk::Drawable
  • $state_type — a Gtk2::StateType
  • $shadow_type — a Gtk2::ShadowType
  • $area — a Gtk2::Gdk::Rectangle or undef
  • $widget — a Gtk2::Widget or undef
  • $detail — string 👀 (no or undef here, just plain string)
  • $x — integer
  • $y — integer
  • $width — integer
  • $height — integer
  • $orientation — a Gtk2::Orientation

$style->paint_hline ($window, $state_type, $area, $widget, $detail, $x1, $x2, $y)

  • $window — a Gtk2::Gdk::Drawable
  • $state_type — a Gtk2::StateType
  • $area — a Gtk2::Gdk::Rectangle or undef
  • $widget — a Gtk2::Widget or undef
  • $detail — string or undef
  • $x1 — integer
  • $x2 — integer
  • $y — integer

$style->paint_layout ($window, $state_type, $use_text, $area, $widget, $detail, $x, $y, $layout)

  • $window — a Gtk2::Gdk::Drawable
  • $state_type — a Gtk2::StateType
  • $use_text — boolean
  • $area — a Gtk2::Gdk::Rectangle or undef
  • $widget — a Gtk2::Widget or undef
  • $detail — string or undef
  • $x — integer
  • $y — integer
  • $layout — a Pango::Layout

$style->paint_option ($window, $state_type, $shadow_type, $area, $widget, $detail, $x, $y, $width, $height)

  • $window — a Gtk2::Gdk::Drawable
  • $state_type — a Gtk2::StateType
  • $shadow_type — a Gtk2::ShadowType
  • $area — a Gtk2::Gdk::Rectangle or undef
  • $widget — a Gtk2::Widget (yep, no or undef, stay woke 💅)
  • $detail — string or undef
  • $x — integer
  • $y — integer
  • $width — integer
  • $height — integer

$style->paint_polygon ($window, $state_type, $shadow_type, $area, $widget, $detail, $fill, $x1, $y1, ...)

  • $window — a Gtk2::Gdk::Drawable
  • $state_type — a Gtk2::StateType
  • $shadow_type — a Gtk2::ShadowType
  • $area — a Gtk2::Gdk::Rectangle or undef
  • $widget — a Gtk2::Widget or undef
  • $detail — string or undef
  • $fill — boolean
  • $x1 — integer, x coordinate of the first vertex
  • $y1 — integer, y coordinate of the first vertex
  • ... — list, pairs of x and y coordinates

$style->paint_resize_grip ($window, $state_type, $area, $widget, $detail, $edge, $x, $y, $width, $height)

  • $window — a Gtk2::Gdk::Drawable
  • $state_type — a Gtk2::StateType
  • $area — a Gtk2::Gdk::Rectangle or undef
  • $widget — a Gtk2::Widget or undef
  • $detail — string or undef
  • $edge — a Gtk2::Gdk::WindowEdge
  • $x — integer
  • $y — integer
  • $width — integer
  • $height — integer

$style->paint_shadow ($window, $state_type, $shadow_type, $area, $widget, $detail, $x, $y, $width, $height)

  • $window — a Gtk2::Gdk::Drawable
  • $state_type — a Gtk2::StateType
  • $shadow_type — a Gtk2::ShadowType
  • $area — a Gtk2::Gdk::Rectangle or undef
  • $widget — a Gtk2::Widget or undef
  • $detail — string or undef
  • $x — integer
  • $y — integer
  • $width — integer
  • $height — integer

$style->paint_shadow_gap ($window, $state_type, $shadow_type, $area, $widget, $detail, $x, $y, $width, $height, $gap_side, $gap_x, $gap_width)

  • $window — a Gtk2::Gdk::Drawable
  • $state_type — a Gtk2::StateType

…and that's exactly where part 1 runs out, bestie 😭 the rest of paint_shadow_gap's args are waiting in the next chunk. 💖

okay so picking up right where we left off, the rest of the params for that method were:

  • $shadow_type (Gtk2::ShadowType) — a Gtk2::ShadowType, bestie 💅
  • $area (Gtk2::Gdk::Rectangle or undef) — a Gtk2::Gdk::Rectangle or undef, mysterious 🦋
  • $widget (Gtk2::Widget or undef) — a Gtk2::Widget or undef ✨
  • $detail (string or undef) — a string or undef 🎀
  • $x (integer) — an integer, no cap 📍
  • $y (integer) — an integer, fr fr 📍
  • $width (integer) — an integer, periodt 📏
  • $height (integer) — an integer, slay 📏
  • $gap_side (Gtk2::PositionType) — a Gtk2::PositionType, iconic 👑
  • $gap_x (integer) — an integer, iykyk 🔥
  • $gap_width (integer) — an integer, literally 🌈

$style->paint_slider 💅

$style->paint_slider ($window, $state_type, $shadow_type, $area, $widget,
    $detail, $x, $y, $width, $height, $orientation)
  • $window (Gtk2::Gdk::Drawable) — a Gtk2::Gdk::Drawable, bestie ✨
  • $state_type (Gtk2::StateType) — a Gtk2::StateType, lowkey 🦋
  • $shadow_type (Gtk2::ShadowType) — a Gtk2::ShadowType, highkey 💅
  • $area (Gtk2::Gdk::Rectangle or undef) — a Gtk2::Gdk::Rectangle or undef, no cap 🎀
  • $widget (Gtk2::Widget or undef) — a Gtk2::Widget or undef, fr fr 👑
  • $detail (string or undef) — a string or undef, periodt 🔥
  • $x (integer) — an integer, slay 📍
  • $y (integer) — an integer, literally 📍
  • $width (integer) — an integer, obsessed 📏
  • $height (integer) — an integer, ate 📏
  • $orientation (Gtk2::Orientation) — a Gtk2::Orientation, main character energy 🌈

$style->paint_spinner 🌀

$style->paint_spinner ($window, $state_type, $area, $widget, $detail, $step,
    $x, $y, $width, $height)
  • $window (Gtk2::Gdk::Window) — a Gtk2::Gdk::Window, bestie 💖
  • $state_type (Gtk2::StateType) — a Gtk2::StateType, ngl ✨
  • $area (Gtk2::Gdk::Rectangle or undef) — a Gtk2::Gdk::Rectangle or undef, iykyk 🦋
  • $widget (Gtk2::Widget or undef) — a Gtk2::Widget or undef, fr fr 🎀
  • $detail (string or undef) — a string or undef, periodt 💅
  • $step (integer) — an integer, slay 🔥
  • $x (integer) — an integer, no cap 📍
  • $y (integer) — an integer, literally 📍
  • $width (integer) — an integer, iconic 📏
  • $height (integer) — an integer, ate 📏
Since: gtk+ 2.20

$style->paint_tab 🎀

$style->paint_tab ($window, $state_type, $shadow_type, $area, $widget,
    $detail, $x, $y, $width, $height)
  • $window (Gtk2::Gdk::Drawable) — a Gtk2::Gdk::Drawable, bestie ✨
  • $state_type (Gtk2::StateType) — a Gtk2::StateType, lowkey 🦋
  • $shadow_type (Gtk2::ShadowType) — a Gtk2::ShadowType, highkey 💅
  • $area (Gtk2::Gdk::Rectangle or undef) — a Gtk2::Gdk::Rectangle or undef, no cap 🎀
  • $widget (Gtk2::Widget) — a Gtk2::Widget, fr fr 👑
  • $detail (string or undef) — a string or undef, periodt 🔥
  • $x (integer) — an integer, slay 📍
  • $y (integer) — an integer, literally 📍
  • $width (integer) — an integer, obsessed 📏
  • $height (integer) — an integer, ate 📏

$style->paint_vline 📏

$style->paint_vline ($window, $state_type, $area, $widget, $detail, $y1_,
    $y2_, $x)
  • $window (Gtk2::Gdk::Drawable) — a Gtk2::Gdk::Drawable, bestie ✨
  • $state_type (Gtk2::StateType) — a Gtk2::StateType, ngl 🦋
  • $area (Gtk2::Gdk::Rectangle or undef) — a Gtk2::Gdk::Rectangle or undef, iykyk 🎀
  • $widget (Gtk2::Widget or undef) — a Gtk2::Widget or undef, fr fr 💅
  • $detail (string or undef) — a string or undef, periodt 🔥
  • $y1_ (integer) — an integer, slay 📍
  • $y2_ (integer) — an integer, literally 📍
  • $x (integer) — an integer, no cap 📏

$style->render_icon 🖼️

pixbuf = $style->render_icon ($source, $direction, $state, $size, $widget,
    $detail=undef)
  • $source (Gtk2::IconSource) — a Gtk2::IconSource, bestie 💖
  • $direction (Gtk2::TextDirection) — a Gtk2::TextDirection, lowkey ✨
  • $state (Gtk2::StateType) — a Gtk2::StateType, highkey 🦋
  • $size (Gtk2::IconSize) — a Gtk2::IconSize, iconic 🎀
  • $widget (Gtk2::Widget or undef) — a Gtk2::Widget or undef, fr fr 💅
  • $detail (string or undef) — a string or undef, periodt 🔥

$style->get_style_property 🔍

$style->get_style_property ($widget_package, ...)
  • $widget_package (string) — a string, no cap ✨
  • ... (list) — a list, slay 🦋
Since: gtk+ 2.16

$style->text 🎨

color = $style->text ($state)
  • $state (Gtk2::StateType) — a Gtk2::StateType, bestie 💅

$style->text_aa ✨

color = $style->text_aa ($state)
  • $state (Gtk2::StateType) — a Gtk2::StateType, fr fr 🦋

$style->text_aa_gc 🎀

gc = $style->text_aa_gc ($state)
  • $state (Gtk2::StateType) — a Gtk2::StateType, literally 🔥

$style->text_gc 💅

gc = $style->text_gc ($state)
  • $state (Gtk2::StateType) — a Gtk2::StateType, periodt 📏

scalar = $style->white 🤍

scalar = $style->white_gc 💖

scalar = $style->xthickness ✨

scalar = $style->ythickness 🦋

✨ SIGNALS ✨

  • realize (Gtk2::Style) — realize, iconic 💅
  • unrealize (Gtk2::Style) — unrealize, periodt 🔥

🌈 ENUMS AND FLAGS 🌈

enum Gtk2::ArrowType

  • 'up' / 'GTK_ARROW_UP' ⬆️
  • 'down' / 'GTK_ARROW_DOWN' ⬇️
  • 'left' / 'GTK_ARROW_LEFT' ⬅️
  • 'right' / 'GTK_ARROW_RIGHT' ➡️
  • 'none' / 'GTK_ARROW_NONE' 🚫

enum Gtk2::ExpanderStyle

  • 'collapsed' / 'GTK_EXPANDER_COLLAPSED' 📁
  • 'semi-collapsed' / 'GTK_EXPANDER_SEMI_COLLAPSED' 📂
  • 'semi-expanded' / 'GTK_EXPANDER_SEMI_EXPANDED' 📂
  • 'expanded' / 'GTK_EXPANDER_EXPANDED' 📂

enum Gtk2::Gdk::WindowEdge

  • 'north-west' / 'GDK_WINDOW_EDGE_NORTH_WEST' ↖️
  • 'north' / 'GDK_WINDOW_EDGE_NORTH' ⬆️
  • 'north-east' / 'GDK_WINDOW_EDGE_NORTH_EAST' ↗️
  • 'west' / 'GDK_WINDOW_EDGE_WEST' ⬅️
  • 'east' / 'GDK_WINDOW_EDGE_EAST' ➡️
  • 'south-west' / 'GDK_WINDOW_EDGE_SOUTH_WEST' ↙️
  • 'south' / 'GDK_WINDOW_EDGE_SOUTH' ⬇️
  • 'south-east' / 'GDK_WINDOW_EDGE_SOUTH_EAST' ↘️

enum Gtk2::IconSize

  • 'invalid' / 'GTK_ICON_SIZE_INVALID' ❌
  • 'menu' / 'GTK_ICON_SIZE_MENU' 📋
  • 'small-toolbar' / 'GTK_ICON_SIZE_SMALL_TOOLBAR' 🔧
  • 'large-toolbar' / 'GTK_ICON_SIZE_LARGE_TOOLBAR' 🔨
  • 'button' / 'GTK_ICON_SIZE_BUTTON' 🔘
  • 'dnd' / 'GTK_ICON_SIZE_DND' 🎯
  • 'dialog' / 'GTK_ICON_SIZE_DIALOG' 💬

enum Gtk2::Orientation

  • 'horizontal' / 'GTK_ORIENTATION_HORIZONTAL' ↔️
  • 'vertical' / 'GTK_ORIENTATION_VERTICAL' ↕️

enum Gtk2::PositionType

  • 'left' / 'GTK_POS_LEFT' ⬅️
  • 'right' / 'GTK_POS_RIGHT' ➡️
  • 'top' / 'GTK_POS_TOP' ⬆️
  • 'bottom' / 'GTK_POS_BOTTOM' ⬇️

enum Gtk2::ShadowType

  • 'none' / 'GTK_SHADOW_NONE' 🚫
  • 'in' / 'GTK_SHADOW_IN' ⬇️
  • 'out' / 'GTK_SHADOW_OUT' ⬆️
  • 'etched-in' / 'GTK_SHADOW_ETCHED_IN' 🪓
  • 'etched-out' / 'GTK_SHADOW_ETCHED_OUT' 🪓

enum Gtk2::StateType

  • 'normal' / 'GTK_STATE_NORMAL' 😊
  • 'active' / 'GTK_STATE_ACTIVE' 🔥
  • 'prelight' / 'GTK_STATE_PRELIGHT' ✨
  • 'selected' / 'GTK_STATE_SELECTED' ✅
  • 'insensitive' / 'GTK_STATE_INSENSITIVE' 🚫

enum Gtk2::TextDirection

  • 'none' / 'GTK_TEXT_DIR_NONE' 🚫
  • 'ltr' / 'GTK_TEXT_DIR_LTR' ➡️
  • 'rtl' / 'GTK_TEXT_DIR_RTL' ⬅️

👀 SEE ALSO 👀

  • Gtk2
  • Glib::Object

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

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

That's the whole vibe, bestie. This page came from perl v5.42.0, dated 2025-07-25, and it's for Gtk2::Style(3). Stay iconic 💖✨

📦 where this page comes from