Gtk2HsContentsIndex
Graphics.UI.Gtk.General.Style
Description

Customization of widgets.

  • 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 widgetGetState).
  • When creating complicated objects in DrawingArea the predefined graphics contexts and the single font in the canvas might not be enough to customize the rendering process. gtk_rc_get_style_by_paths is the solution for this.

TODO

  • It seems sensible to treat Styles as read only. The only way to modify a style should be for the programmer to apply the RcStyle patches directly to the widget.
  • Bind the draw... functions, they might be useful.
Synopsis
data Style
class GObjectClass o => StyleClass o
styleGetForeground :: StateType -> Style -> IO GC
styleGetBackground :: StateType -> Style -> IO GC
styleGetLight :: StateType -> Style -> IO GC
styleGetMiddle :: StateType -> Style -> IO GC
styleGetDark :: StateType -> Style -> IO GC
styleGetText :: StateType -> Style -> IO GC
styleGetBase :: StateType -> Style -> IO GC
styleGetAntiAliasing :: StateType -> Style -> IO GC
Documentation
data Style
Instances
StyleClass Style
GObjectClass Style
class GObjectClass o => StyleClass o
Instances
StyleClass Style
styleGetForeground :: StateType -> Style -> IO GC

Retrieve the GC for the foreground color.

  • The parameter state determines for which widget state (one of StateType) the GC should be recieved. Use widgetGetState to determine the current state of the widget.
styleGetBackground :: StateType -> Style -> IO GC

Retrieve the GC for the background color.

  • The parameter state determines for which widget state (one of StateType) the GC should be recieved. Use widgetGetState to determine the current state of the widget.
styleGetLight :: StateType -> Style -> IO GC

Retrieve the GC for a light color.

  • The parameter state determines for which widget state (one of StateType) the GC should be recieved. Use widgetGetState to determine the current state of the widget.
styleGetMiddle :: StateType -> Style -> IO GC

Retrieve the GC for a middle color.

  • The parameter state determines for which widget state (one of StateType) the GC should be recieved. Use widgetGetState to determine the current state of the widget.
styleGetDark :: StateType -> Style -> IO GC

Retrieve the GC for a dark color.

  • The parameter state determines for which widget state (one of StateType) the GC should be recieved. Use widgetGetState to determine the current state of the widget.
styleGetText :: StateType -> Style -> IO GC

Retrieve the GC for the text color.

  • The parameter state determines for which widget state (one of StateType) the GC should be recieved. Use widgetGetState to determine the current state of the widget.
styleGetBase :: StateType -> Style -> IO GC

Retrieve the GC for 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 GC should be recieved. Use widgetGetState to determine the current state of the widget.
styleGetAntiAliasing :: StateType -> Style -> IO GC

Retrieve the GC 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 GC should be recieved. Use widgetGetState to determine the current state of the widget.
Produced by Haddock version 0.6