2008-03-08 08:52:38 -05:00
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
// Name: accel.h
|
2008-03-09 13:42:34 -04:00
|
|
|
// Purpose: interface of wxAccelerator* classes
|
2008-03-08 08:52:38 -05:00
|
|
|
// Author: wxWidgets team
|
|
|
|
// RCS-ID: $Id$
|
|
|
|
// Licence: wxWindows license
|
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
|
2008-03-09 13:42:34 -04:00
|
|
|
|
|
|
|
/** wxAcceleratorEntry flags */
|
|
|
|
enum wxAcceleratorEntryFlags
|
|
|
|
{
|
|
|
|
/** no modifiers */
|
|
|
|
wxACCEL_NORMAL,
|
|
|
|
|
|
|
|
/** hold Alt key down */
|
|
|
|
wxACCEL_ALT,
|
|
|
|
|
|
|
|
/** hold Ctrl key down */
|
|
|
|
wxACCEL_CTRL,
|
|
|
|
|
|
|
|
/** hold Shift key down */
|
|
|
|
wxACCEL_SHIFT,
|
|
|
|
|
|
|
|
/** Command key on OS X; identic to wxACCEL_CTRL on other platforms. */
|
|
|
|
wxACCEL_CMD
|
|
|
|
};
|
|
|
|
|
|
|
|
|
2008-03-08 08:52:38 -05:00
|
|
|
/**
|
|
|
|
@class wxAcceleratorEntry
|
2008-03-08 09:43:31 -05:00
|
|
|
|
2008-03-09 13:42:34 -04:00
|
|
|
An object used by an application wishing to create an accelerator table
|
|
|
|
(see wxAcceleratorTable).
|
2008-03-08 09:43:31 -05:00
|
|
|
|
2008-03-08 08:52:38 -05:00
|
|
|
@library{wxcore}
|
2009-02-20 06:34:52 -05:00
|
|
|
@category{data}
|
2008-03-08 09:43:31 -05:00
|
|
|
|
2008-03-10 11:19:31 -04:00
|
|
|
@see wxAcceleratorTable, wxWindow::SetAcceleratorTable
|
2008-03-08 08:52:38 -05:00
|
|
|
*/
|
2008-03-08 09:43:31 -05:00
|
|
|
class wxAcceleratorEntry
|
2008-03-08 08:52:38 -05:00
|
|
|
{
|
|
|
|
public:
|
|
|
|
/**
|
|
|
|
Constructor.
|
2008-03-09 13:42:34 -04:00
|
|
|
|
2008-03-08 09:43:31 -05:00
|
|
|
@param flags
|
2009-01-27 19:51:55 -05:00
|
|
|
A combination of the ::wxAcceleratorEntryFlags values, which
|
2008-03-09 13:42:34 -04:00
|
|
|
indicates which modifier keys are held down.
|
2008-03-08 09:43:31 -05:00
|
|
|
@param keyCode
|
2009-01-27 19:51:55 -05:00
|
|
|
The keycode to be detected. See ::wxKeyCode for a full list of keycodes.
|
2008-03-08 09:43:31 -05:00
|
|
|
@param cmd
|
2008-03-20 18:32:46 -04:00
|
|
|
The menu or control command identifier (ID).
|
|
|
|
@param item
|
|
|
|
The menu item associated with this accelerator.
|
|
|
|
*/
|
|
|
|
wxAcceleratorEntry(int flags = 0, int keyCode = 0, int cmd = 0,
|
|
|
|
wxMenuItem *item = NULL);
|
|
|
|
|
|
|
|
/**
|
|
|
|
Copy ctor.
|
2008-03-08 08:52:38 -05:00
|
|
|
*/
|
2008-03-20 18:32:46 -04:00
|
|
|
wxAcceleratorEntry(const wxAcceleratorEntry& entry);
|
2008-03-08 08:52:38 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
Returns the command identifier for the accelerator table entry.
|
|
|
|
*/
|
2008-03-09 12:24:26 -04:00
|
|
|
int GetCommand() const;
|
2008-03-08 08:52:38 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
Returns the flags for the accelerator table entry.
|
|
|
|
*/
|
2008-03-09 12:24:26 -04:00
|
|
|
int GetFlags() const;
|
2008-03-08 08:52:38 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
Returns the keycode for the accelerator table entry.
|
|
|
|
*/
|
2008-03-09 12:24:26 -04:00
|
|
|
int GetKeyCode() const;
|
2008-03-08 08:52:38 -05:00
|
|
|
|
2008-03-20 18:32:46 -04:00
|
|
|
/**
|
|
|
|
Returns the menu item associated with this accelerator entry.
|
|
|
|
*/
|
|
|
|
wxMenuItem *GetMenuItem() const;
|
|
|
|
|
2008-03-08 08:52:38 -05:00
|
|
|
/**
|
|
|
|
Sets the accelerator entry parameters.
|
2008-03-20 09:45:17 -04:00
|
|
|
|
2008-03-08 09:43:31 -05:00
|
|
|
@param flags
|
2009-01-27 19:51:55 -05:00
|
|
|
A combination of the ::wxAcceleratorEntryFlags values, which
|
2008-03-09 13:42:34 -04:00
|
|
|
indicates which modifier keys are held down.
|
2008-03-08 09:43:31 -05:00
|
|
|
@param keyCode
|
2009-01-27 19:51:55 -05:00
|
|
|
The keycode to be detected. See ::wxKeyCode for a full list of keycodes.
|
2008-03-08 09:43:31 -05:00
|
|
|
@param cmd
|
2008-03-20 18:32:46 -04:00
|
|
|
The menu or control command identifier (ID).
|
|
|
|
@param item
|
|
|
|
The menu item associated with this accelerator.
|
|
|
|
*/
|
|
|
|
void Set(int flags, int keyCode, int cmd, wxMenuItem *item = NULL);
|
2008-03-09 13:42:34 -04:00
|
|
|
|
2008-03-20 18:32:46 -04:00
|
|
|
/**
|
|
|
|
Returns @true if this object is correctly initialized.
|
2008-03-08 08:52:38 -05:00
|
|
|
*/
|
2008-03-20 18:32:46 -04:00
|
|
|
bool IsOk() const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
Returns a wxString for this accelerator.
|
2009-01-27 19:51:55 -05:00
|
|
|
|
2008-03-20 18:32:46 -04:00
|
|
|
This function formats it using the @c "flags-keycode" format
|
|
|
|
where @c flags maybe a hyphen-separed list of @c "shift|alt|ctrl".
|
|
|
|
*/
|
|
|
|
wxString ToString() const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
Parses the given string and sets the accelerator accordingly.
|
|
|
|
|
|
|
|
@param str
|
|
|
|
Should be a string in the form "flags-keycode"
|
|
|
|
|
2008-05-10 21:38:53 -04:00
|
|
|
@return @true if the given string correctly initialized this object
|
|
|
|
(i.e. if IsOk() returns true after this call)
|
2008-03-20 18:32:46 -04:00
|
|
|
*/
|
|
|
|
bool FromString(const wxString& str);
|
|
|
|
|
|
|
|
|
|
|
|
wxAcceleratorEntry& operator=(const wxAcceleratorEntry& entry);
|
|
|
|
bool operator==(const wxAcceleratorEntry& entry) const;
|
|
|
|
bool operator!=(const wxAcceleratorEntry& entry) const;
|
2008-03-08 08:52:38 -05:00
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
@class wxAcceleratorTable
|
2008-03-08 09:43:31 -05:00
|
|
|
|
2008-03-08 08:52:38 -05:00
|
|
|
An accelerator table allows the application to specify a table of keyboard
|
2008-03-18 12:21:15 -04:00
|
|
|
shortcuts for menu or button commands.
|
2008-03-09 13:42:34 -04:00
|
|
|
|
2008-03-10 11:19:31 -04:00
|
|
|
The object ::wxNullAcceleratorTable is defined to be a table with no data, and
|
2008-03-09 13:42:34 -04:00
|
|
|
is the initial accelerator table for a window.
|
|
|
|
|
|
|
|
Example:
|
|
|
|
|
|
|
|
@code
|
|
|
|
wxAcceleratorEntry entries[4];
|
|
|
|
entries[0].Set(wxACCEL_CTRL, (int) 'N', ID_NEW_WINDOW);
|
|
|
|
entries[1].Set(wxACCEL_CTRL, (int) 'X', wxID_EXIT);
|
|
|
|
entries[2].Set(wxACCEL_SHIFT, (int) 'A', ID_ABOUT);
|
|
|
|
entries[3].Set(wxACCEL_NORMAL, WXK_DELETE, wxID_CUT);
|
|
|
|
|
|
|
|
wxAcceleratorTable accel(4, entries);
|
|
|
|
frame->SetAcceleratorTable(accel);
|
|
|
|
@endcode
|
2008-03-08 09:43:31 -05:00
|
|
|
|
2008-03-09 13:42:34 -04:00
|
|
|
@remarks
|
|
|
|
An accelerator takes precedence over normal processing and can be a convenient
|
|
|
|
way to program some event handling. For example, you can use an accelerator table
|
|
|
|
to enable a dialog with a multi-line text control to accept CTRL-Enter as meaning
|
2008-03-20 09:19:55 -04:00
|
|
|
'OK'.
|
2008-03-08 09:43:31 -05:00
|
|
|
|
2008-03-08 08:52:38 -05:00
|
|
|
@library{wxcore}
|
2009-02-20 06:34:52 -05:00
|
|
|
@category{data}
|
2008-03-08 09:43:31 -05:00
|
|
|
|
2008-03-08 08:52:38 -05:00
|
|
|
@stdobjects
|
2008-03-10 11:19:31 -04:00
|
|
|
::wxNullAcceleratorTable
|
2008-03-08 09:43:31 -05:00
|
|
|
|
2008-03-10 11:19:31 -04:00
|
|
|
@see wxAcceleratorEntry, wxWindow::SetAcceleratorTable
|
2008-03-08 08:52:38 -05:00
|
|
|
*/
|
|
|
|
class wxAcceleratorTable : public wxObject
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
/**
|
2008-03-09 13:42:34 -04:00
|
|
|
Default ctor.
|
|
|
|
*/
|
|
|
|
wxAcceleratorTable();
|
|
|
|
|
|
|
|
/**
|
|
|
|
Initializes the accelerator table from an array of wxAcceleratorEntry.
|
2008-03-20 09:45:17 -04:00
|
|
|
|
2008-03-08 09:43:31 -05:00
|
|
|
@param n
|
2008-03-09 08:33:59 -04:00
|
|
|
Number of accelerator entries.
|
2008-03-08 09:43:31 -05:00
|
|
|
@param entries
|
2008-03-09 08:33:59 -04:00
|
|
|
The array of entries.
|
2009-10-18 13:47:01 -04:00
|
|
|
|
|
|
|
@beginWxPerlOnly
|
|
|
|
The wxPerl constructor accepts a list of either
|
|
|
|
Wx::AcceleratorEntry objects or references to 3-element arrays
|
|
|
|
[flags, keyCode, cmd] , like the parameters of
|
|
|
|
Wx::AcceleratorEntry::new.
|
|
|
|
@endWxPerlOnly
|
2008-03-09 13:42:34 -04:00
|
|
|
*/
|
2008-03-20 18:32:46 -04:00
|
|
|
wxAcceleratorTable(int n, const wxAcceleratorEntry entries[]);
|
2008-03-09 13:42:34 -04:00
|
|
|
|
|
|
|
/**
|
|
|
|
Loads the accelerator table from a Windows resource (Windows only).
|
2008-03-20 09:45:17 -04:00
|
|
|
|
2008-03-27 16:54:47 -04:00
|
|
|
@onlyfor{wxmsw}
|
|
|
|
|
2008-03-08 09:43:31 -05:00
|
|
|
@param resource
|
2008-03-09 08:33:59 -04:00
|
|
|
Name of a Windows accelerator.
|
2008-03-08 08:52:38 -05:00
|
|
|
*/
|
2008-03-08 09:43:31 -05:00
|
|
|
wxAcceleratorTable(const wxString& resource);
|
2008-03-08 08:52:38 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
Destroys the wxAcceleratorTable object.
|
2008-03-09 13:42:34 -04:00
|
|
|
See @ref overview_refcount_destruct for more info.
|
2008-03-08 08:52:38 -05:00
|
|
|
*/
|
2008-03-23 21:02:55 -04:00
|
|
|
virtual ~wxAcceleratorTable();
|
2008-03-08 08:52:38 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
Returns @true if the accelerator table is valid.
|
|
|
|
*/
|
2008-03-09 12:24:26 -04:00
|
|
|
bool IsOk() const;
|
2008-03-08 08:52:38 -05:00
|
|
|
};
|
2008-03-09 13:42:34 -04:00
|
|
|
|
2008-03-14 11:35:10 -04:00
|
|
|
|
|
|
|
// ============================================================================
|
|
|
|
// Global functions/macros
|
|
|
|
// ============================================================================
|
|
|
|
|
2008-03-09 13:42:34 -04:00
|
|
|
/**
|
|
|
|
An empty accelerator table.
|
|
|
|
*/
|
|
|
|
wxAcceleratorTable wxNullAcceleratorTable;
|