gtkmm: Gtk::Native Class Reference

Interface for widgets having surfaces. More...

#include <gtkmm/native.h>

Inheritance diagram for Gtk::Native:

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 Gtk::Native. More...

 
void unrealize ()
 Unrealizes a Gtk::Native. More...

 
Glib::RefPtr< Gdk::Surfaceget_surface ()
 Returns the surface of this Gtk::Native. More...

 
Glib::RefPtr< const Gdk::Surfaceget_surface () const
 Returns the surface of this Gtk::Native. More...

 
void get_surface_transform (double& x, double& y)
 Retrieves the surface transform of self. More...

 
- Public Member Functions inherited from Glib::Interface
 Interface ()
 
 Interface (Interface &&src) noexcept
 
Interfaceoperator= (Interface &&src) noexcept
 
 Interface (const Glib::Interface_Class &interface_class)
 
 Interface (GObject *castitem)
 
 ~Interface () noexcept override
 
 Interface (const Interface &)=delete
 
Interfaceoperator= (const Interface &)=delete
 
GObject * gobj ()
 
const GObject * gobj () const
 
- Public Member Functions inherited from Glib::ObjectBase
 ObjectBase (const ObjectBase &)=delete
 
ObjectBaseoperator= (const ObjectBase &)=delete
 
void set_property_value (const Glib::ustring &property_name, const Glib::ValueBase &value)
 
void get_property_value (const Glib::ustring &property_name, Glib::ValueBase &value) const
 
void set_property (const Glib::ustring &property_name, const PropertyType &value)
 
void get_property (const Glib::ustring &property_name, PropertyType &value) const
 
PropertyType get_property (const Glib::ustring &property_name) const
 
sigc::connection connect_property_changed (const Glib::ustring &property_name, const sigc::slot< void()> &slot)
 
sigc::connection connect_property_changed (const Glib::ustring &property_name, sigc::slot< void()> &&slot)
 
void freeze_notify ()
 
void thaw_notify ()
 
virtual void reference () const
 
virtual void unreference () const
 
GObject * gobj ()
 
const GObject * gobj () const
 
GObject * gobj_copy () const
 
- Public Member Functions inherited from sigc::trackable
 trackable () noexcept
 
 trackable (const trackable &src) noexcept
 
 trackable (trackable &&src) noexcept
 
 ~trackable ()
 
void add_destroy_notify_callback (notifiable *data, func_destroy_notify func) const
 
void notify_callbacks ()
 
trackableoperator= (const trackable &src)
 
trackableoperator= (trackable &&src) noexcept
 
void remove_destroy_notify_callback (notifiable *data) const
 

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...

 
- Protected Member Functions inherited from Glib::ObjectBase
 ObjectBase ()
 
 ObjectBase (const char *custom_type_name)
 
 ObjectBase (const std::type_info &custom_type_info)
 
 ObjectBase (ObjectBase &&src) noexcept
 
ObjectBaseoperator= (ObjectBase &&src) noexcept
 
virtual ~ObjectBase () noexcept=0
 
void initialize (GObject *castitem)
 
void initialize_move (GObject *castitem, Glib::ObjectBase *previous_wrapper)
 

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...

 

Additional Inherited Members

- Public Types inherited from sigc::trackable
typedef internal::func_destroy_notify func_destroy_notify
 
- Public Types inherited from sigc::notifiable
typedef internal::func_destroy_notify func_destroy_notify
 

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 Gdk::Surface.
Returns
The Gtk::Native that is associated with surface.
Glib::RefPtr<Gdk::Surface> Gtk::Native::get_surface ( )

Returns the surface of this Gtk::Native.

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

Returns the surface of this Gtk::Native.

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 Gtk::Native.

void Gtk::Native::unrealize ( )

Unrealizes a Gtk::Native.

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.