Emits the ::changed signal on @file_info. This method should not be invoked by Thunar plugins, instead the file manager itself will use this method to emit ::changed whenever it notices a change on @file_info. a #ThunarxFileInfo. Returns the #GFileInfo associated with @file_info, which includes additional information about the @file_info as queried from GIO earlier. The caller is responsible to free the returned #GFileInfo object using g_object_unref() when no longer needed. the #GFileInfo object associated with @file_info, which MUST be freed using g_object_unref(). a #ThunarxFileInfo. Returns the #GFileInfo which includes additional information about the filesystem @file_info resides on. The caller is responsible to free the returned #GFileInfo object using g_object_unref() when no longer needed. the #GFileInfo containing information about the filesystem of @file_info or %NULL if no filesystem information is available. It MUST be released using g_object_unref(). a #ThunarxFileInfo. Returns the #GFile @file_info points to. The #GFile is a more powerful tool than just the URI or the path. The caller is responsible to release the returned #GFile using g_object_unref() when no longer needed. the #GFile to which @file_info points. It MUST be released using g_object_unref(). a #ThunarxFileInfo. Returns the MIME-type of the file represented by @file_info or %NULL if no MIME-type is known for @file_info. The caller is responsible to free the returned string using g_free() when no longer needed. the MIME-type for @file_info or %NULL. a #ThunarxFileInfo. Returns the real name of the file represented by @file_info in the local file system encoding. You can use g_filename_display_name() or similar functions to generate an UTF-8 version of the name, which is suitable for use in the user interface. The caller is responsible to free the returned string using g_free() when no longer needed. the real name of the file represented by @file_info. a #ThunarxFileInfo. Returns the URI to the parent file of @file_info or %NULL if @file_info has no parent. Note that the parent URI may be of a different type than the URI of @file_info. For example, the parent of "file:///" is "computer:///". The caller is responsible to free the returned string using g_free() when no longer needed. the parent URI for @file_info or %NULL. a #ThunarxFileInfo. Returns the escaped, fully qualified URI of the file object represented by @file_info. You may use g_filename_from_uri() and similar functions to work with the returned URI. The caller is responsible to free the returned string using g_free() when no longer needed. the fully qualified URI of @file_info. a #ThunarxFileInfo. Returns the URI scheme of the file represented by @file_info. E.g. if @file_info refers to the file "file:///usr/home", the return value will be "file". The caller is responsible to free the returned string using g_free() when no longer needed. the URI scheme for @file_info. a #ThunarxFileInfo. Checks whether @file_info is of the given @mime_type or whether the MIME-type of @file_info is a subclass of @mime_type. This is the preferred way for most extensions to check whether they support a given file or not, and you should consider using this method rather than thunarx_file_info_get_mime_type(). A simple example would be a menu extension that performs a certain action on text files. In this case you want to check whether a given #ThunarxFileInfo refers to any kind of text file, not only to "text/plain" (e.g. this also includes "text/xml" and "application/x-desktop"). But you should be aware that this method may take some time to test whether @mime_type is valid for @file_info, so don't call it too often. %TRUE if @mime_type is valid for @file_info, else %FALSE. a #ThunarxFileInfo. a MIME-type (e.g. "text/plain"). Checks whether @file_info refers to a directory. %TRUE if @file_info is a directory. a #ThunarxFileInfo. Emits the ::renamed signal on @file_info. This method should not be invoked by Thunar plugins, instead the file manager will emit this signal whenever the user renamed the @file_info. The plugins should instead connect to the ::renamed signal and update it's internal state and it's user interface after the file manager renamed a file. a #ThunarxFileInfo. Emits the ::changed signal on @file_info. This method should not be invoked by Thunar plugins, instead the file manager itself will use this method to emit ::changed whenever it notices a change on @file_info. a #ThunarxFileInfo. Returns the #GFileInfo associated with @file_info, which includes additional information about the @file_info as queried from GIO earlier. The caller is responsible to free the returned #GFileInfo object using g_object_unref() when no longer needed. the #GFileInfo object associated with @file_info, which MUST be freed using g_object_unref(). a #ThunarxFileInfo. Returns the #GFileInfo which includes additional information about the filesystem @file_info resides on. The caller is responsible to free the returned #GFileInfo object using g_object_unref() when no longer needed. the #GFileInfo containing information about the filesystem of @file_info or %NULL if no filesystem information is available. It MUST be released using g_object_unref(). a #ThunarxFileInfo. Returns the #GFile @file_info points to. The #GFile is a more powerful tool than just the URI or the path. The caller is responsible to release the returned #GFile using g_object_unref() when no longer needed. the #GFile to which @file_info points. It MUST be released using g_object_unref(). a #ThunarxFileInfo. Returns the MIME-type of the file represented by @file_info or %NULL if no MIME-type is known for @file_info. The caller is responsible to free the returned string using g_free() when no longer needed. the MIME-type for @file_info or %NULL. a #ThunarxFileInfo. Returns the real name of the file represented by @file_info in the local file system encoding. You can use g_filename_display_name() or similar functions to generate an UTF-8 version of the name, which is suitable for use in the user interface. The caller is responsible to free the returned string using g_free() when no longer needed. the real name of the file represented by @file_info. a #ThunarxFileInfo. Returns the URI to the parent file of @file_info or %NULL if @file_info has no parent. Note that the parent URI may be of a different type than the URI of @file_info. For example, the parent of "file:///" is "computer:///". The caller is responsible to free the returned string using g_free() when no longer needed. the parent URI for @file_info or %NULL. a #ThunarxFileInfo. Returns the escaped, fully qualified URI of the file object represented by @file_info. You may use g_filename_from_uri() and similar functions to work with the returned URI. The caller is responsible to free the returned string using g_free() when no longer needed. the fully qualified URI of @file_info. a #ThunarxFileInfo. Returns the URI scheme of the file represented by @file_info. E.g. if @file_info refers to the file "file:///usr/home", the return value will be "file". The caller is responsible to free the returned string using g_free() when no longer needed. the URI scheme for @file_info. a #ThunarxFileInfo. Checks whether @file_info is of the given @mime_type or whether the MIME-type of @file_info is a subclass of @mime_type. This is the preferred way for most extensions to check whether they support a given file or not, and you should consider using this method rather than thunarx_file_info_get_mime_type(). A simple example would be a menu extension that performs a certain action on text files. In this case you want to check whether a given #ThunarxFileInfo refers to any kind of text file, not only to "text/plain" (e.g. this also includes "text/xml" and "application/x-desktop"). But you should be aware that this method may take some time to test whether @mime_type is valid for @file_info, so don't call it too often. %TRUE if @mime_type is valid for @file_info, else %FALSE. a #ThunarxFileInfo. a MIME-type (e.g. "text/plain"). Checks whether @file_info refers to a directory. %TRUE if @file_info is a directory. a #ThunarxFileInfo. Emits the ::renamed signal on @file_info. This method should not be invoked by Thunar plugins, instead the file manager will emit this signal whenever the user renamed the @file_info. The plugins should instead connect to the ::renamed signal and update it's internal state and it's user interface after the file manager renamed a file. a #ThunarxFileInfo. Emitted whenever the system notices a change to @file_info. Thunar plugins should use this signal to stay informed about changes to a @file_info for which they currently display information (i.e. in a #ThunarxPropertyPage), and update it's user interface whenever a change is noticed on @file_info. Emitted when the @file_info is renamed to another name. For example, within Thunar, #ThunarFolder uses this signal to reregister it's VFS directory monitor, after the corresponding file was renamed. Interface with virtual methods implemented by the file manager and accessible from the extensions. See thunarx_file_info_get_name(). the real name of the file represented by @file_info. a #ThunarxFileInfo. See thunarx_file_info_get_uri(). the fully qualified URI of @file_info. a #ThunarxFileInfo. See thunarx_file_info_get_parent_uri(). the parent URI for @file_info or %NULL. a #ThunarxFileInfo. See thunarx_file_info_get_uri_scheme(). the URI scheme for @file_info. a #ThunarxFileInfo. See thunarx_file_info_get_mime_type(). the MIME-type for @file_info or %NULL. a #ThunarxFileInfo. See thunarx_file_info_has_mime_type(). %TRUE if @mime_type is valid for @file_info, else %FALSE. a #ThunarxFileInfo. a MIME-type (e.g. "text/plain"). See thunarx_file_info_is_directory(). %TRUE if @file_info is a directory. a #ThunarxFileInfo. See thunarx_file_info_get_file_info(). the #GFileInfo object associated with @file_info, which MUST be freed using g_object_unref(). a #ThunarxFileInfo. See thunarx_filesystem_info_get_filesystem_info(). the #GFileInfo containing information about the filesystem of @file_info or %NULL if no filesystem information is available. It MUST be released using g_object_unref(). a #ThunarxFileInfo. See thunarx_location_get_location(). the #GFile to which @file_info points. It MUST be released using g_object_unref(). a #ThunarxFileInfo. See thunarx_file_info_changed(). a #ThunarxFileInfo. See thunarx_file_info_renamed(). a #ThunarxFileInfo. Does a deep copy of @file_infos and returns the new list. a copy of @file_infos. a #GList of #ThunarxFileInfo<!---->s. Frees the resources allocated for the @file_infos list and decreases the reference count on the #ThunarxFileInfo<!---->s contained within. a #GList of #ThunarxFileInfo<!---->s. Creates a new menu that can be added to the toolbar or to a contextual menu. a newly created #ThunarxMenu a #ThunarxMenu a #ThunarxMenuItem the provided #ThunarxMenuItem list Must be freed with thunarx_menu_item_list_free() after usage a #ThunarxMenu a #ThunarxMenu a #ThunarxMenuItem Creates a new menu item that can be added to the toolbar or to a contextual menu. a newly created #ThunarxMenuItem identifier for the menu item user-visible label of the menu item tooltip of the menu item textual representation of the icon to display in the menu item, as returned by g_icon_to_string(). A path or icon name are valid representations too. a list of #ThunarxMenuItem Emits the activate signal. pointer to a #ThunarxMenuItem instance Returns whether the menu item is sensitive. pointer to a #ThunarxMenuItem instance Attaches @menu to menu item. pointer to a #ThunarxMenuItem instance pointer to a #ThunarxMenu instance Sets the ::sensitive property of the menu item to @sensitive. pointer to a #ThunarxMenuItem instance %TRUE to make the menu item sensitive Returns the list of #ThunarxMenuItem<!---->s that @provider has to offer for dropping the @files into the @folder. For example, the thunar-archive-plugin provides <guilabel>Extract Here</guilabel> menu items when dropping archive files into a folder that is writable by the user. As a special note, this method automatically takes a reference on the @provider for every #ThunarxMenuItem object returned from the real implementation of this method in @provider. This is to make sure that the extension stays in memory for at least the time that the menu items are used. If the extension wants to stay in memory for a longer time, it'll need to take care of this itself (e.g. by taking an additional reference on the @provider itself, that's released at a later time). The caller is responsible to free the returned list of menu items using something like this when no longer needed: <informalexample><programlisting> g_list_free_full (list, g_object_unref); </programlisting></informalexample> the list of #ThunarxMenuItem<!---->s that @provider has to offer for dropping @files to @folder. a #ThunarxMenuProvider. the #GtkWindow within which the menu items will be used. the folder into which the @files are being dropped the list of #ThunarxFileInfo<!---->s for the files that are being dropped to @folder in @window. Returns the list of #ThunarxMenuItem<!---->s that @provider has to offer for @files. As a special note, this method automatically takes a reference on the @provider for every #ThunarxMenuItem object returned from the real implementation of this method in @provider. This is to make sure that the extension stays in memory for at least the time that the menu items are used. If the extension wants to stay in memory for a longer time, it'll need to take care of this itself (e.g. by taking an additional reference on the @provider itself, that's released at a later time). The caller is responsible to free the returned list of menu items using something like this when no longer needed: <informalexample><programlisting> g_list_free_full (list, g_object_unref); </programlisting></informalexample> the list of #ThunarxMenuItem<!---->s that @provider has to offer for @files. a #ThunarxMenuProvider. the #GtkWindow within which the menu items will be used. the list of #ThunarxFileInfo<!---->s to which the menu items will be applied. Returns the list of #ThunarxMenuItem<!---->s that @provider has to offer for @folder. As a special note, this method automatically takes a reference on the @provider for every #ThunarxMenuItem object returned from the real implementation of this method in @provider. This is to make sure that the extension stays in memory for at least the time that the menu items are used. If the extension wants to stay in memory for a longer time, it'll need to take care of this itself (e.g. by taking an additional reference on the @provider itself, that's released at a later time). The caller is responsible to free the returned list of menu items using something like this when no longer needed: <informalexample><programlisting> g_list_free_full (list, g_object_unref); </programlisting></informalexample> the list of #ThunarxMenuItem<!---->s that @provider has to offer for @folder. a #ThunarxMenuProvider. the #GtkWindow within which the menu items will be used. the folder to which the menu items should will be applied. Returns the list of #ThunarxMenuItem<!---->s that @provider has to offer for dropping the @files into the @folder. For example, the thunar-archive-plugin provides <guilabel>Extract Here</guilabel> menu items when dropping archive files into a folder that is writable by the user. As a special note, this method automatically takes a reference on the @provider for every #ThunarxMenuItem object returned from the real implementation of this method in @provider. This is to make sure that the extension stays in memory for at least the time that the menu items are used. If the extension wants to stay in memory for a longer time, it'll need to take care of this itself (e.g. by taking an additional reference on the @provider itself, that's released at a later time). The caller is responsible to free the returned list of menu items using something like this when no longer needed: <informalexample><programlisting> g_list_free_full (list, g_object_unref); </programlisting></informalexample> the list of #ThunarxMenuItem<!---->s that @provider has to offer for dropping @files to @folder. a #ThunarxMenuProvider. the #GtkWindow within which the menu items will be used. the folder into which the @files are being dropped the list of #ThunarxFileInfo<!---->s for the files that are being dropped to @folder in @window. Returns the list of #ThunarxMenuItem<!---->s that @provider has to offer for @files. As a special note, this method automatically takes a reference on the @provider for every #ThunarxMenuItem object returned from the real implementation of this method in @provider. This is to make sure that the extension stays in memory for at least the time that the menu items are used. If the extension wants to stay in memory for a longer time, it'll need to take care of this itself (e.g. by taking an additional reference on the @provider itself, that's released at a later time). The caller is responsible to free the returned list of menu items using something like this when no longer needed: <informalexample><programlisting> g_list_free_full (list, g_object_unref); </programlisting></informalexample> the list of #ThunarxMenuItem<!---->s that @provider has to offer for @files. a #ThunarxMenuProvider. the #GtkWindow within which the menu items will be used. the list of #ThunarxFileInfo<!---->s to which the menu items will be applied. Returns the list of #ThunarxMenuItem<!---->s that @provider has to offer for @folder. As a special note, this method automatically takes a reference on the @provider for every #ThunarxMenuItem object returned from the real implementation of this method in @provider. This is to make sure that the extension stays in memory for at least the time that the menu items are used. If the extension wants to stay in memory for a longer time, it'll need to take care of this itself (e.g. by taking an additional reference on the @provider itself, that's released at a later time). The caller is responsible to free the returned list of menu items using something like this when no longer needed: <informalexample><programlisting> g_list_free_full (list, g_object_unref); </programlisting></informalexample> the list of #ThunarxMenuItem<!---->s that @provider has to offer for @folder. a #ThunarxMenuProvider. the #GtkWindow within which the menu items will be used. the folder to which the menu items should will be applied. Interface with virtual methods implemented by extensions that provide additional menu items for the file manager's context menus. Providers don't need to implement all of the virtual methods listed in the interface. See thunarx_menu_provider_get_file_menu_items(). the list of #ThunarxMenuItem<!---->s that @provider has to offer for @files. a #ThunarxMenuProvider. the #GtkWindow within which the menu items will be used. the list of #ThunarxFileInfo<!---->s to which the menu items will be applied. See thunarx_menu_provider_get_folder_menu_items(). the list of #ThunarxMenuItem<!---->s that @provider has to offer for @folder. a #ThunarxMenuProvider. the #GtkWindow within which the menu items will be used. the folder to which the menu items should will be applied. See thunarx_menu_provider_get_dnd_menu_items(). the list of #ThunarxMenuItem<!---->s that @provider has to offer for dropping @files to @folder. a #ThunarxMenuProvider. the #GtkWindow within which the menu items will be used. the folder into which the @files are being dropped the list of #ThunarxFileInfo<!---->s for the files that are being dropped to @folder in @window. Returns the list of #ThunarxMenuItem<!---->s that @provider has to offer as preferences within @window. These menu items will usually be added to the builtin list of preferences in the "Edit" menu of the file manager's @window. Plugin writers that implement this interface should make sure to choose descriptive names and tooltips, and not to crowd the "Edit" menu too much. That said, think twice before implementing this interface, as too many preference menu items will render the file manager useless over time! The caller is responsible to free the returned list of menu items using something like this when no longer needed: <informalexample><programlisting> g_list_free_full (list, g_object_unref); </programlisting></informalexample> the list of #ThunarxMenuItem<!---->s that @provider has to offer as preferences within @window. a #ThunarxPreferencesProvider. the #GtkWindow within which the menu items will be used. Returns the list of #ThunarxMenuItem<!---->s that @provider has to offer as preferences within @window. These menu items will usually be added to the builtin list of preferences in the "Edit" menu of the file manager's @window. Plugin writers that implement this interface should make sure to choose descriptive names and tooltips, and not to crowd the "Edit" menu too much. That said, think twice before implementing this interface, as too many preference menu items will render the file manager useless over time! The caller is responsible to free the returned list of menu items using something like this when no longer needed: <informalexample><programlisting> g_list_free_full (list, g_object_unref); </programlisting></informalexample> the list of #ThunarxMenuItem<!---->s that @provider has to offer as preferences within @window. a #ThunarxPreferencesProvider. the #GtkWindow within which the menu items will be used. Interface with virtual methods implementation by extensions that want to install preferences items in the file managers menu. Providers don't need to implement all of the virtual methods listed in the interface. See thunarx_preferences_provider_get_menu_items(). the list of #ThunarxMenuItem<!---->s that @provider has to offer as preferences within @window. a #ThunarxPreferencesProvider. the #GtkWindow within which the menu items will be used. Allocates a new #ThunarxPropertyPage widget and sets its label to the specified @label. If @label is %NULL, the label is omitted. the newly allocated #ThunarxPropertyPage widget. the text to use as the label of the page. Allocates a new #ThunarxPropertyPage widget and sets its label to the specified @label_widget. the newly allocated #ThunarxPropertyPage widget. a #GtkWidget, which should be used as label. If the @property_page's label widget is a #GtkLabel, returns the text in the label widget (the @property_page will have a #GtkLabel for the label widget if a non-%NULL argument was passed to thunarx_property_page_new()). the text in the label or %NULL if there was no label widget or the label widget was not a #GtkLabel. The returned string is owned by the @property_page and must not be modified or freed. a #ThunarxPropertyPage. Returns the label widget for the @property_page. See thunarx_property_page_set_label_widget(). the label widget or %NULL if there is none. a #ThunarxPropertyPage. Sets the text of the label. If @label is %NULL, the current label is removed. a #ThunarxPropertyPage. the text to use as the label of the page. Sets the label widget for the @property_page. This is the widget that will appear in the notebook header for the @property_page. a #ThunarxPropertyPage. the new label widget. Returns the list of #ThunarxPropertyPage<!---->s that @provider has to offer for @files. Extensions that implement this interface, must first check whether they support all the #ThunarxFileInfo<!---->s in the list of @files. Most extensions will probably only support #ThunarxPropertyPage<!---->s for exactly one file of a certain type. For example an MP3-Tag editor property page will most probably support only a single audio file, and so the method would be implemented like this <informalexample><programlisting> GList* tag_provider_get_pages (ThunarxPropertyPageProvider *property_page_provider, GList *files) { if (g_list_length (files) != 1) return NULL; else if (!thunarx_file_info_has_mime_type (files->data, "audio/mp3")) return NULL; else return g_list_append (NULL, tag_page_new (files->data)); } </programlisting></informalexample> where tag_page_new() allocates a new #TagPage instance for a #ThunarxFileInfo object passed to it. See the description of the #ThunarxPropertyPage class for additional information about the #TagPage example class. As a special note, this method automatically takes a reference on the @provider for every #ThunarxPropertyPage object returned from the real implementation of this method in @provider. This is to make sure that the extension stays in memory for atleast the time that the pages are used. If the extension wants to stay in memory for a longer time, it'll need to take care of this itself (e.g. by taking an additional reference on the @provider itself, that's released at a later time). The caller is responsible to free the returned list of pages using something like this when no longer needed: <informalexample><programlisting> g_list_foreach (list, (GFunc) g_object_ref_sink, NULL); g_list_free_full (list, g_object_unref); </programlisting></informalexample> the list of #ThunarxPropertyPage<!---->s that @provider has to offer for @files. a #ThunarxPropertyPageProvider. the list of #ThunarxFileInfo<!---->s for which a properties dialog will be displayed. Returns the list of #ThunarxPropertyPage<!---->s that @provider has to offer for @files. Extensions that implement this interface, must first check whether they support all the #ThunarxFileInfo<!---->s in the list of @files. Most extensions will probably only support #ThunarxPropertyPage<!---->s for exactly one file of a certain type. For example an MP3-Tag editor property page will most probably support only a single audio file, and so the method would be implemented like this <informalexample><programlisting> GList* tag_provider_get_pages (ThunarxPropertyPageProvider *property_page_provider, GList *files) { if (g_list_length (files) != 1) return NULL; else if (!thunarx_file_info_has_mime_type (files->data, "audio/mp3")) return NULL; else return g_list_append (NULL, tag_page_new (files->data)); } </programlisting></informalexample> where tag_page_new() allocates a new #TagPage instance for a #ThunarxFileInfo object passed to it. See the description of the #ThunarxPropertyPage class for additional information about the #TagPage example class. As a special note, this method automatically takes a reference on the @provider for every #ThunarxPropertyPage object returned from the real implementation of this method in @provider. This is to make sure that the extension stays in memory for atleast the time that the pages are used. If the extension wants to stay in memory for a longer time, it'll need to take care of this itself (e.g. by taking an additional reference on the @provider itself, that's released at a later time). The caller is responsible to free the returned list of pages using something like this when no longer needed: <informalexample><programlisting> g_list_foreach (list, (GFunc) g_object_ref_sink, NULL); g_list_free_full (list, g_object_unref); </programlisting></informalexample> the list of #ThunarxPropertyPage<!---->s that @provider has to offer for @files. a #ThunarxPropertyPageProvider. the list of #ThunarxFileInfo<!---->s for which a properties dialog will be displayed. Interface with virtual methods implemented by extensions that provide additional pages for the file properties dialog. see thunarx_property_page_provider_get_pages(). the list of #ThunarxPropertyPage<!---->s that @provider has to offer for @files. a #ThunarxPropertyPageProvider. the list of #ThunarxFileInfo<!---->s for which a properties dialog will be displayed. Returns a reference to the default #ThunarxProviderFactory instance. The caller is responsible to free the returned object using g_object_unref() when no longer needed. a reference to the default #ThunarxProviderFactory instance. Returns all providers of the given @type. The caller is responsible to release the returned list of providers using code like this: <informalexample><programlisting> g_list_free_full (list, g_object_unref); </programlisting></informalexample> the of providers for @type. a #ThunarxProviderFactory instance. the provider #GType. Allocates a new #ThunarxProviderModule for @filename. the newly allocated #ThunarxProviderModule. the name of the library file. Determines the #GType<!---->s provided by @module and returns them in @types and @n_types. a #ThunarxProviderModule. return location for the #GType array pointer. return location for the number of types. Wrapper for 'g_type_module_unuse' which first checks if the module is in use a #ThunarxProviderModule. Registers an additional interface for a type, whose interface lives in the given type @plugin. If the interface was already registered for the type in this @plugin, nothing will be done. As long as any instances of the type exist, the type @plugin will not be unloaded. a #ThunarxProviderPlugin. type to which to add the interface. interface type to add. type information structure. Determines whether the application is allowed to unload @plugin from memory when no longer needed and reload it on demand. If %FALSE is returned, then the application may unload @plugin, else if %TRUE is returned the application will take care that @plugin is never unloaded from memory during the lifetime of the application. %TRUE if @plugin will be kept in memory once loaded for the first time. a #ThunarxProviderPlugin. Looks up or registers an enumeration that is implemented with a particular type @plugin. If a type with name @name was previously registered, the #GType identifier for the type is returned, otherwise the type is newly registered, and the resulting #GType identifier returned. As long as any instances of the type exist, the type @plugin will not be unloaded. the new or existing type id. a #ThunarxProviderPlugin. the name for the type. an array of #GEnumValue structs for the possible enumeration values. The array is terminated by a struct with all members being %0. Looks up or registers a flags type that is implemented with a particular type @plugin. If a type with name qname was previously registered, the #GType identifier for the type is returned, otherwise the type is newly registered, and the resulting #GType identifier returned. As long as any instances of the type exist, the type @plugin will not be unloaded. the new or existing type id. a #ThunarxProviderPlugin. name for the type. an array of #GFlagsValue structs for the possible flags values. The array is terminated by a struct with all members being %0. Looks up or registers a type that is implemented with a particular type @plugin. If a type with name @type_name was previously registered, the #GType identifier for the type is returned, otherwise the type is newly registered, and the resulting #GType identifier returned. When reregistering a type (typically because a module is unloaded then reloaded, and reinitialized), module and @type_parent must be the same as they were previously. the new or existing type id. a #ThunarxProviderPlugin. the type for the parent class. name for the type. type information structure. flags field providing details about the type. This method is used to instruct the application that @plugin must be kept in memory during the lifetime of the application. The default is to allow the application to unload @plugin from the memory when no longer needed. If this method is invoked with a @resident value of %TRUE then the application will never try to unload @plugin. This method has no effect unless called from the %thunar_extension_initialize method of the @plugin. a #ThunarxProviderPlugin. %TRUE to make @plugin resident in memory. Registers an additional interface for a type, whose interface lives in the given type @plugin. If the interface was already registered for the type in this @plugin, nothing will be done. As long as any instances of the type exist, the type @plugin will not be unloaded. a #ThunarxProviderPlugin. type to which to add the interface. interface type to add. type information structure. Determines whether the application is allowed to unload @plugin from memory when no longer needed and reload it on demand. If %FALSE is returned, then the application may unload @plugin, else if %TRUE is returned the application will take care that @plugin is never unloaded from memory during the lifetime of the application. %TRUE if @plugin will be kept in memory once loaded for the first time. a #ThunarxProviderPlugin. Looks up or registers an enumeration that is implemented with a particular type @plugin. If a type with name @name was previously registered, the #GType identifier for the type is returned, otherwise the type is newly registered, and the resulting #GType identifier returned. As long as any instances of the type exist, the type @plugin will not be unloaded. the new or existing type id. a #ThunarxProviderPlugin. the name for the type. an array of #GEnumValue structs for the possible enumeration values. The array is terminated by a struct with all members being %0. Looks up or registers a flags type that is implemented with a particular type @plugin. If a type with name qname was previously registered, the #GType identifier for the type is returned, otherwise the type is newly registered, and the resulting #GType identifier returned. As long as any instances of the type exist, the type @plugin will not be unloaded. the new or existing type id. a #ThunarxProviderPlugin. name for the type. an array of #GFlagsValue structs for the possible flags values. The array is terminated by a struct with all members being %0. Looks up or registers a type that is implemented with a particular type @plugin. If a type with name @type_name was previously registered, the #GType identifier for the type is returned, otherwise the type is newly registered, and the resulting #GType identifier returned. When reregistering a type (typically because a module is unloaded then reloaded, and reinitialized), module and @type_parent must be the same as they were previously. the new or existing type id. a #ThunarxProviderPlugin. the type for the parent class. name for the type. type information structure. flags field providing details about the type. This method is used to instruct the application that @plugin must be kept in memory during the lifetime of the application. The default is to allow the application to unload @plugin from the memory when no longer needed. If this method is invoked with a @resident value of %TRUE then the application will never try to unload @plugin. This method has no effect unless called from the %thunar_extension_initialize method of the @plugin. a #ThunarxProviderPlugin. %TRUE to make @plugin resident in memory. Tells whether a plugin must reside in memory once loaded for the first time. See thunarx_provider_plugin_get_resident() and thunarx_provider_plugin_set_resident() for more details. Interface with virtual methods implemented by the file manager and accessible from the extensions. see thunarx_provider_plugin_get_resident(). %TRUE if @plugin will be kept in memory once loaded for the first time. a #ThunarxProviderPlugin. see thunarx_provider_plugin_set_resident(). a #ThunarxProviderPlugin. %TRUE to make @plugin resident in memory. see thunarx_provider_plugin_register_type(). the new or existing type id. a #ThunarxProviderPlugin. the type for the parent class. name for the type. type information structure. flags field providing details about the type. see thunarx_provider_plugin_add_interface(). a #ThunarxProviderPlugin. type to which to add the interface. interface type to add. type information structure. see thunarx_provider_plugin_register_enum(). the new or existing type id. a #ThunarxProviderPlugin. the name for the type. an array of #GEnumValue structs for the possible enumeration values. The array is terminated by a struct with all members being %0. see thunarx_provider_plugin_register_flags(). the new or existing type id. a #ThunarxProviderPlugin. name for the type. an array of #GFlagsValue structs for the possible flags values. The array is terminated by a struct with all members being %0. This method should be used by derived classes to emit the "changed" signal for @renamer. See the documentation of the "changed" signal for details. a #ThunarxRenamer. Returns the list of #ThunarxMenuItem<!---->s provided by @renamer for the given list of @files. By default, this method returns %NULL (the empty list), but derived classes may override this method to provide additional items for files in the bulk renamer dialog list. The returned #ThunarxMenuItem<!---->s will be displayed in the file's context menu of the bulk renamer dialog, when this @renamer is active. For example, an ID3-Tag based renamer may add an menu item "Edit Tags" to the context menus of supported media files and, when activated, display a dialog (which should be transient and modal for @window, if not %NULL), which allows the users to edit media file tags on-the-fly. Derived classes that override this method should always check first if all the #ThunarxFileInfo<!---->s in the list of @files are supported, and only return menu items that can be performed on this specific list of @files. For example, the ID3-Tag renamer mentioned above, should first check whether all items in @files are actually audio files. The thunarx_file_info_has_mime_type() of the #ThunarxFileInfo interface can be used to easily test whether a file in the @files list is of a certain MIME type. Some menu items may only work properly if only a single file is selected (for example, the ID3-Tag renamer will probably only supporting editing one file at a time). In this case you have basicly two options: Either you can return %NULL here if @files does not contain exactly one item, or you can return the menu items as usual, but make them insensitive, using: <informalexample><programlisting> thunarx_menu_item_set_sensitive (item, FALSE); </programlisting></informalexample> The latter has the advantage that the user will still notice the existance of the menu item and probably realize that it can only be applied to a single item at once. The caller is responsible to free the returned list using something like the following: <informalexample><programlisting> g_list_free_full (list, g_object_unref); </programlisting></informalexample> As a special note, this method automatically takes a reference on the @renamer for every #ThunarxMenuItem object returned from the real implementation of this method in @renamer. This is to make sure that the extension stays in memory for at least the time that the menu items are used. The name of #ThunarxMenuItem<!---->s returned from this method must be namespaced with the module to avoid collision with internal file manager menu items and menu items provided by other extensions. For example, the menu item provided by the ID3-Tag renamer mentioned above, should be named <literal>TagRenamer::edit-tags</literal> (if <literal>TagRenamer</literal> is the class name). For additional information about the way #ThunarxMenuItem<!---->s should be returned from extensions and the way they are used, read the description of the #ThunarxMenuProvider interface or read the introduction provided with this reference manual. A note of warning concerning the @window parameter. Plugins should avoid taking a reference on @window, as that might introduce a circular reference and can thereby cause a quite large memory leak. Instead, if @window is not %NULL, add a weak reference using the g_object_weak_ref() or g_object_add_weak_pointer() method. But don't forget to release the weak reference if @window survived the lifetime of your menu item (which is likely to be the case in most situations). the list of #ThunarxMenuItem<!---->s provided by @renamer for the given list of @files. a #ThunarxRenamer. a #GtkWindow or %NULL. a #GList of #ThunarxFileInfo<!---->s. Tells @renamer to load its internal settings from the specified @settings. The @settings hash table contains previously saved settings, see thunarx_renamer_save(), as key/value pairs of strings. That is, both the keys and the values are strings. Implementations of #ThunarxRenamer may decide to override this method to perform custom loading of settings. If you do not override this method, the default method of #ThunarxRenamer will be used, which simply loads all #GObject properties provided by @renamer<!---->s class (excluding the ones provided by the parent classes) from the @settings. The #GObject properties must be transformable to strings and from strings. If you decide to override this method for your #ThunarxRenamer implementation, you should also override thunarx_renamer_save(). a #ThunarxRenamer. a #GHashTable which contains the previously saved settings for @renamer as key/value pairs of strings. Determines the replacement for @text (which is the relevant part of the full @file name, i.e. either the suffix, the name or the name and the suffix). The caller is responsible to free the returned string using g_free() when no longer needed. the string with which to replace @text. a #ThunarxRenamer. the #ThunarxFileInfo for the file whose new name - according to @renamer - should be determined. the part of the filename to which the @renamer should be applied. the index of the file in the list, used for renamers that work on numbering. Tells @renamer to save its internal settings to the specified @settings, which can afterwards be loaded by thunarx_renamer_load(). The strings saved to @settings must be allocated by g_strdup(), both the keys and the values. For example to store the string <literal>Bar</literal> for the setting <literal>Foo</literal>, you'd use: <informalexample><programlisting> g_hash_table_replace (settings, g_strdup ("Foo"), g_strdup ("Bar")); </programlisting></informalexample> Implementations of #ThunarxRenamer may decide to override this method to perform custom saving of settings. If you do not overrride this method, the default method of #ThunarxRenamer will be used, which simply stores all #GObject properties provided by the @renamer<!---->s class (excluding the ones provided by the parent classes) to the @settings. The #GObject properties must be transformable to strings. If you decide to override this method for your #ThunarxRenamer implementation, you should also override thunarx_renamer_load(). a #ThunarxRenamer. a #GHashTable to which the current settings of @renamer should be stored as key/value pairs of strings. This method should be used by derived classes to emit the "changed" signal for @renamer. See the documentation of the "changed" signal for details. a #ThunarxRenamer. Returns the URL of the documentation for @renamer or %NULL if no specific documentation is available for @renamer and the general documentation of the Thunar renamers should be displayed instead. the URL of the documentation for @renamer. a #ThunarxRenamer. Returns the list of #ThunarxMenuItem<!---->s provided by @renamer for the given list of @files. By default, this method returns %NULL (the empty list), but derived classes may override this method to provide additional items for files in the bulk renamer dialog list. The returned #ThunarxMenuItem<!---->s will be displayed in the file's context menu of the bulk renamer dialog, when this @renamer is active. For example, an ID3-Tag based renamer may add an menu item "Edit Tags" to the context menus of supported media files and, when activated, display a dialog (which should be transient and modal for @window, if not %NULL), which allows the users to edit media file tags on-the-fly. Derived classes that override this method should always check first if all the #ThunarxFileInfo<!---->s in the list of @files are supported, and only return menu items that can be performed on this specific list of @files. For example, the ID3-Tag renamer mentioned above, should first check whether all items in @files are actually audio files. The thunarx_file_info_has_mime_type() of the #ThunarxFileInfo interface can be used to easily test whether a file in the @files list is of a certain MIME type. Some menu items may only work properly if only a single file is selected (for example, the ID3-Tag renamer will probably only supporting editing one file at a time). In this case you have basicly two options: Either you can return %NULL here if @files does not contain exactly one item, or you can return the menu items as usual, but make them insensitive, using: <informalexample><programlisting> thunarx_menu_item_set_sensitive (item, FALSE); </programlisting></informalexample> The latter has the advantage that the user will still notice the existance of the menu item and probably realize that it can only be applied to a single item at once. The caller is responsible to free the returned list using something like the following: <informalexample><programlisting> g_list_free_full (list, g_object_unref); </programlisting></informalexample> As a special note, this method automatically takes a reference on the @renamer for every #ThunarxMenuItem object returned from the real implementation of this method in @renamer. This is to make sure that the extension stays in memory for at least the time that the menu items are used. The name of #ThunarxMenuItem<!---->s returned from this method must be namespaced with the module to avoid collision with internal file manager menu items and menu items provided by other extensions. For example, the menu item provided by the ID3-Tag renamer mentioned above, should be named <literal>TagRenamer::edit-tags</literal> (if <literal>TagRenamer</literal> is the class name). For additional information about the way #ThunarxMenuItem<!---->s should be returned from extensions and the way they are used, read the description of the #ThunarxMenuProvider interface or read the introduction provided with this reference manual. A note of warning concerning the @window parameter. Plugins should avoid taking a reference on @window, as that might introduce a circular reference and can thereby cause a quite large memory leak. Instead, if @window is not %NULL, add a weak reference using the g_object_weak_ref() or g_object_add_weak_pointer() method. But don't forget to release the weak reference if @window survived the lifetime of your menu item (which is likely to be the case in most situations). the list of #ThunarxMenuItem<!---->s provided by @renamer for the given list of @files. a #ThunarxRenamer. a #GtkWindow or %NULL. a #GList of #ThunarxFileInfo<!---->s. Returns the user visible name for @renamer, previously set with thunarx_renamer_set_name(). the user visible name for @renamer. a #ThunarxRenamer. Tells @renamer to load its internal settings from the specified @settings. The @settings hash table contains previously saved settings, see thunarx_renamer_save(), as key/value pairs of strings. That is, both the keys and the values are strings. Implementations of #ThunarxRenamer may decide to override this method to perform custom loading of settings. If you do not override this method, the default method of #ThunarxRenamer will be used, which simply loads all #GObject properties provided by @renamer<!---->s class (excluding the ones provided by the parent classes) from the @settings. The #GObject properties must be transformable to strings and from strings. If you decide to override this method for your #ThunarxRenamer implementation, you should also override thunarx_renamer_save(). a #ThunarxRenamer. a #GHashTable which contains the previously saved settings for @renamer as key/value pairs of strings. Determines the replacement for @text (which is the relevant part of the full @file name, i.e. either the suffix, the name or the name and the suffix). The caller is responsible to free the returned string using g_free() when no longer needed. the string with which to replace @text. a #ThunarxRenamer. the #ThunarxFileInfo for the file whose new name - according to @renamer - should be determined. the part of the filename to which the @renamer should be applied. the index of the file in the list, used for renamers that work on numbering. Tells @renamer to save its internal settings to the specified @settings, which can afterwards be loaded by thunarx_renamer_load(). The strings saved to @settings must be allocated by g_strdup(), both the keys and the values. For example to store the string <literal>Bar</literal> for the setting <literal>Foo</literal>, you'd use: <informalexample><programlisting> g_hash_table_replace (settings, g_strdup ("Foo"), g_strdup ("Bar")); </programlisting></informalexample> Implementations of #ThunarxRenamer may decide to override this method to perform custom saving of settings. If you do not overrride this method, the default method of #ThunarxRenamer will be used, which simply stores all #GObject properties provided by the @renamer<!---->s class (excluding the ones provided by the parent classes) to the @settings. The #GObject properties must be transformable to strings. If you decide to override this method for your #ThunarxRenamer implementation, you should also override thunarx_renamer_load(). a #ThunarxRenamer. a #GHashTable to which the current settings of @renamer should be stored as key/value pairs of strings. The URL to the documentation of this #ThunarxRenamer. Derived classes can set this property to point to the documentation for the specific renamer. The documentation of the specific renamer in turn should contain a link to the general Thunar renamer documentation. May also be unset, in which case the general Thunar renamer documentation will be shown when the user clicks the "Help" button. a #ThunarxRenamer. the new URL to the documentation of @renamer. Sets the user visible name for @renamer to @name. This method should only be called by derived classes and prior to returning the @renamer is returned from thunarx_renamer_provider_get_renamers(). a #ThunarxRenamer. the new user visible name for @renamer. The URL to the documentation of this #ThunarxRenamer. Derived classes can set this property to point to the documentation for the specific renamer. The documentation of the specific renamer in turn should contain a link to the general Thunar renamer documentation. May also be unset, in which case the general Thunar renamer documentation will be shown when the user clicks the "Help" button. The user visible name of the renamer, that is displayed in the bulk rename dialog of the file manager. Derived classes should set a useful name. Derived classes should emit this signal using the thunarx_renamer_changed() method whenever the user changed a setting in the @renamer GUI. The file manager will then invoke thunarx_renamer_process() for all files that should be renamed and update the preview. Abstract base class with virtual methods implemented by extensions that provide additional bulk renamers for the integrated bulk rename module in Thunar. see thunarx_renamer_process(). the string with which to replace @text. a #ThunarxRenamer. the #ThunarxFileInfo for the file whose new name - according to @renamer - should be determined. the part of the filename to which the @renamer should be applied. the index of the file in the list, used for renamers that work on numbering. see thunarx_renamer_load(). a #ThunarxRenamer. a #GHashTable which contains the previously saved settings for @renamer as key/value pairs of strings. see thunarx_renamer_save(). a #ThunarxRenamer. a #GHashTable to which the current settings of @renamer should be stored as key/value pairs of strings. see thunarx_renamer_get_menu_items(). the list of #ThunarxMenuItem<!---->s provided by @renamer for the given list of @files. a #ThunarxRenamer. a #GtkWindow or %NULL. a #GList of #ThunarxFileInfo<!---->s. see thunarx_renamer_changed(). a #ThunarxRenamer. Returns the list of #ThunarxRenamer<!---->s provided by the specified @provider. The real implementation of this method MUST return the #ThunarxRenamer<!---->s with floating references (the default for g_object_new() on #GtkWidget derived types). The returned #ThunarxRenamer<!---->s will be reffed and sinked automatically by this function. As a special note, this method automatically takes a reference on the @provider for every #ThunarxRenamer returned from the real implementation of this method in @provider. This is to make sure that the extension stays in memory for atleast the time that the renamers are used. If the extension wants to stay in memory for a longer time, it'll need to take care of this itself (e.g. by taking an additional reference on the @provider itself, that's released at a later time). The caller is responsible to free the returned list of renamers using something like this when no longer needed: <informalexample><programlisting> g_list_free_full (list, g_object_unref); </programlisting></informalexample> the list of #ThunarxRenamer<!---->s provided by the specified @provider. a #ThunarxRenamerProvider. Returns the list of #ThunarxRenamer<!---->s provided by the specified @provider. The real implementation of this method MUST return the #ThunarxRenamer<!---->s with floating references (the default for g_object_new() on #GtkWidget derived types). The returned #ThunarxRenamer<!---->s will be reffed and sinked automatically by this function. As a special note, this method automatically takes a reference on the @provider for every #ThunarxRenamer returned from the real implementation of this method in @provider. This is to make sure that the extension stays in memory for atleast the time that the renamers are used. If the extension wants to stay in memory for a longer time, it'll need to take care of this itself (e.g. by taking an additional reference on the @provider itself, that's released at a later time). The caller is responsible to free the returned list of renamers using something like this when no longer needed: <informalexample><programlisting> g_list_free_full (list, g_object_unref); </programlisting></informalexample> the list of #ThunarxRenamer<!---->s provided by the specified @provider. a #ThunarxRenamerProvider. Interface with virtual methods implemented by extensions that provide additional bulk renamers for the integrated bulk renamer in Thunar. see thunarx_renamer_provider_get_renamers(). the list of #ThunarxRenamer<!---->s provided by the specified @provider. a #ThunarxRenamerProvider. Does a deep copy of @file_infos and returns the new list. a copy of @file_infos. a #GList of #ThunarxFileInfo<!---->s. Frees the resources allocated for the @file_infos list and decreases the reference count on the #ThunarxFileInfo<!---->s contained within. a #GList of #ThunarxFileInfo<!---->s. The <interface>ThunarxFileInfo</interface> interface provides extensions with a way to access information about a file handled within the file manager. The class for submenus that can be added to Thunar's context menus. Extensions can provide ThunarxMenu objects by attaching them to ThunarxMenuItem objects, using thunarx_menu_item_set_menu(). The class for menu items that can be added to Thunar's context menus by extensions implementing the #ThunarxMenuProvider, #ThunarxPreferencesProvider or #ThunarxRenamerProvider interfaces. The items returned by extensions from *_get_menu_items() methods are instances of this class or a derived class. The <interface>ThunarxMenuProvider</interface> interface is implemented by extensions which provide additional menu items that should be displayed in the file or folder context menus for certain types of files. Extensions that implement this interface should do its best to respond as fast as possible to method invokations by the file manager. That said, when the file manager calls the thunarx_menu_provider_get_file_menu_items() or the thunarx_menu_provider_get_folder_menu_items() method, the implementation in the extension should use only the thunarx_file_info_has_mime_type() and thunarx_file_info_is_directory() methods to determine the menu items that should be added to the file manager's context menu. Don't perform any complicated I/O to determine the menu items list, as that would block the whole file manager process. The name of <link linkend="ThunarxMenuItem">ThunarxMenuItem</link>s returned from the thunarx_menu_provider_get_file_menu_items() and thunarx_menu_provider_get_folder_menu_items() methods must be namespaced with the module to avoid collision with internal file manager menu items and menu items provided by other extensions. For example, the menu item provided by the <systemitem class="library">ThunarOpenTerminal</systemitem> extension should be called <literal>ThunarOpenTerminal::open-terminal</literal>. The ThunarxPreferencesProvider interface is implemented by extensions that want to register additional items in the preferences menu of the file manager. In general this should only be done by extensions that are closely tied to the file manager (for example, the <literal>thunar-uca</literal> is such an extension, while an extension that just adds <guimenuitem>Compress file</guimenuitem> and <guimenuitem>Uncompress file</guimenuitem> to the context menu of compressed files should not add their own preferences to the file manager menu, because it should use desktop-wide settings for archive managers instead). The name of <link linkend="ThunarxMenuItem"><type>ThunarxMenuItem</type></link>s returned from the thunarx_preferences_provider_get_menu items() method must be namespaced with the model to avoid collision with internal file manager menu items and menu items provided by other extensions. For example, the preferences menu item provided by the <literal>thunar-uca</literal> extension is called <literal>ThunarUca::manage-menu-items</literal>. The class for pages that can be added to Thunar's file properties dialog by extensions implementing the #ThunarxPropertyPageProvider interface. The pages returned by extensions from thunarx_property_page_provider_get_pages() method are instances of this class or a derived class. Note that extensions do not need to subclass #ThunarxPropertyPage, but may also instantiate it directly and add widgets to it, but I strongly suggest to create a subclass as it usually leads to better modularization and thereby better maintainability in the code. To pick up the #TagPage example from the thunarx_property_page_provider_get_pages() description again, you'd create a new class #TagPage, that inherits #ThunarxPropertyPage (using the #THUNARX_DEFINE_TYPE macro), which provides several user interface elements in the property, and defines atleast one property named <literal>"file"</literal>, which is the #ThunarxFileInfo whose tags are displayed in the property page. For example, the <filename>tag-page.h</filename> header file would look like this (this is really just an example of the suggested way to implement property pages, you may of course choose a different way) To add a property page to the file properties dialog, extensions must implement the <type>ThunarxPropertyPageProvider</type> interface. This interface has only one virtual method, <function>get_pages</function>, that is passed a list of <link linkend="ThunarxFileInfo"><type>ThunarxFileInfo</type></link> objects and returns a list of <link linkend="ThunarxPropertyPage"><type>ThunarxPropertyPage</type></link> objects. The #ThunarxProviderFactory class allows applications to use Thunar plugins. It handles the loading of the installed extensions and instantiates providers for the application. For example, Thunar uses this class to access the installed extensions. #ThunarxProviderPlugin is the interface to the file manager's type plugin loader implementation. It provides methods to extensions - also called <emphasis>provider plugins</emphasis> - to register dynamic types and control certain aspects of the plugin (see thunarx_provider_plugin_set_resident()). The abstract base class <type>ThunarxRenamer</type> is implemented by extensions which provide additional bulk renamers that should be used in the bulk rename dialog. Derived classes must override the thunarx_renamer_process() method, which is called by the bulk rename dialog for every file to generate a new name. For example, the <type>ThunarSbrReplaceRenamer</type> class included in the <literal>thunar-sbr</literal> plugin (which is part of the Thunar distribution) provides a bulk renamer, named <emphasis>Search &amp; Replace</emphasis>, which allows the user to rename multiple files by searching for a pattern in each file name and, if the pattern is found, replacing it with the specified replacement text. The active <type>ThunarxRenamer</type>s user interface is displayed in a frame below the file list, as shown in the screenshot above. Derived classes should try to limit the number of widgets displayed in the main user interface. For example, if you have more than six settings, you should consider adding an <guibutton>Advanced</guibutton>, button which opens a dialog with the additional settings. The <interface>ThunarxRenamerProvider</interface> interface is implemented by extensions which provide additional bulk renamers that should be used by the bulk rename dialog in Thunar.