thunar-dialogs: Thunar Internal Functions Reference Manual

## thunar-dialogs thunar-dialogs |

## Functions

gchar * | thunar_dialogs_show_create ()
ThunarJob * | thunar_dialogs_show_rename_file ()
void | thunar_dialogs_show_about ()
void | thunar_dialogs_show_error ()
ThunarJobResponse | thunar_dialogs_show_job_ask ()
ThunarJobResponse | thunar_dialogs_show_job_ask_replace ()
void | thunar_dialogs_show_job_error ()
gboolean | thunar_dialogs_show_insecure_program ()
gint | thunar_dialog_confirm_close_split_pane_tabs ()
gint | thunar_dialog_show_rename_launcher_options ()
gint | thunar_dialog_ask_execute ()
void | thunar_dialog_show_launcher_props ()

## Description

## Functions

### thunar_dialogs_show_create ()

    gchar *
    thunar_dialogs_show_create (gpointer parent,
                                const gchar *content_type,
                                const gchar *filename,
                                const gchar *title);

Displays a Thunar create dialog with the specified parameters that asks the user to enter a name for a new file or folder.

The caller is responsible to free the returned filename using `g_free()` when no longer needed.

#### Parameters

parent | a GdkScreen, a GtkWidget or `NULL`. |
content_type | the content type of the file or folder to create. |
filename | the suggested filename or `NULL`. |
title | the dialog title. |

#### Returns

the filename entered by the user or `NULL` if the user cancelled the dialog.

### thunar_dialogs_show_rename_file ()

    ThunarJob *
    thunar_dialogs_show_rename_file (gpointer parent,
                                     ThunarFile *file,
                                     ThunarOperationLogMode log_mode);

Displays the Thunar rename dialog for a single file rename.

#### Parameters

parent | a GtkWidget on which the error dialog should be shown, or a GdkScreen if no GtkWidget is known. May also be `NULL`, in which case the default GdkScreen will be used. |
file | the ThunarFile we're going to rename. |

#### Returns

The ThunarJob responsible for renaming the file or `NULL` if there was no renaming required.

### thunar_dialogs_show_about ()

    void
    thunar_dialogs_show_about (GtkWindow *parent,
                               const gchar *title,
                               const gchar *format,
                               ...);

Displays the Thunar about dialog with `format` as main text.

#### Parameters

parent | the parent GtkWindow or `NULL`. |
title | the software title. |
format | the `printf()`-style format for the main text in the about dialog. |
... | argument list for the `format` . |

### thunar_dialogs_show_error ()

    void
    thunar_dialogs_show_error (gpointer parent,
                               const GError *error,
                               const gchar *format,
                               ...);

Displays an error dialog on `widget` using the `format` as primary message and optionally displaying `error` as secondary error text.

If `widget` is not `NULL` and `widget` is part of a GtkWindow, the function makes sure that the toplevel window is visible prior to displaying the error dialog.

#### Parameters

parent | a GtkWidget on which the error dialog should be shown, or a GdkScreen if no GtkWidget is known. May also be `NULL`, in which case the default GdkScreen will be used. |
error | a GError, which gives a more precise description of the problem or `NULL`. |
format | the `printf()`-style format for the primary problem description. |
... | argument list for the `format` . |

### thunar_dialogs_show_job_ask ()

    ThunarJobResponse
    thunar_dialogs_show_job_ask (GtkWindow *parent,
                                 const gchar *question,
                                 ThunarJobResponse choices);

Utility function to display a question dialog for the ThunarJob::ask signal.

#### Parameters

parent | the parent GtkWindow or `NULL`. |
question | the question text. |
choices | possible responses. |

#### Returns

the ThunarJobResponse.

### thunar_dialogs_show_job_ask_replace ()

    ThunarJobResponse
    thunar_dialogs_show_job_ask_replace (GtkWindow *parent,
                                         ThunarFile *src_file,
                                         ThunarFile *dst_file);

Asks the user whether to replace the destination file with the source file identified by `src_file` .

#### Parameters

parent | the parent GtkWindow or `NULL`. |
src_file | the ThunarFile of the source file. |
dst_file | the ThunarFile of the destination file that may be replaced with the source file. |

#### Returns

the selected ThunarJobResponse.

### thunar_dialogs_show_job_error ()

    void
    thunar_dialogs_show_job_error (GtkWindow *parent,
                                   GError *error);

Utility function to display a message dialog for the ThunarJob::error signal.

#### Parameters

parent | the parent GtkWindow or `NULL`. |
error | the GError provided by the ThunarJob. |

### thunar_dialogs_show_insecure_program ()

    gboolean
    thunar_dialogs_show_insecure_program (gpointer parent,
                                          const gchar *title,
                                          ThunarFile *file,
                                          const gchar *command);

### thunar_dialog_confirm_close_split_pane_tabs ()

    gint
    thunar_dialog_confirm_close_split_pane_tabs
                                   (GtkWindow *parent);

Runs a dialog to ask the user whether they want to close a split pane with multiple tabs

#### Parameters

parent | transient parent of the dialog, or `NULL`. | [allow-none]

#### Returns

GTK_RESPONSE_CANCEL if cancelled, GTK_RESPONSE_CLOSE if the user wants to close all tabs of the other split pane

### thunar_dialog_show_rename_launcher_options ()

    gint
    thunar_dialog_show_rename_launcher_options
                                   (GtkWindow *parent);

Shows a dialog where the user is asked if he wants to edit the launcher name or the actual filename.

#### Parameters

parent | a GtkWidget on which the error dialog should be shown, or a GdkScreen if no GtkWidget is known. May also be `NULL`, in which case the default GdkScreen will be used. |

#### Returns

THUNAR_RESPONSE_FILENAME if the user chooses "Filename", THUNAR_RESPONSE_LAUNCHERNAME if the user selects "Launchername" and GTK_RESPONSE_DELETE_EVENT if the user deletes the dialog.

### thunar_dialog_ask_execute ()

    gint
    thunar_dialog_ask_execute (const ThunarFile *file,
                               gpointer parent,
                               gboolean allow_open,
                               gboolean single_file);

Shows a dialog where the user is asked if and how he wants to run the executable script.

#### Parameters

file | a ThunarFile pointer |
parent | a GtkWidget on which the error dialog should be shown, or a GdkScreen if no GtkWidget is known. May also be `NULL`, in which case the default GdkScreen will be used. |
allow_open | if set, the "Open" button is visible. |
single_file | if set, the file name is visible in dialog message. Otherwise there is generic message about selected files. |

#### Returns

One of ThunarFileAskExecuteResponse enum value.

### thunar_dialog_show_launcher_props ()

    void
    thunar_dialog_show_launcher_props (ThunarFile *launcher,
                                       gpointer parent);

Calls the exo-desktop-item-edit command to edit the properties of a .desktop file. A dialog with the current properties will appear.

#### Parameters

launcher | a ThunarFile. |
parent | a GdkScreen, a GtkWidget or `NULL`. If `NULL` is passed then the default screen will be used. |