gtkmm 3.24.7
Public Member Functions | Protected Member Functions | Related Functions | List of all members
Gtk::CssSection Class Referencefinal

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
 
CssSectionoperator= (const CssSection &)=delete
 
CssSectionType get_section_type () const
 Gets the type of information that section describes. More...
 
Glib::RefPtr< CssSectionget_parent ()
 Gets the parent section for the given section. More...
 
Glib::RefPtr< const CssSectionget_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::CssSectionwrap (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
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.