GtranslatorMessageArea

GtranslatorMessageArea

Synopsis

                    GtranslatorMessageAreaPrivate;
                    GtranslatorMessageArea;
GtkWidget *         gtranslator_message_area_new        (void);
GtkWidget *         gtranslator_message_area_new_with_buttons
                                                        (const gchar *first_button_text,
                                                         ...);
void                gtranslator_message_area_set_contents
                                                        (GtranslatorMessageArea *message_area,
                                                         GtkWidget *contents);
void                gtranslator_message_area_add_action_widget
                                                        (GtranslatorMessageArea *message_area,
                                                         GtkWidget *child,
                                                         gint response_id);
GtkWidget *         gtranslator_message_area_add_button (GtranslatorMessageArea *message_area,
                                                         const gchar *button_text,
                                                         gint response_id);
GtkWidget *         gtranslator_message_area_add_stock_button_with_text
                                                        (GtranslatorMessageArea *message_area,
                                                         const gchar *text,
                                                         const gchar *stock_id,
                                                         gint response_id);
void                gtranslator_message_area_add_buttons
                                                        (GtranslatorMessageArea *message_area,
                                                         const gchar *first_button_text,
                                                         ...);
void                gtranslator_message_area_set_response_sensitive
                                                        (GtranslatorMessageArea *message_area,
                                                         gint response_id,
                                                         gboolean setting);
void                gtranslator_message_area_set_default_response
                                                        (GtranslatorMessageArea *message_area,
                                                         gint response_id);
void                gtranslator_message_area_response   (GtranslatorMessageArea *message_area,
                                                         gint response_id);

Description

Details

GtranslatorMessageAreaPrivate

typedef struct _GtranslatorMessageAreaPrivate GtranslatorMessageAreaPrivate;


GtranslatorMessageArea

typedef struct {
  GtkHBox parent;
} GtranslatorMessageArea;


gtranslator_message_area_new ()

GtkWidget *         gtranslator_message_area_new        (void);

Creates a new GtranslatorMessageArea object.

Returns :

a new GtranslatorMessageArea object

gtranslator_message_area_new_with_buttons ()

GtkWidget *         gtranslator_message_area_new_with_buttons
                                                        (const gchar *first_button_text,
                                                         ...);

Creates a new GtranslatorMessageArea with buttons. Button text/response ID pairs should be listed, with a NULL pointer ending the list. Button text can be either a stock ID such as GTK_STOCK_OK, or some arbitrary text. A response ID can be any positive number, or one of the values in the GtkResponseType enumeration. If the user clicks one of these dialog buttons, GtranslatorMessageArea will emit the "response" signal with the corresponding response ID.

first_button_text :

stock ID or text to go in first button, or NULL

... :

response ID for first button, then additional buttons, ending with NULL

Returns :

a new GtranslatorMessageArea

gtranslator_message_area_set_contents ()

void                gtranslator_message_area_set_contents
                                                        (GtranslatorMessageArea *message_area,
                                                         GtkWidget *contents);

Adds the contents widget to the contents area of GtranslatorMessageArea.

message_area :

a GtranslatorMessageArea

contents :

widget you want to add to the contents area

gtranslator_message_area_add_action_widget ()

void                gtranslator_message_area_add_action_widget
                                                        (GtranslatorMessageArea *message_area,
                                                         GtkWidget *child,
                                                         gint response_id);

message_area :

child :

response_id :


gtranslator_message_area_add_button ()

GtkWidget *         gtranslator_message_area_add_button (GtranslatorMessageArea *message_area,
                                                         const gchar *button_text,
                                                         gint response_id);

Adds a button with the given text (or a stock button, if button_text is a stock ID) and sets things up so that clicking the button will emit the "response" signal with the given response_id. The button is appended to the end of the message area's action area. The button widget is returned, but usually you don't need it.

message_area :

a GtranslatorMessageArea

button_text :

text of button, or stock ID

response_id :

response ID for the button

Returns :

the button widget that was added

gtranslator_message_area_add_stock_button_with_text ()

GtkWidget *         gtranslator_message_area_add_stock_button_with_text
                                                        (GtranslatorMessageArea *message_area,
                                                         const gchar *text,
                                                         const gchar *stock_id,
                                                         gint response_id);

Same as gtranslator_message_area_add_button() but with a specific text.

message_area :

a GtranslatorMessageArea

text :

the text to visualize in the button

stock_id :

the stock ID of the button

response_id :

a response ID

Returns :


gtranslator_message_area_add_buttons ()

void                gtranslator_message_area_add_buttons
                                                        (GtranslatorMessageArea *message_area,
                                                         const gchar *first_button_text,
                                                         ...);

Adds more buttons, same as calling gtranslator_message_area_add_button() repeatedly. The variable argument list should be NULL-terminated as with gtranslator_message_area_new_with_buttons(). Each button must have both text and response ID.

message_area :

a GtranslatorMessageArea

first_button_text :

button text or stock ID

... :

response ID for first button, then more text-response_id pairs

gtranslator_message_area_set_response_sensitive ()

void                gtranslator_message_area_set_response_sensitive
                                                        (GtranslatorMessageArea *message_area,
                                                         gint response_id,
                                                         gboolean setting);

Calls gtk_widget_set_sensitive (widget, setting) for each widget in the dialog's action area with the given response_id. A convenient way to sensitize/desensitize dialog buttons.

message_area :

a GtranslatorMessageArea

response_id :

a response ID

setting :

TRUE for sensitive

gtranslator_message_area_set_default_response ()

void                gtranslator_message_area_set_default_response
                                                        (GtranslatorMessageArea *message_area,
                                                         gint response_id);

Emits the 'response' signal with the given response_id.

message_area :

a GtranslatorMessageArea

response_id :

a response ID

gtranslator_message_area_response ()

void                gtranslator_message_area_response   (GtranslatorMessageArea *message_area,
                                                         gint response_id);

message_area :

response_id :