Version: 3.1.0
wxSize Class Reference

#include <wx/gdicmn.h>

Detailed Description

A wxSize is a useful data structure for graphics operations.

It simply contains integer width and height members.

Note that the width and height stored inside a wxSize object may be negative and that wxSize functions do not perform any check against negative values (this is used to e.g. store the special -1 value in wxDefaultSize instance). See also IsFullySpecified() and SetDefaults() for utility functions regarding the special -1 value.

wxSize is used throughout wxWidgets as well as wxPoint which, although almost equivalent to wxSize, has a different meaning: wxPoint represents a position while wxSize represents the size.

Library:  wxCore
Category:  Data Structures

Predefined objects/pointers: wxDefaultSize

See Also
wxPoint, wxRealPoint

Public Member Functions

 wxSize ()
 Initializes this size object with zero width and height.
 
 wxSize (int width, int height)
 Initializes this size object with the given width and height.
 
void DecTo (const wxSize &size)
 Decrements this object so that both of its dimensions are not greater than the corresponding dimensions of the size.
 
void DecToIfSpecified (const wxSize &size)
 Decrements this object to be not bigger than the given size ignoring non-specified components.
 
int GetHeight () const
 Gets the height member.
 
int GetWidth () const
 Gets the width member.
 
void IncTo (const wxSize &size)
 Increments this object so that both of its dimensions are not less than the corresponding dimensions of the size.
 
bool IsFullySpecified () const
 Returns true if neither of the size object components is equal to -1, which is used as default for the size values in wxWidgets (hence the predefined wxDefaultSize has both of its components equal to -1).
 
wxSizeScale (float xscale, float yscale)
 Scales the dimensions of this object by the given factors.
 
void Set (int width, int height)
 Sets the width and height members.
 
void SetDefaults (const wxSize &sizeDefault)
 Combine this size object with another one replacing the default (i.e. equal to -1) components of this object with those of the other.
 
void SetHeight (int height)
 Sets the height.
 
void SetWidth (int width)
 Sets the width.
 
void DecBy (const wxPoint &pt)
 Decreases the size in both x and y directions.
 
void DecBy (const wxSize &size)
 Decreases the size in both x and y directions.
 
void DecBy (int dx, int dy)
 Decreases the size in both x and y directions.
 
void DecBy (int d)
 Decreases the size in both x and y directions.
 
void IncBy (const wxPoint &pt)
 Increases the size in both x and y directions.
 
void IncBy (const wxSize &size)
 Increases the size in both x and y directions.
 
void IncBy (int dx, int dy)
 Increases the size in both x and y directions.
 
void IncBy (int d)
 Increases the size in both x and y directions.
 
Miscellaneous operators

Note that these operators are documented as class members (to make them easier to find) but, as their prototype shows, they are implemented as global operators; note that this is transparent to the user but it helps to understand why the following functions are documented to take the wxSize they operate on as an explicit argument.

wxSizeoperator= (const wxSize &sz)
 
bool operator== (const wxSize &s1, const wxSize &s2)
 
bool operator!= (const wxSize &s1, const wxSize &s2)
 
wxSize operator+ (const wxSize &s1, const wxSize &s2)
 
wxSize operator- (const wxSize &s1, const wxSize &s2)
 
wxSizeoperator+= (const wxSize &sz)
 
wxSizeoperator-= (const wxSize &sz)
 
wxSize operator/ (const wxSize &sz, int factor)
 
wxSize operator* (const wxSize &sz, int factor)
 
wxSize operator* (int factor, const wxSize &sz)
 
wxSizeoperator/= (int factor)
 
wxSizeoperator*= (int factor)
 

Constructor & Destructor Documentation

wxSize::wxSize ( )

Initializes this size object with zero width and height.

wxSize::wxSize ( int  width,
int  height 
)

Initializes this size object with the given width and height.

Member Function Documentation

void wxSize::DecBy ( const wxPoint pt)

Decreases the size in both x and y directions.

See Also
IncBy()
void wxSize::DecBy ( const wxSize size)

Decreases the size in both x and y directions.

See Also
IncBy()
void wxSize::DecBy ( int  dx,
int  dy 
)

Decreases the size in both x and y directions.

See Also
IncBy()
void wxSize::DecBy ( int  d)

Decreases the size in both x and y directions.

See Also
IncBy()
void wxSize::DecTo ( const wxSize size)

Decrements this object so that both of its dimensions are not greater than the corresponding dimensions of the size.

See Also
IncTo()
void wxSize::DecToIfSpecified ( const wxSize size)

Decrements this object to be not bigger than the given size ignoring non-specified components.

This is similar to DecTo() but doesn't do anything for x or y component if the same component of size is not specified, i.e. set to wxDefaultCoord.

Since
2.9.5
int wxSize::GetHeight ( ) const

Gets the height member.

int wxSize::GetWidth ( ) const

Gets the width member.

void wxSize::IncBy ( const wxPoint pt)

Increases the size in both x and y directions.

See Also
DecBy()
void wxSize::IncBy ( const wxSize size)

Increases the size in both x and y directions.

See Also
DecBy()
void wxSize::IncBy ( int  dx,
int  dy 
)

Increases the size in both x and y directions.

See Also
DecBy()
void wxSize::IncBy ( int  d)

Increases the size in both x and y directions.

See Also
DecBy()
void wxSize::IncTo ( const wxSize size)

Increments this object so that both of its dimensions are not less than the corresponding dimensions of the size.

See Also
DecTo()
bool wxSize::IsFullySpecified ( ) const

Returns true if neither of the size object components is equal to -1, which is used as default for the size values in wxWidgets (hence the predefined wxDefaultSize has both of its components equal to -1).

This method is typically used before calling SetDefaults().

bool wxSize::operator!= ( const wxSize s1,
const wxSize s2 
)
wxSize wxSize::operator* ( const wxSize sz,
int  factor 
)
wxSize wxSize::operator* ( int  factor,
const wxSize sz 
)
wxSize& wxSize::operator*= ( int  factor)
wxSize wxSize::operator+ ( const wxSize s1,
const wxSize s2 
)
wxSize& wxSize::operator+= ( const wxSize sz)
wxSize wxSize::operator- ( const wxSize s1,
const wxSize s2 
)
wxSize& wxSize::operator-= ( const wxSize sz)
wxSize wxSize::operator/ ( const wxSize sz,
int  factor 
)
wxSize& wxSize::operator/= ( int  factor)
wxSize& wxSize::operator= ( const wxSize sz)
bool wxSize::operator== ( const wxSize s1,
const wxSize s2 
)
wxSize& wxSize::Scale ( float  xscale,
float  yscale 
)

Scales the dimensions of this object by the given factors.

If you want to scale both dimensions by the same factor you can also use operator*=().

Returns
A reference to this object (so that you can concatenate other operations in the same line).
void wxSize::Set ( int  width,
int  height 
)

Sets the width and height members.

void wxSize::SetDefaults ( const wxSize sizeDefault)

Combine this size object with another one replacing the default (i.e. equal to -1) components of this object with those of the other.

It is typically used like this:

if ( !size.IsFullySpecified() )
{
size.SetDefaults(GetDefaultSize());
}
See Also
IsFullySpecified()
void wxSize::SetHeight ( int  height)

Sets the height.

void wxSize::SetWidth ( int  width)

Sets the width.