226 lines
8.0 KiB
C++
226 lines
8.0 KiB
C++
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: wx/button.h
|
|
// Purpose: wxButtonBase class
|
|
// Author: Vadim Zetlin
|
|
// Modified by:
|
|
// Created: 15.08.00
|
|
// RCS-ID: $Id: button.h 65680 2010-09-30 11:44:45Z VZ $
|
|
// Copyright: (c) Vadim Zetlin
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef _WX_BUTTON_H_BASE_
|
|
#define _WX_BUTTON_H_BASE_
|
|
|
|
#include "wx/defs.h"
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// wxButton flags shared with other classes
|
|
// ----------------------------------------------------------------------------
|
|
|
|
#if wxUSE_TOGGLEBTN || wxUSE_BUTTON
|
|
|
|
// These flags affect label alignment
|
|
#define wxBU_LEFT 0x0040
|
|
#define wxBU_TOP 0x0080
|
|
#define wxBU_RIGHT 0x0100
|
|
#define wxBU_BOTTOM 0x0200
|
|
#define wxBU_ALIGN_MASK ( wxBU_LEFT | wxBU_TOP | wxBU_RIGHT | wxBU_BOTTOM )
|
|
#endif
|
|
|
|
#if wxUSE_BUTTON
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// wxButton specific flags
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// These two flags are obsolete
|
|
#define wxBU_NOAUTODRAW 0x0000
|
|
#define wxBU_AUTODRAW 0x0004
|
|
|
|
// by default, the buttons will be created with some (system dependent)
|
|
// minimal size to make them look nicer, giving this style will make them as
|
|
// small as possible
|
|
#define wxBU_EXACTFIT 0x0001
|
|
|
|
// this flag can be used to disable using the text label in the button: it is
|
|
// mostly useful when creating buttons showing bitmap and having stock id as
|
|
// without it both the standard label corresponding to the stock id and the
|
|
// bitmap would be shown
|
|
#define wxBU_NOTEXT 0x0002
|
|
|
|
|
|
#include "wx/bitmap.h"
|
|
#include "wx/control.h"
|
|
|
|
extern WXDLLIMPEXP_DATA_CORE(const char) wxButtonNameStr[];
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// wxButton: a push button
|
|
// ----------------------------------------------------------------------------
|
|
|
|
class WXDLLIMPEXP_CORE wxButtonBase : public wxControl
|
|
{
|
|
public:
|
|
wxButtonBase() { }
|
|
|
|
// show the authentication needed symbol on the button: this is currently
|
|
// only implemented on Windows Vista and newer (on which it shows the UAC
|
|
// shield symbol)
|
|
void SetAuthNeeded(bool show = true) { DoSetAuthNeeded(show); }
|
|
bool GetAuthNeeded() const { return DoGetAuthNeeded(); }
|
|
|
|
// show the image in the button in addition to the label: this method is
|
|
// supported on all (major) platforms
|
|
void SetBitmap(const wxBitmap& bitmap, wxDirection dir = wxLEFT)
|
|
{
|
|
SetBitmapLabel(bitmap);
|
|
SetBitmapPosition(dir);
|
|
}
|
|
|
|
wxBitmap GetBitmap() const { return DoGetBitmap(State_Normal); }
|
|
|
|
// Methods for setting individual images for different states: normal,
|
|
// selected (meaning pushed or pressed), focused (meaning normal state for
|
|
// a focused button), disabled or hover (a.k.a. hot or current).
|
|
//
|
|
// Remember that SetBitmap() itself must be called before any other
|
|
// SetBitmapXXX() methods (except for SetBitmapLabel() which is a synonym
|
|
// for it anyhow) and that all bitmaps passed to these functions should be
|
|
// of the same size.
|
|
void SetBitmapLabel(const wxBitmap& bitmap)
|
|
{ DoSetBitmap(bitmap, State_Normal); }
|
|
void SetBitmapPressed(const wxBitmap& bitmap)
|
|
{ DoSetBitmap(bitmap, State_Pressed); }
|
|
void SetBitmapDisabled(const wxBitmap& bitmap)
|
|
{ DoSetBitmap(bitmap, State_Disabled); }
|
|
void SetBitmapCurrent(const wxBitmap& bitmap)
|
|
{ DoSetBitmap(bitmap, State_Current); }
|
|
void SetBitmapFocus(const wxBitmap& bitmap)
|
|
{ DoSetBitmap(bitmap, State_Focused); }
|
|
|
|
wxBitmap GetBitmapLabel() const { return DoGetBitmap(State_Normal); }
|
|
wxBitmap GetBitmapPressed() const { return DoGetBitmap(State_Pressed); }
|
|
wxBitmap GetBitmapDisabled() const { return DoGetBitmap(State_Disabled); }
|
|
wxBitmap GetBitmapCurrent() const { return DoGetBitmap(State_Current); }
|
|
wxBitmap GetBitmapFocus() const { return DoGetBitmap(State_Focused); }
|
|
|
|
|
|
// set the margins around the image
|
|
void SetBitmapMargins(wxCoord x, wxCoord y) { DoSetBitmapMargins(x, y); }
|
|
void SetBitmapMargins(const wxSize& sz) { DoSetBitmapMargins(sz.x, sz.y); }
|
|
wxSize GetBitmapMargins() { return DoGetBitmapMargins(); }
|
|
|
|
// set the image position relative to the text, i.e. wxLEFT means that the
|
|
// image is to the left of the text (this is the default)
|
|
void SetBitmapPosition(wxDirection dir);
|
|
|
|
|
|
// make this button the default button in its top level window
|
|
//
|
|
// returns the old default item (possibly NULL)
|
|
virtual wxWindow *SetDefault();
|
|
|
|
// Buttons on MSW can look bad if they are not native colours, because
|
|
// then they become owner-drawn and not theme-drawn. Disable it here
|
|
// in wxButtonBase to make it consistent.
|
|
virtual bool ShouldInheritColours() const { return false; }
|
|
|
|
// returns the default button size for this platform
|
|
static wxSize GetDefaultSize();
|
|
|
|
// wxUniv-compatible and deprecated equivalents to SetBitmapXXX()
|
|
#if WXWIN_COMPATIBILITY_2_8
|
|
void SetImageLabel(const wxBitmap& bitmap) { SetBitmap(bitmap); }
|
|
void SetImageMargins(wxCoord x, wxCoord y) { SetBitmapMargins(x, y); }
|
|
#endif // WXWIN_COMPATIBILITY_2_8
|
|
|
|
// backwards compatible names for pressed/current bitmaps: they're not
|
|
// deprecated as there is nothing really wrong with using them and no real
|
|
// advantage to using the new names but the new names are still preferred
|
|
wxBitmap GetBitmapSelected() const { return GetBitmapPressed(); }
|
|
wxBitmap GetBitmapHover() const { return GetBitmapCurrent(); }
|
|
|
|
void SetBitmapSelected(const wxBitmap& bitmap) { SetBitmapPressed(bitmap); }
|
|
void SetBitmapHover(const wxBitmap& bitmap) { SetBitmapCurrent(bitmap); }
|
|
|
|
|
|
// this enum is not part of wx public API, it is public because it is used
|
|
// in non wxButton-derived classes internally
|
|
//
|
|
// also notice that MSW code relies on the values of the enum elements, do
|
|
// not change them without revising src/msw/button.cpp
|
|
enum State
|
|
{
|
|
State_Normal,
|
|
State_Current, // a.k.a. hot or "hovering"
|
|
State_Pressed, // a.k.a. "selected" in public API for some reason
|
|
State_Disabled,
|
|
State_Focused,
|
|
State_Max
|
|
};
|
|
|
|
// return true if this button shouldn't show the text label, either because
|
|
// it doesn't have it or because it was explicitly disabled with wxBU_NOTEXT
|
|
bool DontShowLabel() const
|
|
{
|
|
return HasFlag(wxBU_NOTEXT) || GetLabel().empty();
|
|
}
|
|
|
|
// return true if we do show the label
|
|
bool ShowsLabel() const
|
|
{
|
|
return !DontShowLabel();
|
|
}
|
|
|
|
protected:
|
|
// choose the default border for this window
|
|
virtual wxBorder GetDefaultBorder() const { return wxBORDER_NONE; }
|
|
|
|
virtual bool DoGetAuthNeeded() const { return false; }
|
|
virtual void DoSetAuthNeeded(bool WXUNUSED(show)) { }
|
|
|
|
virtual wxBitmap DoGetBitmap(State WXUNUSED(which)) const
|
|
{ return wxBitmap(); }
|
|
virtual void DoSetBitmap(const wxBitmap& WXUNUSED(bitmap),
|
|
State WXUNUSED(which))
|
|
{ }
|
|
|
|
virtual wxSize DoGetBitmapMargins() const
|
|
{ return wxSize(0, 0); }
|
|
|
|
virtual void DoSetBitmapMargins(wxCoord WXUNUSED(x), wxCoord WXUNUSED(y))
|
|
{ }
|
|
|
|
virtual void DoSetBitmapPosition(wxDirection WXUNUSED(dir))
|
|
{ }
|
|
|
|
|
|
wxDECLARE_NO_COPY_CLASS(wxButtonBase);
|
|
};
|
|
|
|
#if defined(__WXUNIVERSAL__)
|
|
#include "wx/univ/button.h"
|
|
#elif defined(__WXMSW__)
|
|
#include "wx/msw/button.h"
|
|
#elif defined(__WXMOTIF__)
|
|
#include "wx/motif/button.h"
|
|
#elif defined(__WXGTK20__)
|
|
#include "wx/gtk/button.h"
|
|
#elif defined(__WXGTK__)
|
|
#include "wx/gtk1/button.h"
|
|
#elif defined(__WXMAC__)
|
|
#include "wx/osx/button.h"
|
|
#elif defined(__WXCOCOA__)
|
|
#include "wx/cocoa/button.h"
|
|
#elif defined(__WXPM__)
|
|
#include "wx/os2/button.h"
|
|
#elif defined(__WXPALMOS__)
|
|
#include "wx/palmos/button.h"
|
|
#endif
|
|
|
|
#endif // wxUSE_BUTTON
|
|
|
|
#endif
|
|
// _WX_BUTTON_H_BASE_
|