///////////////////////////////////////////////////////////////////////////////
-// Name: common/stockitem.cpp
+// Name: src/common/stockitem.cpp
// Purpose: Stock buttons, menu and toolbar items labels
// Author: Vaclav Slavik
// Modified by:
// Created: 2004-08-15
-// RCS-ID: $Id$
// Copyright: (c) Vaclav Slavik, 2004
// Licence: wxWindows licence
///////////////////////////////////////////////////////////////////////////////
// headers
// ----------------------------------------------------------------------------
-#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
- #pragma implementation "stockitem.h"
-#endif
-
// For compilers that support precompilation, includes "wx.h".
#include "wx/wxprec.h"
#endif
#include "wx/stockitem.h"
-#include "wx/intl.h"
+#ifndef WX_PRECOMP
+ #include "wx/intl.h"
+ #include "wx/utils.h" // for wxStripMenuCodes()
+#endif
bool wxIsStockID(wxWindowID id)
{
switch (id)
{
+ case wxID_ABOUT:
case wxID_ADD:
case wxID_APPLY:
+ case wxID_BACKWARD:
case wxID_BOLD:
+ case wxID_BOTTOM:
case wxID_CANCEL:
+ case wxID_CDROM:
case wxID_CLEAR:
case wxID_CLOSE:
+ case wxID_CONVERT:
case wxID_COPY:
case wxID_CUT:
case wxID_DELETE:
- case wxID_FIND:
- case wxID_REPLACE:
- case wxID_BACKWARD:
case wxID_DOWN:
+ case wxID_EDIT:
+ case wxID_EXECUTE:
+ case wxID_EXIT:
+ case wxID_FILE:
+ case wxID_FIND:
+ case wxID_FIRST:
+ case wxID_FLOPPY:
case wxID_FORWARD:
- case wxID_UP:
+ case wxID_HARDDISK:
case wxID_HELP:
case wxID_HOME:
case wxID_INDENT:
case wxID_INDEX:
+ case wxID_INFO:
case wxID_ITALIC:
+ case wxID_JUMP_TO:
case wxID_JUSTIFY_CENTER:
case wxID_JUSTIFY_FILL:
case wxID_JUSTIFY_LEFT:
case wxID_JUSTIFY_RIGHT:
+ case wxID_LAST:
+ case wxID_NETWORK:
case wxID_NEW:
case wxID_NO:
case wxID_OK:
case wxID_OPEN:
case wxID_PASTE:
case wxID_PREFERENCES:
- case wxID_PRINT:
case wxID_PREVIEW:
+ case wxID_PRINT:
case wxID_PROPERTIES:
- case wxID_EXIT:
case wxID_REDO:
case wxID_REFRESH:
case wxID_REMOVE:
+ case wxID_REPLACE:
case wxID_REVERT_TO_SAVED:
case wxID_SAVE:
case wxID_SAVEAS:
+ case wxID_SELECTALL:
+ case wxID_SELECT_COLOR:
+ case wxID_SELECT_FONT:
+ case wxID_SORT_ASCENDING:
+ case wxID_SORT_DESCENDING:
+ case wxID_SPELL_CHECK:
case wxID_STOP:
+ case wxID_STRIKETHROUGH:
+ case wxID_TOP:
case wxID_UNDELETE:
case wxID_UNDERLINE:
case wxID_UNDO:
case wxID_UNINDENT:
+ case wxID_UP:
case wxID_YES:
case wxID_ZOOM_100:
case wxID_ZOOM_FIT:
default:
return false;
- };
+ }
}
-wxString wxGetStockLabel(wxWindowID id)
+wxString wxGetStockLabel(wxWindowID id, long flags)
{
- #define STOCKITEM(stockid, label) \
- case stockid: \
- return label;
+ wxString stockLabel;
+
+#ifdef __WXMSW__
+ // special case: the "Cancel" button shouldn't have a mnemonic under MSW
+ // for consistency with the native dialogs (which don't use any mnemonic
+ // for it because it is already bound to Esc implicitly)
+ if ( id == wxID_CANCEL )
+ flags &= ~wxSTOCK_WITH_MNEMONIC;
+#endif // __WXMSW__
+
+
+ #define STOCKITEM(stockid, labelWithMnemonic, labelPlain) \
+ case stockid: \
+ if(flags & wxSTOCK_WITH_MNEMONIC) \
+ stockLabel = labelWithMnemonic; \
+ else \
+ stockLabel = labelPlain; \
+ break
switch (id)
{
- STOCKITEM(wxID_ADD, _("Add"))
- STOCKITEM(wxID_APPLY, _("&Apply"))
- STOCKITEM(wxID_BOLD, _("&Bold"))
- STOCKITEM(wxID_CANCEL, _("&Cancel"))
- STOCKITEM(wxID_CLEAR, _("&Clear"))
- STOCKITEM(wxID_CLOSE, _("&Close"))
- STOCKITEM(wxID_COPY, _("&Copy"))
- STOCKITEM(wxID_CUT, _("Cu&t"))
- STOCKITEM(wxID_DELETE, _("&Delete"))
- STOCKITEM(wxID_FIND, _("&Find"))
- STOCKITEM(wxID_REPLACE, _("Rep&lace"))
- STOCKITEM(wxID_BACKWARD, _("&Back"))
- STOCKITEM(wxID_DOWN, _("&Down"))
- STOCKITEM(wxID_FORWARD, _("&Forward"))
- STOCKITEM(wxID_UP, _("&Up"))
- STOCKITEM(wxID_HELP, _("&Help"))
- STOCKITEM(wxID_HOME, _("&Home"))
- STOCKITEM(wxID_INDENT, _("Indent"))
- STOCKITEM(wxID_INDEX, _("&Index"))
- STOCKITEM(wxID_ITALIC, _("&Italic"))
- STOCKITEM(wxID_JUSTIFY_CENTER, _("Centered"))
- STOCKITEM(wxID_JUSTIFY_FILL, _("Justified"))
- STOCKITEM(wxID_JUSTIFY_LEFT, _("Align Left"))
- STOCKITEM(wxID_JUSTIFY_RIGHT, _("Align Right"))
- STOCKITEM(wxID_NEW, _("&New"))
- STOCKITEM(wxID_NO, _("&No"))
- STOCKITEM(wxID_OK, _("&OK"))
- STOCKITEM(wxID_OPEN, _("&Open"))
- STOCKITEM(wxID_PASTE, _("&Paste"))
- STOCKITEM(wxID_PREFERENCES, _("&Preferences"))
- STOCKITEM(wxID_PRINT, _("&Print"))
- STOCKITEM(wxID_PREVIEW, _("Print previe&w"))
- STOCKITEM(wxID_PROPERTIES, _("&Properties"))
- STOCKITEM(wxID_EXIT, _("&Quit"))
- STOCKITEM(wxID_REDO, _("&Redo"))
- STOCKITEM(wxID_REFRESH, _("Refresh"))
- STOCKITEM(wxID_REMOVE, _("Remove"))
- STOCKITEM(wxID_REVERT_TO_SAVED, _("Revert to Saved"))
- STOCKITEM(wxID_SAVE, _("&Save"))
- STOCKITEM(wxID_SAVEAS, _("Save &As..."))
- STOCKITEM(wxID_STOP, _("&Stop"))
- STOCKITEM(wxID_UNDELETE, _("Undelete"))
- STOCKITEM(wxID_UNDERLINE, _("&Underline"))
- STOCKITEM(wxID_UNDO, _("&Undo"))
- STOCKITEM(wxID_UNINDENT, _("&Unindent"))
- STOCKITEM(wxID_YES, _("&Yes"))
- STOCKITEM(wxID_ZOOM_100, _("&Actual Size"))
- STOCKITEM(wxID_ZOOM_FIT, _("Zoom to &Fit"))
- STOCKITEM(wxID_ZOOM_IN, _("Zoom &In"))
- STOCKITEM(wxID_ZOOM_OUT, _("Zoom &Out"))
+ STOCKITEM(wxID_ABOUT, _("&About"), _("About"));
+ STOCKITEM(wxID_ADD, _("Add"), _("Add"));
+ STOCKITEM(wxID_APPLY, _("&Apply"), _("Apply"));
+ STOCKITEM(wxID_BACKWARD, _("&Back"), _("Back"));
+ STOCKITEM(wxID_BOLD, _("&Bold"), _("Bold"));
+ STOCKITEM(wxID_BOTTOM, _("&Bottom"), _("Bottom"));
+ STOCKITEM(wxID_CANCEL, _("&Cancel"), _("Cancel"));
+ STOCKITEM(wxID_CDROM, _("&CD-Rom"), _("CD-Rom"));
+ STOCKITEM(wxID_CLEAR, _("&Clear"), _("Clear"));
+ STOCKITEM(wxID_CLOSE, _("&Close"), _("Close"));
+ STOCKITEM(wxID_CONVERT, _("&Convert"), _("Convert"));
+ STOCKITEM(wxID_COPY, _("&Copy"), _("Copy"));
+ STOCKITEM(wxID_CUT, _("Cu&t"), _("Cut"));
+ STOCKITEM(wxID_DELETE, _("&Delete"), _("Delete"));
+ STOCKITEM(wxID_DOWN, _("&Down"), _("Down"));
+ STOCKITEM(wxID_EDIT, _("&Edit"), _("Edit"));
+ STOCKITEM(wxID_EXECUTE, _("&Execute"), _("Execute"));
+ STOCKITEM(wxID_EXIT, _("&Quit"), _("Quit"));
+ STOCKITEM(wxID_FILE, _("&File"), _("File"));
+ STOCKITEM(wxID_FIND, _("&Find"), _("Find"));
+ STOCKITEM(wxID_FIRST, _("&First"), _("First"));
+ STOCKITEM(wxID_FLOPPY, _("&Floppy"), _("Floppy"));
+ STOCKITEM(wxID_FORWARD, _("&Forward"), _("Forward"));
+ STOCKITEM(wxID_HARDDISK, _("&Harddisk"), _("Harddisk"));
+ STOCKITEM(wxID_HELP, _("&Help"), _("Help"));
+ STOCKITEM(wxID_HOME, _("&Home"), _("Home"));
+ STOCKITEM(wxID_INDENT, _("Indent"), _("Indent"));
+ STOCKITEM(wxID_INDEX, _("&Index"), _("Index"));
+ STOCKITEM(wxID_INFO, _("&Info"), _("Info"));
+ STOCKITEM(wxID_ITALIC, _("&Italic"), _("Italic"));
+ STOCKITEM(wxID_JUMP_TO, _("&Jump to"), _("Jump to"));
+ STOCKITEM(wxID_JUSTIFY_CENTER, _("Centered"), _("Centered"));
+ STOCKITEM(wxID_JUSTIFY_FILL, _("Justified"), _("Justified"));
+ STOCKITEM(wxID_JUSTIFY_LEFT, _("Align Left"), _("Align Left"));
+ STOCKITEM(wxID_JUSTIFY_RIGHT, _("Align Right"), _("Align Right"));
+ STOCKITEM(wxID_LAST, _("&Last"), _("Last"));
+ STOCKITEM(wxID_NETWORK, _("&Network"), _("Network"));
+ STOCKITEM(wxID_NEW, _("&New"), _("New"));
+ STOCKITEM(wxID_NO, _("&No"), _("No"));
+ STOCKITEM(wxID_OK, _("&OK"), _("OK"));
+ STOCKITEM(wxID_OPEN, _("&Open..."), _("Open..."));
+ STOCKITEM(wxID_PASTE, _("&Paste"), _("Paste"));
+ STOCKITEM(wxID_PREFERENCES, _("&Preferences"), _("Preferences"));
+ STOCKITEM(wxID_PREVIEW, _("Print previe&w..."), _("Print preview..."));
+ STOCKITEM(wxID_PRINT, _("&Print..."), _("Print..."));
+ STOCKITEM(wxID_PROPERTIES, _("&Properties"), _("Properties"));
+ STOCKITEM(wxID_REDO, _("&Redo"), _("Redo"));
+ STOCKITEM(wxID_REFRESH, _("Refresh"), _("Refresh"));
+ STOCKITEM(wxID_REMOVE, _("Remove"), _("Remove"));
+ STOCKITEM(wxID_REPLACE, _("Rep&lace"), _("Replace"));
+ STOCKITEM(wxID_REVERT_TO_SAVED, _("Revert to Saved"), _("Revert to Saved"));
+ STOCKITEM(wxID_SAVE, _("&Save"), _("Save"));
+ STOCKITEM(wxID_SAVEAS, _("&Save as"), _("Save as"));
+ STOCKITEM(wxID_SELECTALL, _("Select &All"), _("Select All"));
+ STOCKITEM(wxID_SELECT_COLOR, _("&Color"), _("Color"));
+ STOCKITEM(wxID_SELECT_FONT, _("&Font"), _("Font"));
+ STOCKITEM(wxID_SORT_ASCENDING, _("&Ascending"), _("Ascending"));
+ STOCKITEM(wxID_SORT_DESCENDING, _("&Descending"), _("Descending"));
+ STOCKITEM(wxID_SPELL_CHECK, _("&Spell Check"), _("Spell Check"));
+ STOCKITEM(wxID_STOP, _("&Stop"), _("Stop"));
+ STOCKITEM(wxID_STRIKETHROUGH, _("&Strikethrough"), _("Strikethrough"));
+ STOCKITEM(wxID_TOP, _("&Top"), _("Top"));
+ STOCKITEM(wxID_UNDELETE, _("Undelete"), _("Undelete"));
+ STOCKITEM(wxID_UNDERLINE, _("&Underline"), _("Underline"));
+ STOCKITEM(wxID_UNDO, _("&Undo"), _("Undo"));
+ STOCKITEM(wxID_UNINDENT, _("&Unindent"), _("Unindent"));
+ STOCKITEM(wxID_UP, _("&Up"), _("Up"));
+ STOCKITEM(wxID_YES, _("&Yes"), _("Yes"));
+ STOCKITEM(wxID_ZOOM_100, _("&Actual Size"), _("Actual Size"));
+ STOCKITEM(wxID_ZOOM_FIT, _("Zoom to &Fit"), _("Zoom to Fit"));
+ STOCKITEM(wxID_ZOOM_IN, _("Zoom &In"), _("Zoom In"));
+ STOCKITEM(wxID_ZOOM_OUT, _("Zoom &Out"), _("Zoom Out"));
default:
- wxFAIL_MSG( _T("invalid stock item ID") );
+ wxFAIL_MSG( wxT("invalid stock item ID") );
break;
};
#undef STOCKITEM
-
- return wxEmptyString;
+
+ if ( flags & wxSTOCK_WITHOUT_ELLIPSIS )
+ {
+ wxString baseLabel;
+ if ( stockLabel.EndsWith("...", &baseLabel) )
+ stockLabel = baseLabel;
+
+ // accelerators only make sense for the menu items which should have
+ // ellipsis too while wxSTOCK_WITHOUT_ELLIPSIS is mostly useful for
+ // buttons which shouldn't have accelerators in their labels
+ wxASSERT_MSG( !(flags & wxSTOCK_WITH_ACCELERATOR),
+ "labels without ellipsis shouldn't use accelerators" );
+ }
+
+#if wxUSE_ACCEL
+ if ( !stockLabel.empty() && (flags & wxSTOCK_WITH_ACCELERATOR) )
+ {
+ wxAcceleratorEntry accel = wxGetStockAccelerator(id);
+ if (accel.IsOk())
+ stockLabel << wxT('\t') << accel.ToString();
+ }
+#endif // wxUSE_ACCEL
+
+ return stockLabel;
}
-bool wxIsStockLabel(wxWindowID id, const wxString& label)
+wxString wxGetStockHelpString(wxWindowID id, wxStockHelpStringClient client)
{
- if (label.empty())
- return true;
+ wxString stockHelp;
- wxString stock = wxGetStockLabel(id);
+ #define STOCKITEM(stockid, ctx, helpstr) \
+ case stockid: \
+ if (client==ctx) stockHelp = helpstr; \
+ break;
- if (label == stock)
- return true;
-
- stock.Replace(_T("&"), wxEmptyString);
- if (label == stock)
- return true;
-
- return false;
-}
+ switch (id)
+ {
+ // NB: these help string should be not too specific as they could be used
+ // in completely different programs!
+ STOCKITEM(wxID_ABOUT, wxSTOCK_MENU, _("Show about dialog"))
+ STOCKITEM(wxID_COPY, wxSTOCK_MENU, _("Copy selection"))
+ STOCKITEM(wxID_CUT, wxSTOCK_MENU, _("Cut selection"))
+ STOCKITEM(wxID_DELETE, wxSTOCK_MENU, _("Delete selection"))
+ STOCKITEM(wxID_REPLACE, wxSTOCK_MENU, _("Replace selection"))
+ STOCKITEM(wxID_PASTE, wxSTOCK_MENU, _("Paste selection"))
+ STOCKITEM(wxID_EXIT, wxSTOCK_MENU, _("Quit this program"))
+ STOCKITEM(wxID_REDO, wxSTOCK_MENU, _("Redo last action"))
+ STOCKITEM(wxID_UNDO, wxSTOCK_MENU, _("Undo last action"))
+ STOCKITEM(wxID_CLOSE, wxSTOCK_MENU, _("Close current document"))
+ STOCKITEM(wxID_SAVE, wxSTOCK_MENU, _("Save current document"))
+ STOCKITEM(wxID_SAVEAS, wxSTOCK_MENU, _("Save current document with a different filename"))
+
+ default:
+ // there's no stock help string for this ID / client
+ return wxEmptyString;
+ }
+ #undef STOCKITEM
-#ifdef __WXGTK20__
+ return stockHelp;
+}
-#include <gtk/gtk.h>
+#if wxUSE_ACCEL
-const char *wxGetStockGtkID(wxWindowID id)
+wxAcceleratorEntry wxGetStockAccelerator(wxWindowID id)
{
- #define STOCKITEM(wx,gtk) \
- case wx: \
- return gtk;
-
- #define STOCKITEM_MISSING(wx) \
- case wxid: \
- return NULL;
-
- #if GTK_CHECK_VERSION(2,4,0)
- #define STOCKITEM_24(wx,gtk) STOCKITEM(wx,gtk)
- #else
- #define STOCKITEM_24(wx,gtk) STOCKITEM_MISSING(wx)
- #endif
+ wxAcceleratorEntry ret;
+
+ #define STOCKITEM(stockid, flags, keycode) \
+ case stockid: \
+ ret.Set(flags, keycode, stockid); \
+ break;
switch (id)
{
- STOCKITEM(wxID_ADD, GTK_STOCK_ADD)
- STOCKITEM(wxID_APPLY, GTK_STOCK_APPLY)
- STOCKITEM(wxID_BOLD, GTK_STOCK_BOLD)
- STOCKITEM(wxID_CANCEL, GTK_STOCK_CANCEL)
- STOCKITEM(wxID_CLEAR, GTK_STOCK_CLEAR)
- STOCKITEM(wxID_CLOSE, GTK_STOCK_CLOSE)
- STOCKITEM(wxID_COPY, GTK_STOCK_COPY)
- STOCKITEM(wxID_CUT, GTK_STOCK_CUT)
- STOCKITEM(wxID_DELETE, GTK_STOCK_DELETE)
- STOCKITEM(wxID_FIND, GTK_STOCK_FIND)
- STOCKITEM(wxID_REPLACE, GTK_STOCK_FIND_AND_REPLACE)
- STOCKITEM(wxID_BACKWARD, GTK_STOCK_GO_BACK)
- STOCKITEM(wxID_DOWN, GTK_STOCK_GO_DOWN)
- STOCKITEM(wxID_FORWARD, GTK_STOCK_GO_FORWARD)
- STOCKITEM(wxID_UP, GTK_STOCK_GO_UP)
- STOCKITEM(wxID_HELP, GTK_STOCK_HELP)
- STOCKITEM(wxID_HOME, GTK_STOCK_HOME)
- STOCKITEM_24(wxID_INDENT, GTK_STOCK_INDENT)
- STOCKITEM(wxID_INDEX, GTK_STOCK_INDEX)
- STOCKITEM(wxID_ITALIC, GTK_STOCK_ITALIC)
- STOCKITEM(wxID_JUSTIFY_CENTER, GTK_STOCK_JUSTIFY_CENTER)
- STOCKITEM(wxID_JUSTIFY_FILL, GTK_STOCK_JUSTIFY_FILL)
- STOCKITEM(wxID_JUSTIFY_LEFT, GTK_STOCK_JUSTIFY_LEFT)
- STOCKITEM(wxID_JUSTIFY_RIGHT, GTK_STOCK_JUSTIFY_RIGHT)
- STOCKITEM(wxID_NEW, GTK_STOCK_NEW)
- STOCKITEM(wxID_NO, GTK_STOCK_NO)
- STOCKITEM(wxID_OK, GTK_STOCK_OK)
- STOCKITEM(wxID_OPEN, GTK_STOCK_OPEN)
- STOCKITEM(wxID_PASTE, GTK_STOCK_PASTE)
- STOCKITEM(wxID_PREFERENCES, GTK_STOCK_PREFERENCES)
- STOCKITEM(wxID_PRINT, GTK_STOCK_PRINT)
- STOCKITEM(wxID_PREVIEW, GTK_STOCK_PRINT_PREVIEW)
- STOCKITEM(wxID_PROPERTIES, GTK_STOCK_PROPERTIES)
- STOCKITEM(wxID_EXIT, GTK_STOCK_QUIT)
- STOCKITEM(wxID_REDO, GTK_STOCK_REDO)
- STOCKITEM(wxID_REFRESH, GTK_STOCK_REFRESH)
- STOCKITEM(wxID_REMOVE, GTK_STOCK_REMOVE)
- STOCKITEM(wxID_REVERT_TO_SAVED, GTK_STOCK_REVERT_TO_SAVED)
- STOCKITEM(wxID_SAVE, GTK_STOCK_SAVE)
- STOCKITEM(wxID_SAVEAS, GTK_STOCK_SAVE_AS)
- STOCKITEM(wxID_STOP, GTK_STOCK_STOP)
- STOCKITEM(wxID_UNDELETE, GTK_STOCK_UNDELETE)
- STOCKITEM(wxID_UNDERLINE, GTK_STOCK_UNDERLINE)
- STOCKITEM(wxID_UNDO, GTK_STOCK_UNDO)
- STOCKITEM_24(wxID_UNINDENT, GTK_STOCK_UNINDENT)
- STOCKITEM(wxID_YES, GTK_STOCK_YES)
- STOCKITEM(wxID_ZOOM_100, GTK_STOCK_ZOOM_100)
- STOCKITEM(wxID_ZOOM_FIT, GTK_STOCK_ZOOM_FIT)
- STOCKITEM(wxID_ZOOM_IN, GTK_STOCK_ZOOM_IN)
- STOCKITEM(wxID_ZOOM_OUT, GTK_STOCK_ZOOM_OUT)
+ STOCKITEM(wxID_COPY, wxACCEL_CTRL,'C')
+ STOCKITEM(wxID_CUT, wxACCEL_CTRL,'X')
+ STOCKITEM(wxID_FIND, wxACCEL_CTRL,'F')
+ STOCKITEM(wxID_HELP, wxACCEL_CTRL,'H')
+ STOCKITEM(wxID_NEW, wxACCEL_CTRL,'N')
+ STOCKITEM(wxID_OPEN, wxACCEL_CTRL,'O')
+ STOCKITEM(wxID_PASTE, wxACCEL_CTRL,'V')
+ STOCKITEM(wxID_PRINT, wxACCEL_CTRL,'P')
+ STOCKITEM(wxID_REDO, wxACCEL_CTRL | wxACCEL_SHIFT,'Z')
+ STOCKITEM(wxID_REPLACE, wxACCEL_CTRL,'R')
+ STOCKITEM(wxID_SAVE, wxACCEL_CTRL,'S')
+ STOCKITEM(wxID_UNDO, wxACCEL_CTRL,'Z')
+#ifdef __WXOSX__
+ STOCKITEM(wxID_PREFERENCES, wxACCEL_CTRL,',')
+#endif
default:
- wxFAIL_MSG( _T("invalid stock item ID") );
+ // set the wxAcceleratorEntry to return into an invalid state:
+ // there's no stock accelerator for that.
+ ret.Set(0, 0, id);
break;
};
#undef STOCKITEM
-
- return NULL;
+
+ // always use wxAcceleratorEntry::IsOk on returned value !
+ return ret;
}
-#endif // __WXGTK20__
+#endif // wxUSE_ACCEL
+
+bool wxIsStockLabel(wxWindowID id, const wxString& label)
+{
+ if (label.empty())
+ return true;
+
+ wxString stock = wxGetStockLabel(id);
+
+ if (label == stock)
+ return true;
+
+ stock.Replace(wxT("&"), wxEmptyString);
+ if (label == stock)
+ return true;
+
+ return false;
+}