Copyright | Will Thompson Iñaki García Etxebarria and Jonas Platte |
---|---|
License | LGPL-2.1 |
Maintainer | Iñaki García Etxebarria |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
StyleContext
is an object that stores styling information affecting
a widget.
In order to construct the final style information, StyleContext
queries information from all attached GtkStyleProviders
. Style providers
can be either attached explicitly to the context through
styleContextAddProvider
, or to the display through
styleContextAddProviderForDisplay
. The resulting style is a
combination of all providers’ information in priority order.
For GTK widgets, any StyleContext
returned by
widgetGetStyleContext
will already have a Display
and
RTL/LTR information set. The style context will also be updated
automatically if any of these settings change on the widget.
# Style Classes # {gtkstylecontext
-classes}
Widgets can add style classes to their context, which can be used to associate different styles by class. The documentation for individual widgets lists which style classes it uses itself, and which style classes may be added by applications to affect their appearance.
GTK defines macros for a number of style classes.
Custom styling in UI libraries and applications
If you are developing a library with custom GtkWidgets
that
render differently than standard components, you may need to add a
StyleProvider
yourself with the STYLE_PROVIDER_PRIORITY_FALLBACK
priority, either a CssProvider
or a custom object implementing the
StyleProvider
interface. This way themes may still attempt
to style your UI elements in a different way if needed so.
If you are using custom styling on an applications, you probably want then
to make your style information prevail to the theme’s, so you must use
a StyleProvider
with the STYLE_PROVIDER_PRIORITY_APPLICATION
priority, keep in mind that the user settings in
XDG_CONFIG_HOME/gtk-4.0/gtk.css
will
still take precedence over your changes, as it uses the
STYLE_PROVIDER_PRIORITY_USER
priority.
Synopsis
- newtype StyleContext = StyleContext (ManagedPtr StyleContext)
- class (GObject o, IsDescendantOf StyleContext o) => IsStyleContext o
- toStyleContext :: (MonadIO m, IsStyleContext o) => o -> m StyleContext
- styleContextAddClass :: (HasCallStack, MonadIO m, IsStyleContext a) => a -> Text -> m ()
- styleContextAddProvider :: (HasCallStack, MonadIO m, IsStyleContext a, IsStyleProvider b) => a -> b -> Word32 -> m ()
- styleContextAddProviderForDisplay :: (HasCallStack, MonadIO m, IsDisplay a, IsStyleProvider b) => a -> b -> Word32 -> m ()
- styleContextGetBorder :: (HasCallStack, MonadIO m, IsStyleContext a) => a -> m Border
- styleContextGetColor :: (HasCallStack, MonadIO m, IsStyleContext a) => a -> m RGBA
- styleContextGetDisplay :: (HasCallStack, MonadIO m, IsStyleContext a) => a -> m Display
- styleContextGetMargin :: (HasCallStack, MonadIO m, IsStyleContext a) => a -> m Border
- styleContextGetPadding :: (HasCallStack, MonadIO m, IsStyleContext a) => a -> m Border
- styleContextGetScale :: (HasCallStack, MonadIO m, IsStyleContext a) => a -> m Int32
- styleContextGetState :: (HasCallStack, MonadIO m, IsStyleContext a) => a -> m [StateFlags]
- styleContextHasClass :: (HasCallStack, MonadIO m, IsStyleContext a) => a -> Text -> m Bool
- styleContextLookupColor :: (HasCallStack, MonadIO m, IsStyleContext a) => a -> Text -> m (Bool, RGBA)
- styleContextRemoveClass :: (HasCallStack, MonadIO m, IsStyleContext a) => a -> Text -> m ()
- styleContextRemoveProvider :: (HasCallStack, MonadIO m, IsStyleContext a, IsStyleProvider b) => a -> b -> m ()
- styleContextRemoveProviderForDisplay :: (HasCallStack, MonadIO m, IsDisplay a, IsStyleProvider b) => a -> b -> m ()
- styleContextRestore :: (HasCallStack, MonadIO m, IsStyleContext a) => a -> m ()
- styleContextSave :: (HasCallStack, MonadIO m, IsStyleContext a) => a -> m ()
- styleContextSetDisplay :: (HasCallStack, MonadIO m, IsStyleContext a, IsDisplay b) => a -> b -> m ()
- styleContextSetScale :: (HasCallStack, MonadIO m, IsStyleContext a) => a -> Int32 -> m ()
- styleContextSetState :: (HasCallStack, MonadIO m, IsStyleContext a) => a -> [StateFlags] -> m ()
- styleContextToString :: (HasCallStack, MonadIO m, IsStyleContext a) => a -> [StyleContextPrintFlags] -> m Text
- constructStyleContextDisplay :: (IsStyleContext o, MonadIO m, IsDisplay a) => a -> m (GValueConstruct o)
- getStyleContextDisplay :: (MonadIO m, IsStyleContext o) => o -> m Display
- setStyleContextDisplay :: (MonadIO m, IsStyleContext o, IsDisplay a) => o -> a -> m ()
Exported types
newtype StyleContext Source #
Memory-managed wrapper type.
StyleContext (ManagedPtr StyleContext) |
Instances
Eq StyleContext Source # | |
Defined in GI.Gtk.Objects.StyleContext (==) :: StyleContext -> StyleContext -> Bool # (/=) :: StyleContext -> StyleContext -> Bool # | |
GObject StyleContext Source # | |
Defined in GI.Gtk.Objects.StyleContext | |
ManagedPtrNewtype StyleContext Source # | |
Defined in GI.Gtk.Objects.StyleContext toManagedPtr :: StyleContext -> ManagedPtr StyleContext | |
TypedObject StyleContext Source # | |
Defined in GI.Gtk.Objects.StyleContext | |
HasParentTypes StyleContext Source # | |
Defined in GI.Gtk.Objects.StyleContext | |
IsGValue (Maybe StyleContext) Source # | Convert |
Defined in GI.Gtk.Objects.StyleContext gvalueGType_ :: IO GType gvalueSet_ :: Ptr GValue -> Maybe StyleContext -> IO () gvalueGet_ :: Ptr GValue -> IO (Maybe StyleContext) | |
type ParentTypes StyleContext Source # | |
Defined in GI.Gtk.Objects.StyleContext |
class (GObject o, IsDescendantOf StyleContext o) => IsStyleContext o Source #
Type class for types which can be safely cast to StyleContext
, for instance with toStyleContext
.
Instances
(GObject o, IsDescendantOf StyleContext o) => IsStyleContext o Source # | |
Defined in GI.Gtk.Objects.StyleContext |
toStyleContext :: (MonadIO m, IsStyleContext o) => o -> m StyleContext Source #
Cast to StyleContext
, for types for which this is known to be safe. For general casts, use castTo
.
Methods
Click to display all available methods, including inherited ones
Methods
addClass, addProvider, bindProperty, bindPropertyFull, forceFloating, freezeNotify, getv, hasClass, isFloating, lookupColor, notify, notifyByPspec, ref, refSink, removeClass, removeProvider, restore, runDispose, save, stealData, stealQdata, thawNotify, toString, unref, watchClosure.
Getters
getBorder, getColor, getData, getDisplay, getMargin, getPadding, getProperty, getQdata, getScale, getState.
Setters
setData, setDataFull, setDisplay, setProperty, setScale, setState.
addClass
:: (HasCallStack, MonadIO m, IsStyleContext a) | |
=> a |
|
-> Text |
|
-> m () |
Adds a style class to context
, so later uses of the
style context will make use of this new class for styling.
In the CSS file format, a Entry
defining a “search”
class, would be matched by:
<!-- language="CSS" --> entry.search { ... }
While any widget defining a “search” class would be matched by: > language="CSS" -- >.search { ... }
addProvider
styleContextAddProvider Source #
:: (HasCallStack, MonadIO m, IsStyleContext a, IsStyleProvider b) | |
=> a |
|
-> b |
|
-> Word32 |
|
-> m () |
Adds a style provider to context
, to be used in style construction.
Note that a style provider added by this function only affects
the style of the widget to which context
belongs. If you want
to affect the style of all widgets, use
styleContextAddProviderForDisplay
.
Note: If both priorities are the same, a StyleProvider
added through this function takes precedence over another added
through styleContextAddProviderForDisplay
.
addProviderForDisplay
styleContextAddProviderForDisplay Source #
:: (HasCallStack, MonadIO m, IsDisplay a, IsStyleProvider b) | |
=> a |
|
-> b |
|
-> Word32 |
|
-> m () |
Adds a global style provider to display
, which will be used
in style construction for all GtkStyleContexts
under display
.
GTK uses this to make styling information from Settings
available.
Note: If both priorities are the same, A StyleProvider
added through styleContextAddProvider
takes precedence
over another added through this function.
getBorder
styleContextGetBorder Source #
:: (HasCallStack, MonadIO m, IsStyleContext a) | |
=> a |
|
-> m Border |
Gets the border for a given state as a Border
.
getColor
:: (HasCallStack, MonadIO m, IsStyleContext a) | |
=> a |
|
-> m RGBA |
Gets the foreground color for a given state.
getDisplay
styleContextGetDisplay Source #
:: (HasCallStack, MonadIO m, IsStyleContext a) | |
=> a |
|
-> m Display | Returns: a |
Returns the Display
to which context
is attached.
getMargin
styleContextGetMargin Source #
:: (HasCallStack, MonadIO m, IsStyleContext a) | |
=> a |
|
-> m Border |
Gets the margin for a given state as a Border
.
getPadding
styleContextGetPadding Source #
:: (HasCallStack, MonadIO m, IsStyleContext a) | |
=> a |
|
-> m Border |
Gets the padding for a given state as a Border
.
getScale
:: (HasCallStack, MonadIO m, IsStyleContext a) | |
=> a |
|
-> m Int32 | Returns: the scale |
Returns the scale used for assets.
getState
:: (HasCallStack, MonadIO m, IsStyleContext a) | |
=> a |
|
-> m [StateFlags] | Returns: the state flags |
Returns the state used for style matching.
This method should only be used to retrieve the StateFlags
to pass to StyleContext
methods, like styleContextGetPadding
.
If you need to retrieve the current state of a Widget
, use
widgetGetStateFlags
.
hasClass
:: (HasCallStack, MonadIO m, IsStyleContext a) | |
=> a |
|
-> Text |
|
-> m Bool | Returns: |
Returns True
if context
currently has defined the
given class name.
lookupColor
styleContextLookupColor Source #
:: (HasCallStack, MonadIO m, IsStyleContext a) | |
=> a |
|
-> Text |
|
-> m (Bool, RGBA) | Returns: |
Looks up and resolves a color name in the context
color map.
removeClass
styleContextRemoveClass Source #
:: (HasCallStack, MonadIO m, IsStyleContext a) | |
=> a |
|
-> Text |
|
-> m () |
Removes className
from context
.
removeProvider
styleContextRemoveProvider Source #
:: (HasCallStack, MonadIO m, IsStyleContext a, IsStyleProvider b) | |
=> a |
|
-> b |
|
-> m () |
Removes provider
from the style providers list in context
.
removeProviderForDisplay
styleContextRemoveProviderForDisplay Source #
:: (HasCallStack, MonadIO m, IsDisplay a, IsStyleProvider b) | |
=> a |
|
-> b |
|
-> m () |
Removes provider
from the global style providers list in display
.
restore
:: (HasCallStack, MonadIO m, IsStyleContext a) | |
=> a |
|
-> m () |
Restores context
state to a previous stage.
See styleContextSave
.
save
:: (HasCallStack, MonadIO m, IsStyleContext a) | |
=> a |
|
-> m () |
Saves the context
state, so temporary modifications done through
styleContextAddClass
, styleContextRemoveClass
,
styleContextSetState
, etc. can quickly be reverted
in one go through styleContextRestore
.
The matching call to styleContextRestore
must be done
before GTK returns to the main loop.
setDisplay
styleContextSetDisplay Source #
:: (HasCallStack, MonadIO m, IsStyleContext a, IsDisplay b) | |
=> a |
|
-> b |
|
-> m () |
Attaches context
to the given display.
The display is used to add style information from “global” style
providers, such as the display's Settings
instance.
If you are using a StyleContext
returned from
widgetGetStyleContext
, you do not need to
call this yourself.
setScale
:: (HasCallStack, MonadIO m, IsStyleContext a) | |
=> a |
|
-> Int32 |
|
-> m () |
Sets the scale to use when getting image assets for the style.
setState
:: (HasCallStack, MonadIO m, IsStyleContext a) | |
=> a |
|
-> [StateFlags] |
|
-> m () |
Sets the state to be used for style matching.
toString
:: (HasCallStack, MonadIO m, IsStyleContext a) | |
=> a |
|
-> [StyleContextPrintFlags] |
|
-> m Text | Returns: a newly allocated string representing |
Converts the style context into a string representation.
The string representation always includes information about
the name, state, id, visibility and style classes of the CSS
node that is backing context
. Depending on the flags, more
information may be included.
This function is intended for testing and debugging of the CSS implementation in GTK. There are no guarantees about the format of the returned string, it may change.
Properties
display
No description available in the introspection data.
constructStyleContextDisplay :: (IsStyleContext o, MonadIO m, IsDisplay a) => a -> m (GValueConstruct o) Source #
Construct a GValueConstruct
with valid value for the “display
” property. This is rarely needed directly, but it is used by new
.
getStyleContextDisplay :: (MonadIO m, IsStyleContext o) => o -> m Display Source #
Get the value of the “display
” property.
When overloading is enabled, this is equivalent to
get
styleContext #display
setStyleContextDisplay :: (MonadIO m, IsStyleContext o, IsDisplay a) => o -> a -> m () Source #
Set the value of the “display
” property.
When overloading is enabled, this is equivalent to
set
styleContext [ #display:=
value ]