GtkSourceLanguageManager

GtkSourceLanguageManager

Synopsis


#include <gtksourceview/gtksourcelanguagemanager.h>


                    GtkSourceLanguageManager;
GtkSourceLanguageManager* gtk_source_language_manager_new
                                                        (void);
GtkSourceLanguageManager* gtk_source_language_manager_get_default
                                                        (void);
void                gtk_source_language_manager_set_search_path
                                                        (GtkSourceLanguageManager *lm,
                                                         gchar **dirs);
GtkSourceLanguage*  gtk_source_language_manager_get_language
                                                        (GtkSourceLanguageManager *lm,
                                                         const gchar *id);

Object Hierarchy


  GObject
   +----GtkSourceLanguageManager

Properties


  "language-ids"             GStrv                 : Read
  "search-path"              GStrv                 : Read / Write

Description

Details

GtkSourceLanguageManager

typedef struct _GtkSourceLanguageManager GtkSourceLanguageManager;

GtkSourceLanguageManager structure contains only private members and should not be accessed directly.


gtk_source_language_manager_new ()

GtkSourceLanguageManager* gtk_source_language_manager_new
                                                        (void);

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

Returns : a GtkSourceLanguageManager.

gtk_source_language_manager_get_default ()

GtkSourceLanguageManager* gtk_source_language_manager_get_default
                                                        (void);

Returns the default GtkSourceLanguageManager instance.

Returns : a GtkSourceLanguageManager. Return value is owned by GtkSourceView library and must not be unref'ed.

gtk_source_language_manager_set_search_path ()

void                gtk_source_language_manager_set_search_path
                                                        (GtkSourceLanguageManager *lm,
                                                         gchar **dirs);

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

Note

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 GtkSourceLanguageManager, you have to call this function right after creating it.

lm : a GtkSourceLanguageManager.
dirs : a NULL-terminated array of strings or NULL.

gtk_source_language_manager_get_language ()

GtkSourceLanguage*  gtk_source_language_manager_get_language
                                                        (GtkSourceLanguageManager *lm,
                                                         const gchar *id);

Gets the GtkSourceLanguage identified by the given id in the language manager.

lm : a GtkSourceLanguageManager.
id : a language id.
Returns : a GtkSourceLanguage, or NULL if there is no language identified by the given id. Return value is owned by lm and should not be freed.

Property Details

The "language-ids" property

  "language-ids"             GStrv                 : Read

List of the ids of the available languages.


The "search-path" property

  "search-path"              GStrv                 : Read / Write

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

See Also

GtkSourceLanguage