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 |
FixedLayout
is a layout manager which can place child widgets
at fixed positions, and with fixed sizes.
Most applications should never use this layout manager; fixed positioning and sizing requires constant recalculations on where children need to be positioned and sized. Other layout managers perform this kind of work internally so that application developers don't need to do it. Specifically, widgets positioned in a fixed layout manager will need to take into account:
- Themes, which may change widget sizes.
- Fonts other than the one you used to write the app will of course change the size of widgets containing text; keep in mind that users may use a larger font because of difficulty reading the default, or they may be using a different OS that provides different fonts.
- Translation of text into other languages changes its size. Also, display of non-English text will use a different font in many cases.
In addition, FixedLayout
does not pay attention to text direction and
thus may produce unwanted results if your app is run under right-to-left
languages such as Hebrew or Arabic. That is: normally GTK will order
containers appropriately depending on the text direction, e.g. to put labels
to the right of the thing they label when using an RTL language;
FixedLayout
won't be able to do that for you.
Finally, fixed positioning makes it kind of annoying to add/remove GUI elements, since you have to reposition all the other elements. This is a long-term maintenance problem for your application.
Synopsis
- newtype FixedLayout = FixedLayout (ManagedPtr FixedLayout)
- class (GObject o, IsDescendantOf FixedLayout o) => IsFixedLayout o
- toFixedLayout :: (MonadIO m, IsFixedLayout o) => o -> m FixedLayout
- fixedLayoutNew :: (HasCallStack, MonadIO m) => m FixedLayout
Exported types
newtype FixedLayout Source #
Memory-managed wrapper type.
FixedLayout (ManagedPtr FixedLayout) |
Instances
Eq FixedLayout Source # | |
Defined in GI.Gtk.Objects.FixedLayout (==) :: FixedLayout -> FixedLayout -> Bool # (/=) :: FixedLayout -> FixedLayout -> Bool # | |
GObject FixedLayout Source # | |
Defined in GI.Gtk.Objects.FixedLayout | |
ManagedPtrNewtype FixedLayout Source # | |
Defined in GI.Gtk.Objects.FixedLayout toManagedPtr :: FixedLayout -> ManagedPtr FixedLayout | |
TypedObject FixedLayout Source # | |
Defined in GI.Gtk.Objects.FixedLayout | |
HasParentTypes FixedLayout Source # | |
Defined in GI.Gtk.Objects.FixedLayout | |
IsGValue (Maybe FixedLayout) Source # | Convert |
Defined in GI.Gtk.Objects.FixedLayout gvalueGType_ :: IO GType gvalueSet_ :: Ptr GValue -> Maybe FixedLayout -> IO () gvalueGet_ :: Ptr GValue -> IO (Maybe FixedLayout) | |
type ParentTypes FixedLayout Source # | |
Defined in GI.Gtk.Objects.FixedLayout |
class (GObject o, IsDescendantOf FixedLayout o) => IsFixedLayout o Source #
Type class for types which can be safely cast to FixedLayout
, for instance with toFixedLayout
.
Instances
(GObject o, IsDescendantOf FixedLayout o) => IsFixedLayout o Source # | |
Defined in GI.Gtk.Objects.FixedLayout |
toFixedLayout :: (MonadIO m, IsFixedLayout o) => o -> m FixedLayout Source #
Cast to FixedLayout
, 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
allocate, bindProperty, bindPropertyFull, forceFloating, freezeNotify, getv, isFloating, layoutChanged, measure, notify, notifyByPspec, ref, refSink, runDispose, stealData, stealQdata, thawNotify, unref, watchClosure.
Getters
getData, getLayoutChild, getProperty, getQdata, getRequestMode, getWidget.
Setters
new
:: (HasCallStack, MonadIO m) | |
=> m FixedLayout | Returns: the newly created |
Creates a new FixedLayout
.