gtk-0.12.0: Binding to the Gtk+ graphical user interface library.

Portability | portable (depends on GHC)
Stability | provisional
Maintainer | gtk2hs-users@lists.sourceforge.net

Graphics.UI.Gtk.General.Style

Contents

- Description
- Types
- Methods

Description

Customization of widgets.

Synopsis

- data Style
- class GObjectClass o => StyleClass o
- castToStyle :: GObjectClass obj => obj -> Style
- gTypeStyle :: GType
- toStyle :: StyleClass o => o -> Style
- styleGetForeground :: Style -> StateType -> IO Color
- styleGetBackground :: Style -> StateType -> IO Color
- styleGetLight :: Style -> StateType -> IO Color
- styleGetMiddle :: Style -> StateType -> IO Color
- styleGetDark :: Style -> StateType -> IO Color
- styleGetText :: Style -> StateType -> IO Color
- styleGetBase :: Style -> StateType -> IO Color
- styleGetAntiAliasing :: Style -> StateType -> IO Color

# Description

Styles are attached to widgets and determine how particular parts are drawn and with what color. Thus they are should be seen as mandatory when one implements a new custom widgets via `DrawingArea`. Although the parameterized drawing function don't have to be used, it is strongly advisable (and more robust) to make use of the predefined graphics contexts for the different states of a widget (retrieved by `Graphics.UI.Gtk.Abstract.Widget.widgetGetState`).

# Types

data Style

Instances

Eq Style |
Ord Style |
GObjectClass Style |
StyleClass Style |

class GObjectClass o => StyleClass o

Instances

StyleClass Style |

castToStyle :: GObjectClass obj => obj -> Style

gTypeStyle :: GType

toStyle :: StyleClass o => o -> Style

# Methods

styleGetForeground :: Style -> StateType -> IO Color

Retrieve the the foreground color.

- The parameter `state` determines for which widget state (one of `StateType`) the `Color` should be retrieved. Use `widgetGetState` to determine the current state of the widget.

styleGetBackground :: Style -> StateType -> IO Color

Retrieve the background color.

- The parameter `state` determines for which widget state (one of `StateType`) the `Color` should be retrieved. Use `widgetGetState` to determine the current state of the widget.

styleGetLight :: Style -> StateType -> IO Color

Retrieve a light color.

- The parameter `state` determines for which widget state (one of `StateType`) the `Color` should be retrieved. Use `widgetGetState` to determine the current state of the widget.

styleGetMiddle :: Style -> StateType -> IO Color

Retrieve a middle color.

- The parameter `state` determines for which widget state (one of `StateType`) the `Color` should be retrieved. Use `widgetGetState` to determine the current state of the widget.

styleGetDark :: Style -> StateType -> IO Color

Retrieve a dark color.

- The parameter `state` determines for which widget state (one of `StateType`) the `Color` should be retrieved. Use `widgetGetState` to determine the current state of the widget.

styleGetText :: Style -> StateType -> IO Color

Retrieve the text color.

- The parameter `state` determines for which widget state (one of `StateType`) the `Color` should be retrieved. Use `widgetGetState` to determine the current state of the widget.

styleGetBase :: Style -> StateType -> IO Color

Retrieve the base color.

- The base color is the standard text background of a widget.
- The parameter `state` determines for which widget state (one of `StateType`) the `Color` should be retrieved. Use `widgetGetState` to determine the current state of the widget.

styleGetAntiAliasing :: Style -> StateType -> IO Color

Retrieve the color for drawing anti-aliased text.

- The anti-aliasing color is the color which is used when the rendering of a character does not make it clear if a certain pixel shoud be set or not. This color is between the text and the base color.
- The parameter `state` determines for which widget state (one of `StateType`) the `Color` should be retrieved. Use `widgetGetState` to determine the current state of the widget.