gtkmm  4.4.0
Public Member Functions | Static Public Member Functions | Protected Member Functions | Related Functions | List of all members
Gtk::Native Class Reference

Interface for widgets having surfaces. More...

#include <gtkmm/native.h>

Inheritance diagram for Gtk::Native:
Inheritance graph
[legend]

Public Member Functions

 Native (Native&& src) noexcept
 
Nativeoperator= (Native&& src) noexcept
 
 ~Native () noexcept override
 
GtkNative* gobj ()
 Provides access to the underlying C GObject. More...
 
const GtkNative* gobj () const
 Provides access to the underlying C GObject. More...
 
void realize ()
 Realizes a GtkNative. More...
 
void unrealize ()
 Unrealizes a GtkNative. More...
 
Glib::RefPtr< Gdk::Surfaceget_surface ()
 Returns the surface of this GtkNative. More...
 
Glib::RefPtr< const Gdk::Surfaceget_surface () const
 Returns the surface of this GtkNative. More...
 
void get_surface_transform (double& x, double& y)
 Retrieves the surface transform of self. More...
 

Static Public Member Functions

static void add_interface (GType gtype_implementer)
 
static GType get_type ()
 Get the GType for this class, for use with the underlying GObject type system. More...
 
static Nativeget_for_surface (const Glib::RefPtr< const Gdk::Surface >& surface)
 Finds the GtkNative associated with the surface. More...
 

Protected Member Functions

 Native ()
 You should derive from this class to use it. More...
 

Related Functions

(Note that these are not member functions.)

Glib::RefPtr< Gtk::Nativewrap (GtkNative* object, bool take_copy=false)
 A Glib::wrap() method for this object. More...
 

Detailed Description

Interface for widgets having surfaces.

Gtk::Native is the interface implemented by all widgets that can provide a Gdk::Surface for widgets to render on.

The obvious example of a Gtk::Native is Gtk::Window.

See also
Gtk::Root, Gtk::Window
Since gtkmm 3.96:

Constructor & Destructor Documentation

Gtk::Native::Native ( )
protected

You should derive from this class to use it.

Gtk::Native::Native ( Native&&  src)
noexcept
Gtk::Native::~Native ( )
overridenoexcept

Member Function Documentation

static void Gtk::Native::add_interface ( GType  gtype_implementer)
static
static Native* Gtk::Native::get_for_surface ( const Glib::RefPtr< const Gdk::Surface >&  surface)
static

Finds the GtkNative associated with the surface.

Parameters
surfaceA GdkSurface.
Returns
The GtkNative that is associated with surface.
Glib::RefPtr<Gdk::Surface> Gtk::Native::get_surface ( )

Returns the surface of this GtkNative.

Returns
The surface of self.
Glib::RefPtr<const Gdk::Surface> Gtk::Native::get_surface ( ) const

Returns the surface of this GtkNative.

Returns
The surface of self.
void Gtk::Native::get_surface_transform ( double &  x,
double &  y 
)

Retrieves the surface transform of self.

This is the translation from self's surface coordinates into self's widget coordinates.

Parameters
xReturn location for the x coordinate.
yReturn location for the y coordinate.
static GType Gtk::Native::get_type ( )
static

Get the GType for this class, for use with the underlying GObject type system.

GtkNative* Gtk::Native::gobj ( )
inline

Provides access to the underlying C GObject.

const GtkNative* Gtk::Native::gobj ( ) const
inline

Provides access to the underlying C GObject.

Native& Gtk::Native::operator= ( Native&&  src)
noexcept
void Gtk::Native::realize ( )

Realizes a GtkNative.

This should only be used by subclasses.

void Gtk::Native::unrealize ( )

Unrealizes a GtkNative.

This should only be used by subclasses.

Friends And Related Function Documentation

Glib::RefPtr< Gtk::Native > wrap ( GtkNative *  object,
bool  take_copy = false 
)
related

A Glib::wrap() method for this object.

Parameters
objectThe C instance.
take_copyFalse if the result should take ownership of the C instance. True if it should take a new copy or ref.
Returns
A C++ instance that wraps this C instance.