Struct gtk4::PrintUnixDialog[][src]

pub struct PrintUnixDialog(_);
Expand description

PrintUnixDialog implements a print dialog for platforms which don’t provide a native print dialog, like Unix.

An example GtkPrintUnixDialog

It can be used very much like any other GTK dialog, at the cost of the portability offered by the high-level printing API with PrintOperation.

In order to print something with PrintUnixDialog, you need to use selected_printer() to obtain a Printer object and use it to construct a PrintJob using PrintJob::new().

PrintUnixDialog uses the following response values:

GtkPrintUnixDialog as GtkBuildable

The PrintUnixDialog implementation of the Buildable interface exposes its notebook internal children with the name “notebook”.

An example of a PrintUnixDialog UI definition fragment:

<object class="GtkPrintUnixDialog" id="dialog1">
  <child internal-child="notebook">
    <object class="GtkNotebook" id="notebook">
      <child>
        <object type="GtkNotebookPage">
          <property name="tab_expand">False</property>
          <property name="tab_fill">False</property>
          <property name="tab">
            <object class="GtkLabel" id="tablabel">
              <property name="label">Tab label</property>
            </object>
          </property>
          <property name="child">
            <object class="GtkLabel" id="tabcontent">
              <property name="label">Content on notebook tab</property>
            </object>
          </property>
        </object>
      </child>
    </object>
  </child>
</object>

CSS nodes

PrintUnixDialog has a single CSS node with name window. The style classes dialog and print are added.

Implements

DialogExt, GtkWindowExt, WidgetExt, glib::ObjectExt, AccessibleExt, BuildableExt, ConstraintTargetExt, NativeExt, RootExt, ShortcutManagerExt, DialogExtManual, WidgetExtManual, AccessibleExtManual

Implementations

This is supported on Linux only.

Creates a new PrintUnixDialog.

title

Title of the dialog, or None

parent

Transient parent of the dialog, or None

Returns

a new PrintUnixDialog

This is supported on Linux only.

Creates a new builder-pattern struct instance to construct PrintUnixDialog objects.

This method returns an instance of PrintUnixDialogBuilder which can be used to create PrintUnixDialog objects.

This is supported on Linux only.

Adds a custom tab to the print dialog.

child

the widget to put in the custom tab

tab_label

the widget to use as tab label

This is supported on Linux only.

Gets the current page of the PrintUnixDialog.

Returns

the current page of self

This is supported on Linux only.

Gets whether to embed the page setup.

Returns

whether to embed the page setup

This is supported on Linux only.

Gets whether there is a selection.

Returns

whether there is a selection

This is supported on Linux only.

Gets the capabilities that have been set on this PrintUnixDialog.

Returns

the printing capabilities

This is supported on Linux only.

Gets the page setup that is used by the PrintUnixDialog.

Returns

the page setup of self.

This is supported on Linux only.

Gets whether a page setup was set by the user.

Returns

whether a page setup was set by user.

This is supported on Linux only.

Gets the currently selected printer.

Returns

the currently selected printer

This is supported on Linux only.

Gets a new PrintSettings object that represents the current values in the print dialog.

Note that this creates a new object, and you need to unref it if don’t want to keep it.

Returns

a new PrintSettings object with the values from self

This is supported on Linux only.

Gets whether the print dialog allows user to print a selection.

Returns

whether the application supports print of selection

This is supported on Linux only.

Sets the current page number.

If current_page is not -1, this enables the current page choice for the range of pages to print.

current_page

the current page number.

This is supported on Linux only.

Embed page size combo box and orientation combo box into page setup page.

embed

embed page setup selection

This is supported on Linux only.

Sets whether a selection exists.

has_selection

true indicates that a selection exists

This is supported on Linux only.

This lets you specify the printing capabilities your application supports.

For instance, if you can handle scaling the output then you pass PrintCapabilities::SCALE. If you don’t pass that, then the dialog will only let you select the scale if the printing system automatically handles scaling.

capabilities

the printing capabilities of your application

This is supported on Linux only.

Sets the page setup of the PrintUnixDialog.

page_setup

a PageSetup

This is supported on Linux only.

Sets the PrintSettings for the PrintUnixDialog.

Typically, this is used to restore saved print settings from a previous print operation before the print dialog is shown.

settings

a PrintSettings, or None

This is supported on Linux only.

Sets whether the print dialog allows user to print a selection.

support_selection

true to allow print selection

This is supported on Linux only.

The PrintSettings object used for this dialog.

This is supported on Linux only.

The PrintSettings object used for this dialog.

This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.

Trait Implementations

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

Formats the value using the given formatter. Read more

Formats the value using the given formatter. Read more

Feeds this value into the given Hasher. Read more

Feeds a slice of this type into the given Hasher. Read more

This method returns an Ordering between self and other. Read more

Compares and returns the maximum of two values. Read more

Compares and returns the minimum of two values. Read more

Restrict a value to a certain interval. Read more

This method tests for self and other values to be equal, and is used by ==. Read more

This method tests for !=.

This method returns an ordering between self and other values if one exists. Read more

This method tests less than (for self and other) and is used by the < operator. Read more

This method tests less than or equal to (for self and other) and is used by the <= operator. Read more

This method tests greater than (for self and other) and is used by the > operator. Read more

This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more

Returns the type identifier of Self.

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Upcasts an object to a superclass or interface T. Read more

Upcasts an object to a reference of its superclass or interface T. Read more

Tries to downcast to a subclass or interface implementor T. Read more

Tries to downcast to a reference of its subclass or interface implementor T. Read more

Tries to cast to an object of type T. This handles upcasting, downcasting and casting between interface and interface implementors. All checks are performed at runtime, while downcast and upcast will do many checks at compile-time already. Read more

Tries to cast to reference to an object of type T. This handles upcasting, downcasting and casting between interface and interface implementors. All checks are performed at runtime, while downcast and upcast will do many checks at compile-time already. Read more

Casts to T unconditionally. Read more

Casts to &T unconditionally. Read more

Performs the conversion.

Performs the conversion.

Returns true if the object is an instance of (can be cast to) T.

Safety Read more

Safety Read more

Safety Read more

Safety Read more

Safety Read more

Safety Read more

Same as connect but takes a SignalId instead of a signal name.

Same as connect_local but takes a SignalId instead of a signal name.

Same as connect_unsafe but takes a SignalId instead of a signal name.

Emit signal by signal id.

Same as emit but takes Value for the arguments.

Emit signal by its name.

Same as emit_by_name but takes Value for the arguments.

Emit signal with details by signal id.

Same as emit_with_details but takes Value for the arguments.

The resulting type after obtaining ownership.

Creates owned data from borrowed data, usually by cloning. Read more

🔬 This is a nightly-only experimental API. (toowned_clone_into)

recently added

Uses borrowed data to replace owned data, usually by cloning. Read more

Returns a SendValue clone of self.

Converts the given value to a String. Read more

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion error.

Performs the conversion.