Mirrors_UI_SDK/fltk
1
0
Fork 0
mirror of https://github.com/fltk/fltk.git synced 2026-06-08 01:46:00 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

Updating the Mac OS Interface section

Browse Source 
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@7318 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
This commit is contained in:
Manolo Gouy
2010-03-22 18:51:56 +00:00
parent 916724c345
commit 8c67992b53
1 changed files with 27 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/src/osissues.dox
+27 -11
View File
@@ -639,27 +639,29 @@ version of FLTK:
as -O2 and -O3 seem to work OK. More details can be found
in STR#1656
\section osissues_macos The MacOS Interface
\section osissues_macos The Mac OS Interface
FLTK supports MacOS X using the Apple Carbon library. Older
versions of MacOS are <I>not</I> supported.
FLTK supports Mac OS X using the Apple Cocoa library. Older
versions of Mac OS are <I>not</I> supported.
Control, Option, and Command Modifier Keys
\par
FLTK maps the Mac 'control' key to \c FL_CTRL, the
'option' key to \c FL_ALT and the 'Apple' key to
\c FL_META. Keyboard events return the key name in
\c FL_META. Furthermore, \c FL_COMMAND designates the 'Apple' key on Mac OS X
and the 'control' key on other platforms.
Keyboard events return the key name in
Fl::event_key() and the keystroke translation in
Fl::event_text(). For example, typing Option-Y on a Mac
keyboard will set \c FL_ALT in Fl::event_state(),
US keyboard will set \c FL_ALT in Fl::event_state(),
set Fl::event_key() to 'y' and return the Yen symbol in
Fl::event_text().
Apple "Quit" Event
\par
When the user press Cmd-Q or requests a termination of the
When the user presses Cmd-Q or requests a termination of the
application, OS X will send a "Quit" Apple Event. FLTK handles
this event by sending an \c FL_CLOSE event to all open
windows. If all windows close, the application will terminate.
@@ -671,18 +673,19 @@ Whenever the user drops a file onto an application icon, OS X
generates an Apple Event of the type "Open". You can have FLTK
notify you of an Open event by setting the \c fl_open_callback
WindowRef fl_xid(const Fl_Window *)
Window fl_xid(const Fl_Window *)
\par
Returns the window reference for an Fl_Window, or
\c NULL if the window has not been shown.
\c NULL if the window has not been shown. This reference is a pointer
to an instance of the subclass FLWindow of Cocoa's NSWindow class.
Fl_Window *fl_find(WindowRef xid)
Fl_Window *fl_find(Window xid)
\par
Returns the Fl_Window that corresponds to the give window handle,
Returns the Fl_Window that corresponds to the given window reference,
or \c NULL if not found. FLTK windows that are children of top-level
windows share the \c WindowRef of the top-level window.
windows share the \c Window of the top-level window.
void fl_open_callback(void (*cb)(const char *))
@@ -691,6 +694,19 @@ void fl_open_callback(void (*cb)(const char *))
If multiple files were dropped, \c fl_open_callback() will be called
multiple times.
void fl_mac_set_about( Fl_Callback *cb, void *user_data, int shortcut)
\par
Attaches the callback \c cb to the "About myprog" item of the system application menu.
\c cb will be called with NULL first argument and \c user_data second argument.
Fl_Sys_Menu_Bar class
\par
The Fl_Sys_Menu_Bar class allows to build menu bars that, on Mac OS X, are
placed in the system menu bar (at top-left of display), and, on other platforms,
at a user-chosen location of a user-chosen window.
\subsection osissues_quickdraw Drawing Things Using QuickDraw
When the virtual function Fl_Widget::draw() is