haiku/docs/user
John Scipione 7c095f4709 BeControlLook: Fix app integration drawing issues
Update BTab::DrawTab() to pass the current index, the index of the
selected tab, and the index of the first and last tabs into
BControlLook::DrawActiveTab() and BControlLook::DrawInactiveTab().
This allows you to draw tabs differently in your BTab or BControlLook
subclass in many different circumstances.

Modify BControlLook API to add indexes to DrawActiveTab() and
DrawInactiveTab() like so:

void DrawActiveTab(..., int32 index = 0, int32 selected = -1,
	int32 first = 0, int32 last = 0);
void DrawInactiveTab(..., int32 index = 0, int32 selected = -1,
	int32 first = 0, int32 last = 0);

These extra indexes are not used by HaikuControlLook which relies only
on if the tab is active or inactive to draw.

Add IndexOf(BTab* tab) method to BTabView and document it to get the
index of the current tab in BTab::DrawTab(). Also add a warning in the
BTabView::DrawTab() method not to use the position and full parameters
anymore, use BTabView::IndexOf(), BTabView::Selection(), and
BTabView::TabCount() to get the info you need.

Using a dynamic_cast to a BTabView in BeControlLook to determine if the
view is derived from a BTabView didn't work in the case of WebPositive.
Furthermore, WebPositive does custom tab drawing which needed to be
updated for alternative control look. These index parameters passed from
BTab to BeControlLook allow us to draw the tab like BeOS without relying
on a dynamic_cast to BTabView to get the info.

Reproduce the functionality described above for BTab in WebPositive's
custom tabs. Eliminate no longer needed code in favor of using indexes.
Update WebPositive custom tabs to use BControlLook::DrawTabFrame()
instead of BControlLook::DrawInactiveTab() matching the update made in
BTabView.

In BeControlLook::DrawTabFrame() fill rect with base color, WebPositive
doesn't draw any tab background, so it expects this work to be done for
it.

Eliminate hasFrames variable from WebPositive.

Rename TabSelected(index) to UpdateSelection(index) in WebPositive to
better reflect its purpose.

Adjusted HaikuControlLook::DrawInactiveTab() to draw the tab borders more
selectively. Only draw border if left border is set for top and bottom tabs
or top border is set for left and right tabs. Undo no longer needed frame
manipulation border drawing workaround in HaikuControlLook::DrawTabFrame().

Draw scroll bar triangle without using DrawArrowShape().

Unlike in HaikuControlLook, DrawArrowShape() is used to draw arrows in
BOutlineListView and menus distinctly from how it draws arrows in scroll
bars. Draw our distinct arrows in DrawSrollBarButtons() instead.

This fixes overflow of time edit up-down arrows in Clock prefs and the
collapse-expand arrow in Deskbar not being vertically centered.

In DrawBorders() only inset if we actually draw the border.

Fix alignment issues with DrawSliderThumb dots for example in
MediaPlayer volume knobs.

Draw using line arrays calling AddLine instead of StrokeLine in
several places.

DrawMenuBar() extends to draw final pixel which eliminates an extra
lines at the end of menu bars.

Truncate button labels better fixing a few issues for example keymap
keyboard layout button labels. Button insets has been updated a bit
to fix drawing issues with buttons missing a border.

Using a dynamic_cast to a BButton to determine if a view is a button
in BeControlLook didn't work in the case of the keymap label. Look for
B_FLAT, B_HOVER, or B_DEFAULT_BUTTON flag in BeControlLook::DrawLabel()
to draw the label inverted on click. Pass the B_FLAT flag from Keymap
keys when drawing using BControlLook so that the label is inverted.

Change-Id: I07631f4b006bdb9aeca2adc9cbdf2da54dae8e92
Reviewed-on: https://review.haiku-os.org/c/haiku/+/2866
Reviewed-by: Adrien Destugues <pulkomandy@gmail.com>
2020-10-11 15:50:18 +00:00
..
app HaikuBook: Hide BLaunchRoster and BToolTip documentation from book 2020-10-11 15:46:06 +00:00
device
drivers FS Interface Docs: Made read_dir description clear 2020-06-11 10:39:35 +00:00
game BFileGameSound docs: Fix typo 2020-07-07 19:20:48 +02:00
graphics Documentation: Added Accelerant documentation 2020-10-08 07:15:28 +00:00
interface BeControlLook: Fix app integration drawing issues 2020-10-11 15:50:18 +00:00
keyboard
locale typo and missing parameter 2020-09-25 12:39:16 +00:00
mail Migrate the BTextMailComponent docs to the Haiku Book. 2017-12-26 13:59:25 -05:00
media
midi
midi2 Haiku Book: revert accidental overzealous search & replace all 2020-03-08 09:21:06 +00:00
net BUrlProtocolListener: Update DownloadProgress() docs 2020-07-25 18:13:20 +00:00
posix
ppp
shared HaikuBook: fix part of the warnings marked by Doxygen 2020-03-01 09:50:49 +00:00
storage storage/SymLink: Fix Be API regression in ReadLink 2020-04-30 10:13:41 +00:00
support HaikuBook: Add skeleton for support/DateTime.h and support/Job.h. 2020-10-11 15:46:06 +00:00
translation HaikuBook: fix warnings generated by Doxygen 1.18.16. 2020-03-08 08:57:37 +00:00
apidoc.dox HaikuBook: add instructions for including INTERNAL documentation 2020-10-11 15:46:06 +00:00
book.css HaikuBook: Apply layout customizations after default Doxygen stylesheet 2020-09-29 19:14:01 +00:00
book.dox HaikuBook: Add documentation for Password and Key Storage API 2020-03-13 21:32:38 +00:00
compatibility.dox
credits.dox
Doxyfile HaikuBook: Hide BLaunchRoster and BToolTip documentation from book 2020-10-11 15:46:06 +00:00
footer.html HaikuBook: Apply layout customizations after default Doxygen stylesheet 2020-09-29 19:14:01 +00:00
header.html HaikuBook: Apply layout customizations after default Doxygen stylesheet 2020-09-29 19:14:01 +00:00
HOWTO
Makefile HaikuBook: Add Makefile that supports the default and the develop configurations 2020-10-11 15:46:06 +00:00