gtkmm: Gdk::Rectangle Class Reference

Gdk::Rectangle is a structure holding the position and size of a rectangle. More...

List of all members.

Public Member Functions

 Rectangle ()
 Rectangle (const GdkRectangle* gobject)
GdkRectangle* gobj ()
 Provides access to the underlying C instance.

const GdkRectangle* gobj () const
 Provides access to the underlying C instance.

 Rectangle (int x, int y, int width, int height)
 Creates a new rectangle instance with these dimensions.

Rectanglejoin (const Rectangle& src2)
 Calculates the union of two rectangles.

Rectangleintersect (const Rectangle& src2)
 Calculates the intersection of two rectangles, changing this rectangle.

Rectangleintersect (const Rectangle& src2, bool& rectangles_intersect)
 Calculates the intersection of two rectangles, changing this rectangle.

bool has_zero_area () const
 Checks whether either the width or height are 0.

int get_x () const
void set_x (const int&value)
int get_y () const
void set_y (const int&value)
int get_width () const
void set_width (const int&value)
int get_height () const
void set_height (const int&value)

Protected Attributes

GdkRectangle gobject_

Related Functions

(Note that these are not member functions.)

Gdk::Rectanglewrap (GdkRectangle* object)
const Gdk::Rectanglewrap (const GdkRectangle* object)

Detailed Description

Gdk::Rectangle is a structure holding the position and size of a rectangle.

The intersection of two rectangles can be computed with intersect(). To find the union of two rectangles use union().


Constructor & Destructor Documentation

Gdk::Rectangle::Rectangle ( )
Gdk::Rectangle::Rectangle ( const GdkRectangle *  gobject) [explicit]
Gdk::Rectangle::Rectangle ( int  x,
int  y,
int  width,
int  height 
)

Creates a new rectangle instance with these dimensions.


Member Function Documentation

int Gdk::Rectangle::get_height ( ) const
int Gdk::Rectangle::get_width ( ) const
int Gdk::Rectangle::get_x ( ) const
int Gdk::Rectangle::get_y ( ) const
const GdkRectangle* Gdk::Rectangle::gobj ( ) const [inline]

Provides access to the underlying C instance.

GdkRectangle* Gdk::Rectangle::gobj ( ) [inline]

Provides access to the underlying C instance.

bool Gdk::Rectangle::has_zero_area ( ) const

Checks whether either the width or height are 0.

Returns:
Whether this rectangle has any non-0 area.
Rectangle& Gdk::Rectangle::intersect ( const Rectangle src2)

Calculates the intersection of two rectangles, changing this rectangle.

If the rectangles do not intersect, this rectangle's width and height is set to 0 and its x and y values are undefined.

This method returns a reference to this instance, allowing you to then call another method easily. For instance: rect.intersect(src2).join(src3);

Parameters:
src2The rectangle with which to calculate the intersection with this rectangle.
Returns:
A reference to this rectangle.
Rectangle& Gdk::Rectangle::intersect ( const Rectangle src2,
bool &  rectangles_intersect 
)

Calculates the intersection of two rectangles, changing this rectangle.

If the rectangles do not intersect, this rectangle's width and height is set to 0 and its x and y values are undefined.

This method returns a reference to this instance, allowing you to then call another method easily. For instance: rect.intersect(src2).join(src3);

Parameters:
src2The rectangle with which to calculate the intersection with this rectangle.
rectangles_interesectThis will be set to true if the rectangles intersect.
Returns:
A reference to this rectangle.
Rectangle& Gdk::Rectangle::join ( const Rectangle src2)

Calculates the union of two rectangles.

The union of this rectangle and src2 is the smallest rectangle which includes both this rectangle and src2 within it.

This method returns a reference to this instance, allowing you to then call another method easily. For instance: rect.join(src2).intersect(src3);

Parameters:
src2The rectangle with which to calculate the union with this rectangle.
Returns:
A reference to this rectangle.
void Gdk::Rectangle::set_height ( const int &  value)
void Gdk::Rectangle::set_width ( const int &  value)
void Gdk::Rectangle::set_x ( const int &  value)
void Gdk::Rectangle::set_y ( const int &  value)

Friends And Related Function Documentation

Gdk::Rectangle& wrap ( GdkRectangle *  object) [related]
Parameters:
objectThe C instance
Returns:
A C++ instance that wraps this C instance.
const Gdk::Rectangle& wrap ( const GdkRectangle *  object) [related]
Parameters:
objectThe C instance
Returns:
A C++ instance that wraps this C instance.

Member Data Documentation

GdkRectangle Gdk::Rectangle::gobject_ [protected]

The documentation for this class was generated from the following file:
  • gdkmm/rectangle.h