Copyright | Will Thompson Iñaki García Etxebarria and Jonas Platte |
---|---|
License | LGPL-2.1 |
Maintainer | Iñaki García Etxebarria |
Safe Haskell | None |
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.
Instances
Eq FixedLayout Source # | |
Defined in GI.Gtk.Objects.FixedLayout (==) :: FixedLayout -> FixedLayout -> Bool # (/=) :: FixedLayout -> FixedLayout -> Bool # | |
IsGValue FixedLayout Source # | Convert |
Defined in GI.Gtk.Objects.FixedLayout toGValue :: FixedLayout -> IO GValue # fromGValue :: GValue -> IO FixedLayout # | |
ManagedPtrNewtype FixedLayout Source # | |
Defined in GI.Gtk.Objects.FixedLayout | |
TypedObject FixedLayout Source # | |
Defined in GI.Gtk.Objects.FixedLayout | |
GObject FixedLayout Source # | |
Defined in GI.Gtk.Objects.FixedLayout | |
HasParentTypes FixedLayout Source # | |
Defined in GI.Gtk.Objects.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
Overloaded methods
new
:: (HasCallStack, MonadIO m) | |
=> m FixedLayout | Returns: the newly created |
Creates a new FixedLayout
.