Sets (or unsets) the base resource path of this.
The path is used to automatically load various [application resources][gresource] such as menu layouts and action descriptions. The various types of resources will be found at fixed names relative to the given base path.
By default, the resource base path is determined from the application ID by prefixing '/' and replacing each '.' with '/'. This is done at the time that the Application object is constructed. Changes to the application ID after that point will not have an impact on the resource base path.
As an example, if the application has an ID of "org.example.app" then the default resource base path will be "/org/example/app". If this
is a GtkApplication
(and you have not manually changed the path) then Gtk will then search for the menus of the application
at "/org/example/app/gtk/menus.ui".
See Resource for more information about adding resources to your application.
You can disable automatic resource loading functionality by setting the path to null.
Changing the resource base path once the application is running is not recommended. The point at which the resource path is consulted for forming paths for various purposes is unspecified. When writing a sub-class of Application you should either set the resource_base_path property at construction time, or call this function during the instance initialization. Alternatively, you can call this function in the startup virtual function, before chaining up to the parent implementation.
this | |
resource_path |
the resource path to use |