This site has been retired. For up to date information, see handbook.gnome.org or gitlab.gnome.org.


[Home] [TitleIndex] [WordIndex

1. Overview

screenshot.png

2. Style Properties

Name

Default

Description

indicator-size

13

Size of check or radio indicator

indicator-spacing

2

Spacing around check or radio indicator

3. Geometry

With exterior focus (or no [visible] child):

geometry.png

With interior focus:

geometry-interior.png

4. Drawing

The focus is drawn with a detail of checkbutton. The check is drawin with the gtk_paint_check function, detail is checkbutton. The shadow for the check depends on whether the checkbox is checked, etc.

shadow

OUT

not checked

IN

checked

ETCHED_IN

inconsistent state, if it is neither on nor off

When the checkbox prelights, it additionally draws a flat box with detail checkbutton and shadow ETCHED_IN. (XXX: It looks to me like you can only draw solid colors in here, because it only draws the reexposed area, so if you get a partial expose then things might break.)

4.1. Button Look

Note that an application may disable the check and get a widget that looks like a toggle button. This is rather annoying for themes if they want to change the text colour for buttons, but not for check buttons. (I have yet to see an application that uses this though.)

5. GTK+ API Documentation

http://library.gnome.org/devel/gtk/stable/GtkCheckButton.html


2024-10-23 10:58