summaryrefslogtreecommitdiff
path: root/FL/Enumerations.H
diff options
context:
space:
mode:
authorAlbrecht Schlosser <albrechts.fltk@online.de>2015-03-05 12:42:29 +0000
committerAlbrecht Schlosser <albrechts.fltk@online.de>2015-03-05 12:42:29 +0000
commitc96a330e26d718989473dc71d00083f562e6792a (patch)
treeeed92b359e6f1216abebdd6287a9bb67a0d41574 /FL/Enumerations.H
parent33206498fd7917a4c3e4ba29d20a3d13888b208f (diff)
Fix documentation errors and clarify label alignment docs.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@10606 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
Diffstat (limited to 'FL/Enumerations.H')
-rw-r--r--FL/Enumerations.H30
1 files changed, 19 insertions, 11 deletions
diff --git a/FL/Enumerations.H b/FL/Enumerations.H
index 40cefc6df..1a3593bd1 100644
--- a/FL/Enumerations.H
+++ b/FL/Enumerations.H
@@ -662,29 +662,37 @@ extern Fl_Labeltype FL_EXPORT fl_define_FL_EMBOSSED_LABEL();
/** \name Alignment Flags
Flags to control the label alignment.
+
This controls how the label is displayed next to or inside the widget.
- The default value is FL_ALIGN_CENTER for most widgets, which centers the label
- inside the widget.
+ The default value is FL_ALIGN_CENTER (0) for most widgets, which centers
+ the label inside the widget.
- Flags can be or'd to achieve a combination of alignments.
+ Flags can be or'd to achieve a combination of alignments, but there
+ are some "magic values" (e.g. combinations of TOP and BOTTOM and of
+ LEFT and RIGHT) that have special meanings (see below). For instance:<BR>
+ FL_ALIGN_TOP_LEFT == (FL_ALIGN_TOP|FL_ALIGN_LEFT) != FL_ALIGN_LEFT_TOP.
\code
- Outside alignments:
+ Outside alignments (FL_ALIGN_INSIDE is not set):
+
TOP_LEFT TOP TOP_RIGHT
- LEFT_TOP+---------------------------------+RIGHT_TOP
+ +---------------------------------+
+ LEFT_TOP| |RIGHT_TOP
| |
- LEFT| |RIGHT
+ LEFT| CENTER |RIGHT
| |
- LEFT_BOTTOM+---------------------------------+RIGHT_BOTTOM
- BOTTOM_RIGHT BOTTOM BOTTOM_LEFT
+ LEFT_BOTTOM| |RIGHT_BOTTOM
+ +---------------------------------+
+ BOTTOM_LEFT BOTTOM BOTTOM_RIGHT
+
+ Inside alignments (FL_ALIGN_INSIDE is set):
- Inside alignments:
+---------------------------------+
|TOP_LEFT TOP TOP_RIGHT|
| |
- |LEFT RIGHT|
+ |LEFT CENTER RIGHT|
| |
- |BOTTOM_RIGHT BOTTOM BOTTOM_LEFT|
+ |BOTTOM_LEFT BOTTOM BOTTOM_RIGHT|
+---------------------------------+
\endcode
\see #FL_ALIGN_CENTER, etc.