Bug 97492 - [Dialogs] Help button should appear in dialogs on MacOS X
Summary: [Dialogs] Help button should appear in dialogs on MacOS X
Status: CLOSED WONTFIX
Alias: None
Product: Platform
Classification: Eclipse Project
Component: SWT (show other bugs)
Version: 3.1   Edit
Hardware: Macintosh Mac OS X
: P5 normal (vote)
Target Milestone: ---   Edit
Assignee: Platform-SWT-Inbox CLA
QA Contact:
URL:
Whiteboard: stalebug
Keywords: triaged
Depends on:
Blocks:
 
Reported: 2005-05-31 10:36 EDT by Douglas Pollock CLA
Modified: 2020-04-20 17:58 EDT (History)
5 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Douglas Pollock CLA 2005-05-31 10:36:41 EDT
I'm trolling through the Apple Human Interface Guidelines for another bug I'm
working on.  Context-sensitive help should be available via a small round
question mark button in the bottom left of dialogs.

"http://developer.apple.com/documentation/UserExperience/Conceptual/OSXHIGuidelines/XHIGControls/chapter_18_section_2.html#//apple_ref/doc/uid/TP30000359-DontLinkElementID_18314"
Comment 1 Curtis d'Entremont CLA 2006-01-25 14:28:38 EST
This is being addressed in bug 108509, not just for the Mac, but for all platforms.
Comment 2 Susan McCourt CLA 2006-01-26 16:42:18 EST
Moving this bug to Tod since he owns that bug, too.  I'll let him mark duplicate or whatever is appropriate.
Comment 3 Susan McCourt CLA 2009-07-09 15:56:44 EDT
As per http://wiki.eclipse.org/Platform_UI/Bug_Triage_Change_2009
Comment 4 Prakash Rangaraj CLA 2010-05-14 05:53:24 EDT
We have the image in the dialogs. The image looks little out of place in a Mac, but to have the standard Mac help image, we need support from SWT.

Right now SWT only supports NSRoundedBezelStyle & NSShadowlessSquareBezelStyle for bezelStyles. We need NSHelpButtonBezelStyle to have the help button. If SWT provide a SWT.HELP (like SWT.SEARCH) to create the help button, (or provide support in any other way) Platform UI can use it.

Assigning to SWT for comments.
Comment 5 Scott Kovatch CLA 2010-06-07 13:26:58 EDT
A flag for a HELP style would be new API, but we can certainly look at it for 3.7.
Comment 6 Scott Kovatch CLA 2010-08-24 13:30:06 EDT
Silenio, is there a standard 'help' button/icon style on Windows or Linux? In Cocoa this would be a button with NSHelpButtonBezelStyle set.
Comment 7 Prakash Rangaraj CLA 2010-08-24 13:44:39 EDT
(In reply to comment #6)
> Silenio, is there a standard 'help' button/icon style on Windows or Linux? In
> Cocoa this would be a button with NSHelpButtonBezelStyle set.

   AFAIK, Windows doesn't have any special image for Help buttons, but I guess gtk has it: http://library.gnome.org/devel/hig-book/stable/windows-utility.html.en
Comment 8 Silenio Quarti CLA 2010-08-24 17:06:52 EDT
(In reply to comment #6)
> Silenio, is there a standard 'help' button/icon style on Windows or Linux? In
> Cocoa this would be a button with NSHelpButtonBezelStyle set.

I believe this is the GTK equivalent:

http://library.gnome.org/devel/gtk/stable/GtkButton.html#gtk-button-new-from-stock

Note that on GTK it is just a regular button with a stock image. On cocoa, it is a special button (rounded and pink). At first I though you could provide just the image (Display.getSystemImage(SWT.ICON_HELP) and on platforms where the image is not available (i. e. Windows), we would return null. But it would not work well for Cocoa.

Windows has WS_EX_CONTEXTHELP, but it is button in the title bar only.
Comment 9 Scott Kovatch CLA 2010-08-24 17:12:11 EDT
(In reply to comment #8)

> Note that on GTK it is just a regular button with a stock image. On cocoa, it
> is a special button (rounded and pink). At first I though you could provide
> just the image (Display.getSystemImage(SWT.ICON_HELP) and on platforms where
> the image is not available (i. e. Windows), we would return null. But it would
> not work well for Cocoa.

Right. The help button on Mac is a style all its own.
 
> Windows has WS_EX_CONTEXTHELP, but it is button in the title bar only.

I was thinking that we could just use the Eclipse Help image in a borderless button on platforms where we would have to emulate it.  See bug 108509, or just bring up the Preferences dialog.
Comment 10 Silenio Quarti CLA 2010-08-25 09:39:50 EDT
(In reply to comment #9)
> > Windows has WS_EX_CONTEXTHELP, but it is button in the title bar only.
> I was thinking that we could just use the Eclipse Help image in a borderless
> button on platforms where we would have to emulate it.  See bug 108509, or just
> bring up the Preferences dialog.

I believe the eclipse button is actually a ToolBar with one item, but I agree it could be just a button with a image. Windows haa standard image for help (see Start-> Help and Support). I am not sure we can get a hold of it. Maybe with the theme drawing calls (DrawThemeBackground()).
Comment 11 Lakshmi P Shanmugam CLA 2017-07-03 07:46:19 EDT
Bug triaged, visit https://wiki.eclipse.org/SWT/Devel/Triage for more
information.
Comment 12 Eclipse Genie CLA 2020-04-20 17:58:04 EDT
This bug hasn't had any activity in quite some time. Maybe the problem got resolved, was a duplicate of something else, or became less pressing for some reason - or maybe it's still relevant but just hasn't been looked at yet. As such, we're closing this bug.

If you have further information on the current state of the bug, please add it and reopen this bug. The information can be, for example, that the problem still occurs, that you still want the feature, that more information is needed, or that the bug is (for whatever reason) no longer relevant.

--
The automated Eclipse Genie.