2004-08-15 15:56:56 +00:00
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
// Name: wx/stockitem.h
|
2004-08-30 14:42:51 +00:00
|
|
|
// Purpose: stock items helpers (privateh header)
|
2004-08-15 15:56:56 +00:00
|
|
|
// Author: Vaclav Slavik
|
|
|
|
// Modified by:
|
|
|
|
// Created: 2004-08-15
|
|
|
|
// RCS-ID: $Id$
|
|
|
|
// Copyright: (c) Vaclav Slavik, 2004
|
|
|
|
// Licence: wxWindows licence
|
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
|
|
|
|
#ifndef _WX_STOCKITEM_H_
|
|
|
|
#define _WX_STOCKITEM_H_
|
|
|
|
|
|
|
|
#include "wx/defs.h"
|
2007-03-19 14:45:38 +00:00
|
|
|
#include "wx/chartype.h"
|
2004-08-15 15:56:56 +00:00
|
|
|
#include "wx/string.h"
|
2006-09-03 12:23:04 +00:00
|
|
|
#include "wx/accel.h"
|
2004-08-15 15:56:56 +00:00
|
|
|
|
|
|
|
// ----------------------------------------------------------------------------
|
2004-08-30 14:42:51 +00:00
|
|
|
// Helper functions for stock items handling:
|
2004-08-15 15:56:56 +00:00
|
|
|
// ----------------------------------------------------------------------------
|
|
|
|
|
2004-08-30 14:42:51 +00:00
|
|
|
// Returns true if the ID is in the list of recognized stock actions
|
2008-03-26 15:06:00 +00:00
|
|
|
WXDLLIMPEXP_CORE bool wxIsStockID(wxWindowID id);
|
2004-08-15 15:56:56 +00:00
|
|
|
|
2004-08-30 14:42:51 +00:00
|
|
|
// Returns true of the label is empty or label of a stock button with
|
|
|
|
// given ID
|
2008-03-26 15:06:00 +00:00
|
|
|
WXDLLIMPEXP_CORE bool wxIsStockLabel(wxWindowID id, const wxString& label);
|
2004-08-15 15:56:56 +00:00
|
|
|
|
2006-09-03 12:23:04 +00:00
|
|
|
enum wxStockLabelQueryFlag
|
|
|
|
{
|
|
|
|
wxSTOCK_NOFLAGS = 0,
|
|
|
|
|
|
|
|
wxSTOCK_WITH_MNEMONIC = 1,
|
2009-07-25 16:41:05 +00:00
|
|
|
wxSTOCK_WITH_ACCELERATOR = 2,
|
|
|
|
|
2010-02-04 01:33:32 +00:00
|
|
|
// by default, stock items text is returned with ellipsis, if appropriate,
|
|
|
|
// this flag allows to avoid having it
|
|
|
|
wxSTOCK_WITHOUT_ELLIPSIS = 4,
|
|
|
|
|
|
|
|
// return label for button, not menu item: buttons should always use
|
|
|
|
// mnemonics and never use ellipsis
|
|
|
|
wxSTOCK_FOR_BUTTON = wxSTOCK_WITHOUT_ELLIPSIS | wxSTOCK_WITH_MNEMONIC
|
2006-09-03 12:23:04 +00:00
|
|
|
};
|
|
|
|
|
2004-08-15 15:56:56 +00:00
|
|
|
// Returns label that should be used for given stock UI element (e.g. "&OK"
|
2006-09-03 12:23:04 +00:00
|
|
|
// for wxSTOCK_OK); if wxSTOCK_WITH_MNEMONIC is given, the & character
|
|
|
|
// is included; if wxSTOCK_WITH_ACCELERATOR is given, the stock accelerator
|
|
|
|
// for given ID is concatenated to the label using \t as separator
|
2008-03-26 15:06:00 +00:00
|
|
|
WXDLLIMPEXP_CORE wxString wxGetStockLabel(wxWindowID id,
|
2006-09-03 12:23:04 +00:00
|
|
|
long flags = wxSTOCK_WITH_MNEMONIC);
|
|
|
|
|
2006-09-04 19:22:57 +00:00
|
|
|
#if wxUSE_ACCEL
|
|
|
|
|
|
|
|
// Returns the accelerator that should be used for given stock UI element
|
|
|
|
// (e.g. "Ctrl+x" for wxSTOCK_EXIT)
|
2008-03-26 15:06:00 +00:00
|
|
|
WXDLLIMPEXP_CORE wxAcceleratorEntry wxGetStockAccelerator(wxWindowID id);
|
2006-09-04 19:22:57 +00:00
|
|
|
|
|
|
|
#endif
|
2004-08-15 15:56:56 +00:00
|
|
|
|
2006-09-05 21:00:55 +00:00
|
|
|
// wxStockHelpStringClient conceptually works like wxArtClient: it gives a hint to
|
|
|
|
// wxGetStockHelpString() about the context where the help string is to be used
|
|
|
|
enum wxStockHelpStringClient
|
|
|
|
{
|
|
|
|
wxSTOCK_MENU // help string to use for menu items
|
|
|
|
};
|
|
|
|
|
|
|
|
// Returns an help string for the given stock UI element and for the given "context".
|
2008-03-26 15:06:00 +00:00
|
|
|
WXDLLIMPEXP_CORE wxString wxGetStockHelpString(wxWindowID id,
|
2006-09-05 21:00:55 +00:00
|
|
|
wxStockHelpStringClient client = wxSTOCK_MENU);
|
|
|
|
|
|
|
|
|
2004-08-15 15:56:56 +00:00
|
|
|
#ifdef __WXGTK20__
|
2006-09-03 12:23:04 +00:00
|
|
|
|
2004-08-15 15:56:56 +00:00
|
|
|
// Translates stock ID to GTK+'s stock item string indentifier:
|
2008-03-26 15:06:00 +00:00
|
|
|
WXDLLIMPEXP_CORE const char *wxGetStockGtkID(wxWindowID id);
|
2006-09-03 12:23:04 +00:00
|
|
|
|
2004-08-15 15:56:56 +00:00
|
|
|
#endif
|
|
|
|
|
|
|
|
#endif // _WX_STOCKITEM_H_
|