GI.Gtk.Objects.Style

A Style object encapsulates the information that provides the look and feel for a widget.

In GTK+ 3.0, GtkStyle has been deprecated and replaced by
'GI.Gtk.Objects.StyleContext.StyleContext'.

Each Widget has an associated Style object that is used when rendering that widget. Also, a Style holds information for the five possible widget states though not every widget supports all five states; see StateType.

Usually the Style for a widget is the same as the default style that is set by GTK+ and modified the theme engine.

Usually applications should not need to use or modify the Style of their widgets.

Exported types

newtype Style

Constructors

Style (ManagedPtr Style)

Instances

GObject Style

Methods

gobjectType :: Style -> IO GType

IsObject Style

IsStyle Style

((~) * info (ResolveStyleMethod t Style), MethodInfo * info Style p) => IsLabel t (Style -> p)

Methods

fromLabel :: Proxy# Symbol t -> Style -> p

((~) * info (ResolveStyleMethod t Style), MethodInfo * info Style p) => IsLabelProxy t (Style -> p)

Methods

fromLabelProxy :: Proxy Symbol t -> Style -> p

HasAttributeList * Style

type AttributeList Style

type AttributeList Style

type SignalList Style

type SignalList Style

class GObject o => IsStyle o

Instances

(GObject a, UnknownAncestorError Constraint Style a) => IsStyle a

IsStyle Style

toStyle :: IsStyle o => o -> IO Style

noStyle :: Maybe Style

Methods

applyDefaultBackground

data StyleApplyDefaultBackgroundMethodInfo

Instances

((~) * signature (Context -> b -> StateType -> Int32 -> Int32 -> Int32 -> Int32 -> m ()), MonadIO m, IsStyle a, IsWindow b) => MethodInfo * StyleApplyDefaultBackgroundMethodInfo a signature

Methods

overloadedMethod :: MethodProxy StyleApplyDefaultBackgroundMethodInfo a -> signature -> s

styleApplyDefaultBackground :: (HasCallStack, MonadIO m, IsStyle a, IsWindow b) => a -> Context -> b -> StateType -> Int32 -> Int32 -> Int32 -> Int32 -> m ()

Deprecated: (Since version 3.0)Use StyleContext instead

No description available in the introspection data.

copy

data StyleCopyMethodInfo

Instances

((~) * signature (m Style), MonadIO m, IsStyle a) => MethodInfo * StyleCopyMethodInfo a signature

Methods

overloadedMethod :: MethodProxy StyleCopyMethodInfo a -> signature -> s

styleCopy

Arguments

:: (HasCallStack, MonadIO m, IsStyle a)

=> a

style: a Style

-> m Style

Returns: a copy of style

Deprecated: (Since version 3.0)Use StyleContext instead

Creates a copy of the passed in Style object.

detach

data StyleDetachMethodInfo

Instances

((~) * signature (m ()), MonadIO m, IsStyle a) => MethodInfo * StyleDetachMethodInfo a signature

Methods

overloadedMethod :: MethodProxy StyleDetachMethodInfo a -> signature -> s

styleDetach

Arguments

:: (HasCallStack, MonadIO m, IsStyle a)

=> a

style: a Style

-> m ()

Deprecated: (Since version 3.0)Use StyleContext instead

Detaches a style from a window. If the style is not attached to any windows anymore, it is unrealized. See gtk_style_attach().

getStyleProperty

data StyleGetStylePropertyMethodInfo

Instances

((~) * signature (GType -> Text -> m GValue), MonadIO m, IsStyle a) => MethodInfo * StyleGetStylePropertyMethodInfo a signature

Methods

overloadedMethod :: MethodProxy StyleGetStylePropertyMethodInfo a -> signature -> s

styleGetStyleProperty

Arguments

:: (HasCallStack, MonadIO m, IsStyle a)

=> a

style: a Style

-> GType

widgetType: the GType of a descendant of Widget

-> Text

propertyName: the name of the style property to get

-> m GValue

Queries the value of a style property corresponding to a widget class is in the given style.

Since: 2.16

hasContext

data StyleHasContextMethodInfo

Instances

((~) * signature (m Bool), MonadIO m, IsStyle a) => MethodInfo * StyleHasContextMethodInfo a signature

Methods

overloadedMethod :: MethodProxy StyleHasContextMethodInfo a -> signature -> s

styleHasContext

Arguments

:: (HasCallStack, MonadIO m, IsStyle a)

=> a

style: a Style

-> m Bool

Returns: True if style has a StyleContext

Returns whether style has an associated StyleContext.

Since: 3.0

lookupColor

data StyleLookupColorMethodInfo

Instances

((~) * signature (Text -> m (Bool, Color)), MonadIO m, IsStyle a) => MethodInfo * StyleLookupColorMethodInfo a signature

Methods

overloadedMethod :: MethodProxy StyleLookupColorMethodInfo a -> signature -> s

styleLookupColor

Arguments

:: (HasCallStack, MonadIO m, IsStyle a)

=> a

style: a Style

-> Text

colorName: the name of the logical color to look up

-> m (Bool, Color)

Returns: True if the mapping was found.

Deprecated: (Since version 3.0)Use styleContextLookupColor instead

Looks up colorName in the style’s logical color mappings, filling in color and returning True if found, otherwise returning False. Do not cache the found mapping, because it depends on the Style and might change when a theme switch occurs.

Since: 2.10

lookupIconSet

data StyleLookupIconSetMethodInfo

Instances

((~) * signature (Text -> m IconSet), MonadIO m, IsStyle a) => MethodInfo * StyleLookupIconSetMethodInfo a signature

Methods

overloadedMethod :: MethodProxy StyleLookupIconSetMethodInfo a -> signature -> s

styleLookupIconSet

Arguments

:: (HasCallStack, MonadIO m, IsStyle a)

=> a

style: a Style

-> Text

stockId: an icon name

-> m IconSet

Returns: icon set of stockId

Deprecated: (Since version 3.0)Use styleContextLookupIconSet instead

Looks up stockId in the icon factories associated with style and the default icon factory, returning an icon set if found, otherwise Nothing.

new

styleNew

Arguments

:: (HasCallStack, MonadIO m)

=> m Style

Returns: a new Style.

Deprecated: (Since version 3.0)Use StyleContext

Creates a new Style.

renderIcon

data StyleRenderIconMethodInfo

Instances

((~) * signature (IconSource -> TextDirection -> StateType -> Int32 -> Maybe b -> Maybe Text -> m Pixbuf), MonadIO m, IsStyle a, IsWidget b) => MethodInfo * StyleRenderIconMethodInfo a signature

Methods

overloadedMethod :: MethodProxy StyleRenderIconMethodInfo a -> signature -> s

styleRenderIcon

Arguments

:: (HasCallStack, MonadIO m, IsStyle a, IsWidget b)

=> a

style: a Style

-> IconSource

source: the IconSource specifying the icon to render

-> TextDirection

direction: a text direction

-> StateType

state: a state

-> Int32

size: the size to render the icon at (IconSize). A size of (GtkIconSize)-1 means render at the size of the source and don’t scale.

-> Maybe b

widget: the widget

-> Maybe Text

detail: a style detail

-> m Pixbuf

Returns: a newly-created Pixbuf containing the rendered icon

Deprecated: (Since version 3.0)Use renderIconPixbuf instead

Renders the icon specified by source at the given size according to the given parameters and returns the result in a pixbuf.

setBackground

data StyleSetBackgroundMethodInfo

Instances

((~) * signature (b -> StateType -> m ()), MonadIO m, IsStyle a, IsWindow b) => MethodInfo * StyleSetBackgroundMethodInfo a signature

Methods

overloadedMethod :: MethodProxy StyleSetBackgroundMethodInfo a -> signature -> s

styleSetBackground

Arguments

:: (HasCallStack, MonadIO m, IsStyle a, IsWindow b)

=> a

style: a Style

-> b

window: a Window

-> StateType

stateType: a state

-> m ()

Deprecated: (Since version 3.0)Use styleContextSetBackground instead

Sets the background of window to the background color or pixmap specified by style for the given state.

Properties

context

data StyleContextPropertyInfo

Instances

AttrInfo StyleContextPropertyInfo

Associated Types

type AttrAllowedOps StyleContextPropertyInfo :: [AttrOpTag]

type AttrSetTypeConstraint StyleContextPropertyInfo :: * -> Constraint

type AttrBaseTypeConstraint StyleContextPropertyInfo :: * -> Constraint

type AttrGetType StyleContextPropertyInfo :: *

type AttrLabel StyleContextPropertyInfo :: Symbol

type AttrOrigin StyleContextPropertyInfo :: *

Methods

attrGet :: AttrBaseTypeConstraint StyleContextPropertyInfo o => Proxy * StyleContextPropertyInfo -> o -> IO (AttrGetType StyleContextPropertyInfo)

attrSet :: (AttrBaseTypeConstraint StyleContextPropertyInfo o, AttrSetTypeConstraint StyleContextPropertyInfo b) => Proxy * StyleContextPropertyInfo -> o -> b -> IO ()

attrClear :: AttrBaseTypeConstraint StyleContextPropertyInfo o => Proxy * StyleContextPropertyInfo -> o -> IO ()

attrConstruct :: (AttrBaseTypeConstraint StyleContextPropertyInfo o, AttrSetTypeConstraint StyleContextPropertyInfo b) => Proxy * StyleContextPropertyInfo -> b -> IO (GValueConstruct o)

type AttrOrigin StyleContextPropertyInfo

type AttrOrigin StyleContextPropertyInfo = Style

type AttrLabel StyleContextPropertyInfo

type AttrLabel StyleContextPropertyInfo = "context"

type AttrGetType StyleContextPropertyInfo

type AttrGetType StyleContextPropertyInfo = Maybe StyleContext

type AttrBaseTypeConstraint StyleContextPropertyInfo

type AttrBaseTypeConstraint StyleContextPropertyInfo = IsStyle

type AttrSetTypeConstraint StyleContextPropertyInfo

type AttrSetTypeConstraint StyleContextPropertyInfo = IsStyleContext

type AttrAllowedOps StyleContextPropertyInfo

type AttrAllowedOps StyleContextPropertyInfo = (:) AttrOpTag AttrConstruct ((:) AttrOpTag AttrGet ((:) AttrOpTag AttrClear ([] AttrOpTag)))

constructStyleContext :: (IsStyle o, IsStyleContext a) => a -> IO (GValueConstruct o)

getStyleContext :: (MonadIO m, IsStyle o) => o -> m (Maybe StyleContext)

styleContext :: AttrLabelProxy "context"

Signals

realize

type C_StyleRealizeCallback = Ptr () -> Ptr () -> IO ()

type StyleRealizeCallback = IO ()

data StyleRealizeSignalInfo

Instances

SignalInfo StyleRealizeSignalInfo

Associated Types

type HaskellCallbackType StyleRealizeSignalInfo :: *

Methods

connectSignal :: GObject o => SignalProxy o StyleRealizeSignalInfo -> o -> HaskellCallbackType StyleRealizeSignalInfo -> SignalConnectMode -> IO SignalHandlerId

type HaskellCallbackType StyleRealizeSignalInfo

type HaskellCallbackType StyleRealizeSignalInfo = StyleRealizeCallback

afterStyleRealize :: (GObject a, MonadIO m) => a -> StyleRealizeCallback -> m SignalHandlerId

genClosure_StyleRealize :: StyleRealizeCallback -> IO Closure

mk_StyleRealizeCallback :: C_StyleRealizeCallback -> IO (FunPtr C_StyleRealizeCallback)

noStyleRealizeCallback :: Maybe StyleRealizeCallback

onStyleRealize :: (GObject a, MonadIO m) => a -> StyleRealizeCallback -> m SignalHandlerId

wrap_StyleRealizeCallback :: StyleRealizeCallback -> Ptr () -> Ptr () -> IO ()

unrealize

type C_StyleUnrealizeCallback = Ptr () -> Ptr () -> IO ()

type StyleUnrealizeCallback = IO ()

data StyleUnrealizeSignalInfo

Instances

SignalInfo StyleUnrealizeSignalInfo

Associated Types

type HaskellCallbackType StyleUnrealizeSignalInfo :: *

Methods

connectSignal :: GObject o => SignalProxy o StyleUnrealizeSignalInfo -> o -> HaskellCallbackType StyleUnrealizeSignalInfo -> SignalConnectMode -> IO SignalHandlerId

type HaskellCallbackType StyleUnrealizeSignalInfo

type HaskellCallbackType StyleUnrealizeSignalInfo = StyleUnrealizeCallback

afterStyleUnrealize :: (GObject a, MonadIO m) => a -> StyleUnrealizeCallback -> m SignalHandlerId

genClosure_StyleUnrealize :: StyleUnrealizeCallback -> IO Closure

mk_StyleUnrealizeCallback :: C_StyleUnrealizeCallback -> IO (FunPtr C_StyleUnrealizeCallback)

noStyleUnrealizeCallback :: Maybe StyleUnrealizeCallback

onStyleUnrealize :: (GObject a, MonadIO m) => a -> StyleUnrealizeCallback -> m SignalHandlerId

wrap_StyleUnrealizeCallback :: StyleUnrealizeCallback -> Ptr () -> Ptr () -> IO ()