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
This commit is contained in:
Albrecht Schlosser 2015-03-05 12:42:29 +00:00
parent 33206498fd
commit c96a330e26
1 changed files with 23 additions and 15 deletions

View File

@ -662,29 +662,37 @@ extern Fl_Labeltype FL_EXPORT fl_define_FL_EMBOSSED_LABEL();
/** \name Alignment Flags /** \name Alignment Flags
Flags to control the label alignment. 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.
Flags can be or'd to achieve a combination of alignments. This controls how the label is displayed next to or 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, 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 \code
Outside alignments: Outside alignments (FL_ALIGN_INSIDE is not set):
TOP_LEFT TOP TOP_RIGHT
LEFT_TOP+---------------------------------+RIGHT_TOP TOP_LEFT TOP TOP_RIGHT
| | +---------------------------------+
LEFT| |RIGHT LEFT_TOP| |RIGHT_TOP
| | | |
LEFT_BOTTOM+---------------------------------+RIGHT_BOTTOM LEFT| CENTER |RIGHT
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| |TOP_LEFT TOP TOP_RIGHT|
| | | |
|LEFT RIGHT| |LEFT CENTER RIGHT|
| | | |
|BOTTOM_RIGHT BOTTOM BOTTOM_LEFT| |BOTTOM_LEFT BOTTOM BOTTOM_RIGHT|
+---------------------------------+ +---------------------------------+
\endcode \endcode
\see #FL_ALIGN_CENTER, etc. \see #FL_ALIGN_CENTER, etc.