Author: manolo
Date: 2010-03-22 11:51:56 -0700 (Mon, 22 Mar 2010)
New Revision: 7318
Log:
Updating the Mac OS Interface section
Modified:
branches/branch-1.3/documentation/src/osissues.dox
Modified: branches/branch-1.3/documentation/src/osissues.dox
===================================================================
--- branches/branch-1.3/documentation/src/osissues.dox 2010-03-22 11:55:34 UTC
(rev 7317)
+++ branches/branch-1.3/documentation/src/osissues.dox 2010-03-22 18:51:56 UTC
(rev 7318)
@@ -639,27 +639,29 @@
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 @@
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 @@
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
_______________________________________________
fltk-commit mailing list
[email protected]
http://lists.easysw.com/mailman/listinfo/fltk-commit
