Gtk::CssSection Class Reference

Defines a part of a CSS document. More...

#include <gtkmm/csssection.h>

Public Member Functions
void	reference () const
	Increment the reference count for this object. More...
void	unreference () const
	Decrement the reference count for this object. More...
GtkCssSection *	gobj ()
	Provides access to the underlying C instance. More...
const GtkCssSection *	gobj () const
	Provides access to the underlying C instance. More...
GtkCssSection *	gobj_copy () const
	Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More...
	CssSection ()=delete
	CssSection (const CssSection &)=delete
CssSection &	operator= (const CssSection &)=delete
CssSectionType	get_section_type () const
	Gets the type of information that section describes. More...
Glib::RefPtr< CssSection >	get_parent ()
	Gets the parent section for the given section. More...
Glib::RefPtr< const CssSection >	get_parent () const
	Gets the parent section for the given section. More...
Glib::RefPtr< Gio::File >	get_file ()
	Gets the file that section was parsed from. More...
Glib::RefPtr< const Gio::File >	get_file () const
	Gets the file that section was parsed from. More...
unsigned int	get_start_line () const
	Returns the line in the CSS document where this section starts. More...
unsigned int	get_start_position () const
	Returns the offset in bytes from the start of the current line returned via get_start_line(). More...
unsigned int	get_end_line () const
	Returns the line in the CSS document where this section end. More...
unsigned int	get_end_position () const
	Returns the offset in bytes from the start of the current line returned via get_end_line(). More...

Protected Member Functions
void	operator delete (void *, std::size_t)

Related Functions
(Note that these are not member functions.)
Glib::RefPtr< Gtk::CssSection >	wrap (GtkCssSection * object, bool take_copy=false)
	A Glib::wrap() method for this object. More...

Detailed Description

Defines a part of a CSS document.

Because sections are nested into one another, you can use get_parent() to get the containing region.

There is no public method that creates a CssSection, but it is input data to a Gtk::CssProvider::signal_parsing_error() handler.

Since gtkmm 3.16:

Constructor & Destructor Documentation

CssSection() [1/2]

Gtk::CssSection::CssSection ( )

delete

CssSection() [2/2]

Gtk::CssSection::CssSection ( const CssSection &  )

delete

Member Function Documentation

get_end_line()

unsigned int Gtk::CssSection::get_end_line

(

)

const

Returns the line in the CSS document where this section end.

The line number is 0-indexed, so the first line of the document will return 0. This value may change in future invocations of this function if section is not yet parsed completely. This will for example happen in the GtkCssProvider::parsing-error signal. The end position and line may be identical to the start position and line for sections which failed to parse anything successfully.

Since gtkmm 3.2:

Returns

The line number.

get_end_position()

unsigned int Gtk::CssSection::get_end_position

(

)

const

Returns the offset in bytes from the start of the current line returned via get_end_line().

This value may change in future invocations of this function if section is not yet parsed completely. This will for example happen in the GtkCssProvider::parsing-error signal. The end position and line may be identical to the start position and line for sections which failed to parse anything successfully.

Since gtkmm 3.2:

Returns

The offset in bytes from the start of the line.

get_file() [1/2]

Glib::RefPtr< Gio::File > Gtk::CssSection::get_file

(

)

Gets the file that section was parsed from.

If no such file exists, for example because the CSS was loaded via Gtk::CssProvider::load_from_data(), then nullptr is returned.

Since gtkmm 3.2:

Returns

The Gio::File that section was parsed from or nullptr if section was parsed from other data.

get_file() [2/2]

Glib::RefPtr< const Gio::File > Gtk::CssSection::get_file

(

)

const

Gets the file that section was parsed from.

If no such file exists, for example because the CSS was loaded via Gtk::CssProvider::load_from_data(), then nullptr is returned.

Since gtkmm 3.2:

Returns

The Gio::File that section was parsed from or nullptr if section was parsed from other data.

get_parent() [1/2]

Glib::RefPtr< CssSection > Gtk::CssSection::get_parent

(

)

Gets the parent section for the given section.

The parent section is the section that contains this section. A special case are sections of type Gtk::CSS_SECTION_DOCUMENT. Their parent will either be nullptr if they are the original CSS document that was loaded by Gtk::CssProvider::load_from_file() or a section of type Gtk::CSS_SECTION_IMPORT if it was loaded with an import rule from a different file.

Since gtkmm 3.2:

Returns

The parent section or nullptr if none.

get_parent() [2/2]

Glib::RefPtr< const CssSection > Gtk::CssSection::get_parent

(

)

const

Gets the parent section for the given section.

The parent section is the section that contains this section. A special case are sections of type Gtk::CSS_SECTION_DOCUMENT. Their parent will either be nullptr if they are the original CSS document that was loaded by Gtk::CssProvider::load_from_file() or a section of type Gtk::CSS_SECTION_IMPORT if it was loaded with an import rule from a different file.

Since gtkmm 3.2:

Returns

The parent section or nullptr if none.

get_section_type()

CssSectionType Gtk::CssSection::get_section_type

(

)

const

Gets the type of information that section describes.

Since gtkmm 3.2:

Returns

The type of section.

get_start_line()

unsigned int Gtk::CssSection::get_start_line

(

)

const

Returns the line in the CSS document where this section starts.

The line number is 0-indexed, so the first line of the document will return 0.

Since gtkmm 3.2:

Returns

The line number.

get_start_position()

unsigned int Gtk::CssSection::get_start_position

(

)

const

Returns the offset in bytes from the start of the current line returned via get_start_line().

Since gtkmm 3.2:

Returns

The offset in bytes from the start of the line.

gobj() [1/2]

GtkCssSection * Gtk::CssSection::gobj

(

)

Provides access to the underlying C instance.

gobj() [2/2]

const GtkCssSection * Gtk::CssSection::gobj

(

)

const

Provides access to the underlying C instance.

gobj_copy()

GtkCssSection * Gtk::CssSection::gobj_copy

(

)

const

Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.

operator delete()

void Gtk::CssSection::operator delete ( void *  , std::size_t    )

protected

operator=()

CssSection & Gtk::CssSection::operator= ( const CssSection &  )

delete

reference()

void Gtk::CssSection::reference

(

)

const

Increment the reference count for this object.

You should never need to do this manually - use the object via a RefPtr instead.

unreference()

void Gtk::CssSection::unreference

(

)

const

Decrement the reference count for this object.

You should never need to do this manually - use the object via a RefPtr instead.

Friends And Related Function Documentation

wrap()

Glib::RefPtr< Gtk::CssSection > wrap ( GtkCssSection *  object, bool  take_copy = false  )

related

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

Parameters

object	The C instance.
take_copy	False 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.