wxWidgets/interface/statbmp.h
2008-03-08 13:52:38 +00:00

111 lines
3.1 KiB
Objective-C

/////////////////////////////////////////////////////////////////////////////
// Name: statbmp.h
// Purpose: documentation for wxStaticBitmap class
// Author: wxWidgets team
// RCS-ID: $Id$
// Licence: wxWindows license
/////////////////////////////////////////////////////////////////////////////
/**
@class wxStaticBitmap
@wxheader{statbmp.h}
A static bitmap control displays a bitmap. It is meant for display of the
small icons in the dialog boxes and is not meant to be a general purpose image
display control. In particular, under Windows 9x the size of bitmap is limited
to 64*64 pixels and thus you should use your own control if you want to
display larger images portably.
@library{wxcore}
@category{ctrl}
@appearance{staticbitmap.png}
@seealso
wxStaticBitmap, wxStaticBox
*/
class wxStaticBitmap : public wxControl
{
public:
//@{
/**
Constructor, creating and showing a static bitmap control.
@param parent
Parent window. Should not be @NULL.
@param id
Control identifier. A value of -1 denotes a default value.
@param label
Bitmap label.
@param pos
Window position.
@param size
Window size.
@param style
Window style. See wxStaticBitmap.
@param name
Window name.
@sa Create()
*/
wxStaticBitmap();
wxStaticBitmap(wxWindow* parent, wxWindowID id,
const wxBitmap& label,
const wxPoint& pos = wxDefaultPosition,
const wxSize& size = wxDefaultSize,
long style = 0,
const wxString& name = "staticBitmap");
//@}
/**
Creation function, for two-step construction. For details see wxStaticBitmap().
*/
bool Create(wxWindow* parent, wxWindowID id,
const wxBitmap& label,
const wxPoint& pos = wxDefaultPosition,
const wxSize& size = wxDefaultSize,
long style = 0,
const wxString& name = "staticBitmap");
/**
Returns the bitmap currently used in the control. Notice that this method can
be called even if SetIcon() had been used.
@sa SetBitmap()
*/
wxBitmap GetBitmap();
/**
Returns the icon currently used in the control. Notice that this method can
only be called if SetIcon() had been used: an icon
can't be retrieved from the control if a bitmap had been set (using
wxStaticBitmap::SetBitmap).
@sa SetIcon()
*/
wxIcon GetIcon();
/**
Sets the bitmap label.
@param label
The new bitmap.
@sa GetBitmap()
*/
virtual void SetBitmap(const wxBitmap& label);
/**
Sets the label to the given icon.
@param label
The new icon.
*/
virtual void SetIcon(const wxIcon& label);
};