GtkSource.LanguageManager¶

Subclasses:	None

Methods¶

Inherited:	GObject.Object (37)
Structs:	GObject.ObjectClass (5)

class	`get_default` ()
class	`new` ()
	`get_language` (id)
	`get_language_ids` ()
	`get_search_path` ()
	`guess_language` (filename, content_type)
	`set_search_path` (dirs)

Virtual Methods¶

Inherited:	GObject.Object (7)

Properties¶

Name	Type	Flags	Short Description
`language-ids`	[`str`]	r	List of the ids of the available languages
`search-path`	[`str`]	r/w	List of directories where the language specification files (.lang) are located

Signals¶

Inherited:	GObject.Object (1)

Fields¶

Inherited:	GObject.Object (1)

Name	Type	Access	Description
parent_instance	`GObject.Object`	r

Class Details¶

class GtkSource.LanguageManager(**kwargs)¶

Bases:	`GObject.Object`
Abstract:	No
Structure:	`GtkSource.LanguageManagerClass`

classmethod get_default()¶

Returns:	a `GtkSource.LanguageManager`. Return value is owned by `GtkSource.View` library and must not be unref’ed.
Return type:	`GtkSource.LanguageManager`

Returns the default GtkSource.LanguageManager instance.

classmethod new()¶

Returns:	a new `GtkSource.LanguageManager`.
Return type:	`GtkSource.LanguageManager`

Creates a new language manager. If you do not need more than one language manager or a private language manager instance then use GtkSource.LanguageManager.get_default() instead.

get_language(id)¶

Parameters:	id (`str`) – a language id.
Returns:	a `GtkSource.Language`, or `None` if there is no language identified by the given id. Return value is owned by self and should not be freed.
Return type:	`GtkSource.Language` or `None`

Gets the GtkSource.Language identified by the given id in the language manager.

get_language_ids()¶

Returns:	a `None`-terminated array of strings containing the ids of the available languages or `None` if no language is available. The array is sorted alphabetically according to the language name. The array is owned by self and must not be modified.
Return type:	[`str`] or `None`

Returns the ids of the available languages.

get_search_path()¶

Returns:	`None`-terminated array containg a list of language files directories. The array is owned by self and must not be modified.
Return type:	[`str`]

Gets the list directories where self looks for language files.

guess_language(filename, content_type)¶

Parameters:	filename (`str` or `None`) – a filename in Glib filename encoding, or `None`. content_type (`str` or `None`) – a content type (as in GIO API), or `None`.
Returns:	a `GtkSource.Language`, or `None` if there is no suitable language for given filename and/or content_type. Return value is owned by self and should not be freed.
Return type:	`GtkSource.Language` or `None`

Picks a GtkSource.Language for given file name and content type, according to the information in lang files. Either filename or content_type may be None. This function can be used as follows:

<informalexample><programlisting> GtkSource.Language *lang; lang = GtkSource.LanguageManager.guess_language (filename, None); GtkSource.Buffer.set_language (buffer, lang); </programlisting></informalexample>

or

<informalexample><programlisting> GtkSource.Language *lang = None; bool result_uncertain; str *content_type;

content_type = Gio.content_type_guess (filename, None, 0, &result_uncertain); if (result_uncertain) { GLib.free (content_type); content_type = None; }

lang = GtkSource.LanguageManager.guess_language (manager, filename, content_type); GtkSource.Buffer.set_language (buffer, lang);

GLib.free (content_type); </programlisting></informalexample>

etc. Use GtkSource.Language.get_mime_types() and GtkSource.Language.get_globs() if you need full control over file -> language mapping.

New in version 2.4.

set_search_path(dirs)¶

Parameters:	dirs ([`str`] or `None`) – a `None`-terminated array of strings or `None`.

Sets the list of directories where the self looks for language files. If dirs is None, the search path is reset to default.

At the moment this function can be called only before the language files are loaded for the first time. In practice to set a custom search path for a GtkSource.LanguageManager, you have to call this function right after creating it.

Property Details¶

GtkSource.LanguageManager.props.language_ids¶

Name:	`language-ids`
Type:	[`str`]
Default Value:	`[]`
Flags:	`READABLE`

List of the ids of the available languages

GtkSource.LanguageManager.props.search_path¶

Name:	`search-path`
Type:	[`str`]
Default Value:	`[]`
Flags:	`READABLE`, `WRITABLE`

List of directories where the language specification files (.lang) are located