AlertDialog#

Added in version 4.10.

class AlertDialog(**properties: Any)#

Superclasses: Object

A GtkAlertDialog object collects the arguments that are needed to present a message to the user.

The message is shown with the choose function.

If you don’t need to wait for a button to be clicked, you can use show.

Methods#

class AlertDialog
async choose(self, parent: Window | None = None) → int#

This is the awaitable version of choose().

Added in version 4.10.

Parameters:

parent – the parent GtkWindow

choose(parent: Window | None = None, cancellable: Cancellable | None = None, callback: Callable[[Object | None, AsyncResult, Any], None] | None = None, user_data: Any = None) → None#

This function shows the alert to the user.

It is ok to pass NULL for the callback if the alert does not have more than one button. A simpler API for this case is show.

Added in version 4.10.

Parameters:

  • parent – the parent GtkWindow

  • cancellable – a GCancellable to cancel the operation

  • callback – a callback to call when the operation is complete

  • user_data – data to pass to callback

choose_finish(result: AsyncResult) → int#

Finishes the choose call and returns the index of the button that was clicked.

Added in version 4.10.

Parameters:

result – a GAsyncResult

get_buttons() → list[str] | None#

Returns the button labels for the alert.

Added in version 4.10.

get_cancel_button() → int#

Returns the index of the cancel button.

Added in version 4.10.

get_default_button() → int#

Returns the index of the default button.

Added in version 4.10.

get_detail() → str#

Returns the detail text that will be shown in the alert.

Added in version 4.10.

get_message() → str#

Returns the message that will be shown in the alert.

Added in version 4.10.

get_modal() → bool#

Returns whether the alert blocks interaction with the parent window while it is presented.

Added in version 4.10.

set_buttons(labels: list[str]) → None#

Sets the button labels for the alert.

Added in version 4.10.

Parameters:

labels – the new button labels

set_cancel_button(button: int) → None#

Sets the index of the cancel button.

See cancel_button for details of how this value is used.

Added in version 4.10.

Parameters:

button – the new cancel button

set_default_button(button: int) → None#

Sets the index of the default button.

See default_button for details of how this value is used.

Added in version 4.10.

Parameters:

button – the new default button

set_detail(detail: str) → None#

Sets the detail text that will be shown in the alert.

Added in version 4.10.

Parameters:

detail – the new detail text

set_message(message: str) → None#

Sets the message that will be shown in the alert.

Added in version 4.10.

Parameters:

message – the new message

set_modal(modal: bool) → None#

Sets whether the alert blocks interaction with the parent window while it is presented.

Added in version 4.10.

Parameters:

modal – the new value

show(parent: Window | None = None) → None#

Show the alert to the user.

This function is a simple version of choose intended for dialogs with a single button. If you want to cancel the dialog or if the alert has more than one button, you should use that function instead and provide it with a Cancellable or callback respectively.

Added in version 4.10.

Parameters:

parent – the parent GtkWindow

Properties#

class AlertDialog
props.buttons: list[str]#

The type of the None singleton.

Added in version 4.10.

props.cancel_button: int#

The type of the None singleton.

Added in version 4.10.

props.default_button: int#

The type of the None singleton.

Added in version 4.10.

props.detail: str#

The type of the None singleton.

Added in version 4.10.

props.message: str#

The type of the None singleton.

Added in version 4.10.

props.modal: bool#

The type of the None singleton.

Added in version 4.10.