ThunarxPropertyPage

## ThunarxPropertyPage ThunarxPropertyPage — Base class for pages added to the properties dialog |

## Stability Level

Stable, unless otherwise indicated

## Synopsis

    #include <thunarx/thunarx.h>

                ThunarxPropertyPage;
    GtkWidget*  thunarx_property_page_new       (const gchar *label);
    GtkWidget*  thunarx_property_page_new_with_label_widget
                                                (GtkWidget *label_widget);
    const gchar* thunarx_property_page_get_label
                                                (ThunarxPropertyPage *property_page);
    void        thunarx_property_page_set_label (ThunarxPropertyPage *property_page,
                                                 const gchar *label);
    GtkWidget*  thunarx_property_page_get_label_widget
                                                (ThunarxPropertyPage *property_page);
    void        thunarx_property_page_set_label_widget
                                                (ThunarxPropertyPage *property_page,
                                                 GtkWidget *label_widget);

## Object Hierarchy

      GObject
       +----GtkObject
             +----GtkWidget
                   +----GtkContainer
                         +----GtkBin
                               +----ThunarxPropertyPage

## Implemented Interfaces

ThunarxPropertyPage implements AtkImplementorIface.

## Properties

      "label"                gchararray            : Read / Write
      "label-widget"         GtkWidget             : Read / Write

## Description

The class for pages that can be added to Thunar's file properties dialog by extensions implementing the ThunarxPropertyPageProvider interface.

## Details

### ThunarxPropertyPage

    typedef struct _ThunarxPropertyPage ThunarxPropertyPage;

Base instance type for property pages.

### thunarx_property_page_new ()

    GtkWidget*  thunarx_property_page_new       (const gchar *label);

Allocates a new ThunarxPropertyPage widget and sets its label to the specified `label`. If `label` is `NULL`, the label is omitted.

`label` : | the text to use as the label of the page.
Returns : | the newly allocated ThunarxPropertyPage widget.

### thunarx_property_page_new_with_label_widget ()

    GtkWidget*  thunarx_property_page_new_with_label_widget
                                                (GtkWidget *label_widget);

Allocates a new ThunarxPropertyPage widget and sets its label to the specified `label_widget`.

`label_widget` : | a GtkWidget, which should be used as label.
Returns : | the newly allocated ThunarxPropertyPage widget.

### thunarx_property_page_get_label ()

    const gchar* thunarx_property_page_get_label
                                                (ThunarxPropertyPage *property_page);

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()`).

`property_page` : | a ThunarxPropertyPage.
Returns : | 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.

### thunarx_property_page_set_label ()

    void        thunarx_property_page_set_label (ThunarxPropertyPage *property_page,
                                                 const gchar *label);

Sets the text of the label. If `label` is `NULL`, the current label is removed.

`property_page` : | a ThunarxPropertyPage.
`label` : | the text to use as the label of the page.

### thunarx_property_page_get_label_widget ()

    GtkWidget*  thunarx_property_page_get_label_widget
                                                (ThunarxPropertyPage *property_page);

Returns the label widget for the `property_page`. See `thunarx_property_page_set_label_widget()`.

`property_page` : | a ThunarxPropertyPage.
Returns : | the label widget or `NULL` if there is none.

### thunarx_property_page_set_label_widget ()

    void        thunarx_property_page_set_label_widget
                                                (ThunarxPropertyPage *property_page,
                                                 GtkWidget *label_widget);

Sets the label widget for the `property_page`. This is the widget that will appear in the notebook header for the `property_page`.

`property_page` : | a ThunarxPropertyPage.
`label_widget` : | the new label widget.

## Properties

### The "`label`" property

      "label"                gchararray            : Read / Write

Text of the page's label.

Default value: NULL

### The "`label-widget`" property

      "label-widget"         GtkWidget             : Read / Write

A widget to display in place of the usual page label.

## See Also

The description of the ThunarxPropertyPageProvider interface.