Speedbar autodoc: SPEEDBAR_Window tag

Have a question about our Software Developer Kit? Ask them here.
User avatar
trixie
Posts: 409
Joined: Thu Jun 30, 2011 2:54 pm
Location: Czech Republic

Speedbar autodoc: SPEEDBAR_Window tag

Post by trixie »

I've noticed that the current Speedbar Gadget autodoc describes the SPEEDBAR_Window tag
SPEEDBAR_Window (struct Window *)
This window's titlebar will change to the selected button's help text while the button remains selected.
without any added note that this type of help is actually deprecated and that the programmer should use help tips instead.
The Rear Window blog

AmigaOne X5000 @ 2GHz / 4GB RAM / Radeon RX 560 / ESI Juli@ / AmigaOS 4.1 Final Edition
SAM440ep-flex @ 667MHz / 1GB RAM / Radeon 9250 / AmigaOS 4.1 Final Edition
User avatar
tonyw
AmigaOS Core Developer
AmigaOS Core Developer
Posts: 1479
Joined: Wed Mar 09, 2011 1:36 pm
Location: Sydney, Australia

Re: Speedbar autodoc: SPEEDBAR_Window tag

Post by tonyw »

I'll write a report about it.
cheers
tony
User avatar
Rigo
AmigaOS Core Developer
AmigaOS Core Developer
Posts: 360
Joined: Mon Jan 17, 2011 9:42 pm

Re: Speedbar autodoc: SPEEDBAR_Window tag

Post by Rigo »

I'm not sure it IS deprecated. As far as I know, the titlebar help still works as well as the helphints...

Simon
User avatar
trixie
Posts: 409
Joined: Thu Jun 30, 2011 2:54 pm
Location: Czech Republic

Re: Speedbar autodoc: SPEEDBAR_Window tag

Post by trixie »

@Rigo
the titlebar help still works as well as the helphints...
It sure may work but is this what we want? Is the window title bar the place for showing help at all? Most importantly: should Intuition support two completely different kinds of gadget help, or should it instead enforce consistency?
The Rear Window blog

AmigaOne X5000 @ 2GHz / 4GB RAM / Radeon RX 560 / ESI Juli@ / AmigaOS 4.1 Final Edition
SAM440ep-flex @ 667MHz / 1GB RAM / Radeon 9250 / AmigaOS 4.1 Final Edition
User avatar
Rigo
AmigaOS Core Developer
AmigaOS Core Developer
Posts: 360
Joined: Mon Jan 17, 2011 9:42 pm

Re: Speedbar autodoc: SPEEDBAR_Window tag

Post by Rigo »

So this topic really should be that the SPEEDBAR_Window attribute should be deprecated, rather than the fact it isn't at the moment?

While I agree with your sentiments, it is a decision for management really.

Simon
User avatar
trixie
Posts: 409
Joined: Thu Jun 30, 2011 2:54 pm
Location: Czech Republic

Re: Speedbar autodoc: SPEEDBAR_Window tag

Post by trixie »

@Rigo
So this topic really should be that the SPEEDBAR_Window attribute should be deprecated
Perhaps. I really thought that with the arrival of proper help tips this horrible, typical-Chris-Aldi-kludge was deprecated already, and that the autodoc only fails to mention this.
While I agree with your sentiments, it is a decision for management really.
So dear management: I'm really, really sentimental about the fact that one gadget uses a help system no other gadget uses. Please do something about it, or else I'll cry you a river :-)
The Rear Window blog

AmigaOne X5000 @ 2GHz / 4GB RAM / Radeon RX 560 / ESI Juli@ / AmigaOS 4.1 Final Edition
SAM440ep-flex @ 667MHz / 1GB RAM / Radeon 9250 / AmigaOS 4.1 Final Edition
User avatar
Rigo
AmigaOS Core Developer
AmigaOS Core Developer
Posts: 360
Joined: Mon Jan 17, 2011 9:42 pm

Re: Speedbar autodoc: SPEEDBAR_Window tag

Post by Rigo »

Sod it!

I've added extra information to the SPEEDBAR_Window attribute to explain it is deprecated. The autodoc will be available with the next SDK update.

Simon
User avatar
trixie
Posts: 409
Joined: Thu Jun 30, 2011 2:54 pm
Location: Czech Republic

Re: Speedbar autodoc: SPEEDBAR_Window tag

Post by trixie »

@Rigo

*THUMBS UP* & thank you!
The Rear Window blog

AmigaOne X5000 @ 2GHz / 4GB RAM / Radeon RX 560 / ESI Juli@ / AmigaOS 4.1 Final Edition
SAM440ep-flex @ 667MHz / 1GB RAM / Radeon 9250 / AmigaOS 4.1 Final Edition
chris
Posts: 562
Joined: Sat Jun 18, 2011 11:05 am
Contact:

Re: Speedbar autodoc: SPEEDBAR_Window tag

Post by chris »

trixie wrote:this type of help is actually deprecated and that the programmer should use help tips instead.
Ignoring the fact that HelpHints don't work properly with speedbars (see http://forum.hyperion-entertainment.biz ... =26&t=1515), unless that was fixed whilst I wasn't looking?
User avatar
Rigo
AmigaOS Core Developer
AmigaOS Core Developer
Posts: 360
Joined: Mon Jan 17, 2011 9:42 pm

Re: Speedbar autodoc: SPEEDBAR_Window tag

Post by Rigo »

Seeing as the topic you link to is reporting a general helphint problem where an inactive window doesn't produce help bubbles, I fail to see how these issues are linked.

Simon
Post Reply