/**
- Bitmap flags.
+ Bitmap type flags.
+
+ See wxBitmap and wxImage classes.
*/
enum wxBitmapType
{
/**
Standard cursors.
+
+ See wxCursor.
*/
enum wxStockCursor
{
@wxheader{gdicmn.h}
A @b wxRealPoint is a useful data structure for graphics operations.
+
It contains floating point @e x and @e y members.
See also wxPoint for an integer version.
class wxRealPoint
{
public:
- //@{
+ wxRealPoint();
+
/**
- Create a point.
- double x
- double y
- Members of the @b wxRealPoint object.
+ Initializes the point with the given coordinates.
*/
- wxRealPoint();
wxRealPoint(double x, double y);
- //@}
+
+ /**
+ X coordinate of this point.
+ */
+ double x;
+
+ /**
+ Y coordinate of this point.
+ */
+ double y;
};
rectangle thus change by 2*@a dx and 2*@e dy, respectively.) If one or
both of @a dx and @a dy are negative, the opposite happens: the rectangle
size decreases in the respective direction.
- Inflating and deflating behaves "naturally''. Defined more precisely, that
+ Inflating and deflating behaves "naturally". Defined more precisely, that
means:
- "Real'' inflates (that is, @a dx and/or @a dy = 0) are not
+ "Real" inflates (that is, @a dx and/or @a dy = 0) are not
constrained. Thus inflating a rectangle can cause its upper left corner
to move into the negative numbers. (the versions prior to 2.5.4 forced
the top left coordinate to not fall below (0, 0), which implied a
@library{wxcore}
@category{data}
+ @stdobjects
+ ::wxDefaultPosition
+
@see wxRealPoint
*/
class wxPoint
*/
};
+/**
+ Global istance of a wxPoint initialized with values -1;-1.
+*/
+wxPoint wxDefaultPosition;
/**
@wxheader{gdicmn.h}
wxWidgets maintains a database of standard RGB colours for a predefined
- set of named colours (such as "BLACK'', "LIGHT GREY''). The
+ set of named colours (such as "BLACK", "LIGHT GREY"). The
application may add to this set if desired by using
wxColourDatabase::AddColour and may use it to look up
colours by names using wxColourDatabase::Find or find the names
};
-
-/**
- @class wxFontList
- @wxheader{gdicmn.h}
-
- A font list is a list containing all fonts which have been created. There
- is only one instance of this class: @b wxTheFontList. Use this object to search
- for a previously created font of the desired type and create it if not already
- found.
- In some windowing systems, the font may be a scarce resource, so it is best to
- reuse old resources if possible. When an application finishes, all fonts will
- be
- deleted and their resources freed, eliminating the possibility of 'memory
- leaks'.
-
- @library{wxcore}
- @category{gdi}
-
- @see wxFont
-*/
-class wxFontList : public wxList
-{
-public:
- /**
- Constructor. The application should not construct its own font list:
- use the object pointer @b wxTheFontList.
- */
- wxFontList();
-
- /**
- Finds a font of the given specification, or creates one and adds it to the
- list. See the @ref wxFont::ctor "wxFont constructor" for
- details of the arguments.
- */
- wxFont* FindOrCreateFont(int point_size, int family, int style,
- int weight,
- bool underline = false,
- const wxString& facename = NULL,
- wxFontEncoding encoding = wxFONTENCODING_DEFAULT);
-};
-
-
-
/**
@class wxSize
@wxheader{gdicmn.h}
named @c width and @c height since it makes much more sense for
sizes.
-
@library{wxcore}
@category{data}
+ @stdobjects
+ ::wxDefaultSize
+
@see wxPoint, wxRealPoint
*/
class wxSize
void SetWidth(int width);
};
+/**
+ Global instance of a wxSize object initialized with values -1;-1.
+*/
+wxSize wxDefaultSize;
//@{
/**
- Returns the dimensions of the work area on the display. On Windows
- this means the area not covered by the taskbar, etc. Other platforms
- are currently defaulting to the whole display until a way is found to
- provide this info for all window managers, etc.
+ This macro loads a bitmap from either application resources (on the
+ platforms for which they exist, i.e. Windows and OS2) or from an XPM file.
+ This can help to avoid using @ifdef_ when creating bitmaps.
+
+ @see @ref overview_bitmap, wxICON()
+
+ @header{wx/gdicmn.h}
*/
-void wxClientDisplayRect(int* x, int* y, int* width,
- int* height);
-wxRect wxGetClientDisplayRect();
+#define wxBITMAP(bitmapName)
/**
- Returns the display size in pixels.
+ This macro loads an icon from either application resources (on the
+ platforms for which they exist, i.e. Windows and OS2) or from an XPM file.
+ This can help to avoid using @ifdef_ when creating icons.
+
+ @see @ref overview_bitmap, wxBITMAP()
+
+ @header{wx/gdicmn.h}
*/
-void wxDisplaySize(int* width, int* height);
-wxSize wxGetDisplaySize();
+wxICON();
/**
- Returns the display size in millimeters.
+ Returns @true if the display is colour, @false otherwise.
+
+ @header{wx/gdicmn.h}
*/
-void wxDisplaySizeMM(int* width, int* height);
-wxSize wxGetDisplaySizeMM();
+bool wxColourDisplay();
/**
- This macro loads an icon from either application resources (on the platforms
- for which they exist, i.e. Windows and OS2) or from an XPM file. It allows to
- avoid using @c #ifdefs when creating icons.
+ Returns the depth of the display (a value of 1 denotes a monochrome
+ display).
- @see @ref overview_wxbitmapoverview, wxBITMAP()
+ @header{wx/gdicmn.h}
*/
-wxICON();
+int wxDisplayDepth();
/**
- Returns @true if the display is colour, @false otherwise.
+ Globally sets the cursor; only has an effect on Windows, Mac and GTK+. You
+ should call this function with wxNullCursor to restore the system cursor.
+
+ @see wxCursor, wxWindow::SetCursor()
+
+ @header{wx/gdicmn.h}
*/
-bool wxColourDisplay();
+void wxSetCursor(const wxCursor& cursor);
+
+//@}
+/** @ingroup group_funcmacro_gdi */
+//@{
/**
- This macro loads a bitmap from either application resources (on the platforms
- for which they exist, i.e. Windows and OS2) or from an XPM file. It allows to
- avoid using @c #ifdefs when creating bitmaps.
+ Returns the dimensions of the work area on the display. On Windows this
+ means the area not covered by the taskbar, etc. Other platforms are
+ currently defaulting to the whole display until a way is found to provide
+ this info for all window managers, etc.
- @see @ref overview_wxbitmapoverview, wxICON()
+ @header{wx/gdicmn.h}
*/
-#define wxBITMAP() /* implementation is private */
+void wxClientDisplayRect(int* x, int* y, int* width, int* height);
+wxRect wxGetClientDisplayRect();
+//@}
+/** @ingroup group_funcmacro_gdi */
+//@{
/**
- Returns the depth of the display (a value of 1 denotes a monochrome display).
+ Returns the display size in pixels.
+
+ @header{wx/gdicmn.h}
*/
-int wxDisplayDepth();
+void wxDisplaySize(int* width, int* height);
+wxSize wxGetDisplaySize();
+//@}
+
+/** @ingroup group_funcmacro_gdi */
+//@{
+/**
+ Returns the display size in millimeters.
+ @header{wx/gdicmn.h}
+*/
+void wxDisplaySizeMM(int* width, int* height);
+wxSize wxGetDisplaySizeMM();
//@}