Package org.gnome.gtk

Class PrintUnixDialog

java.lang.Object

org.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.gnome.gobject.InitiallyUnowned

org.gnome.gtk.Widget

org.gnome.gtk.Window

org.gnome.gtk.Dialog

org.gnome.gtk.PrintUnixDialog

All Implemented Interfaces:

Accessible, Buildable, ConstraintTarget, Native, Root, ShortcutManager, Proxy

@Generated("io.github.jwharm.JavaGI")
public class PrintUnixDialog
extends Dialog
implements Accessible, Buildable, ConstraintTarget, Native, Root, ShortcutManager

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

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 GtkPrintUnixDialog, you need to use getSelectedPrinter() to obtain a Printer object and use it to construct a PrintJob using PrintJob().

GtkPrintUnixDialog uses the following response values:

• ResponseType.OK: for the “Print” button
• ResponseType.APPLY: for the “Preview” button
• ResponseType.CANCEL: for the “Cancel” button

GtkPrintUnixDialog as GtkBuildable
The GtkPrintUnixDialog implementation of the GtkBuildable interface exposes its notebook internal children with the name “notebook”.

An example of a GtkPrintUnixDialog 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
GtkPrintUnixDialog has a single CSS node with name window. The style classes dialog and print are added.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	PrintUnixDialog.Builder<B extends PrintUnixDialog.Builder<B>>	Inner class implementing a builder pattern to construct a GObject with properties.

Nested classes/interfaces inherited from class org.gnome.gtk.Dialog

Dialog.CloseCallback, Dialog.DialogClass, Dialog.ResponseCallback

Nested classes/interfaces inherited from class org.gnome.gtk.Window

Window.ActivateDefaultCallback, Window.ActivateFocusCallback, Window.CloseRequestCallback, Window.EnableDebuggingCallback, Window.KeysChangedCallback, Window.WindowClass

Nested classes/interfaces inherited from class org.gnome.gtk.Widget

Widget.DestroyCallback, Widget.DirectionChangedCallback, Widget.HideCallback, Widget.KeynavFailedCallback, Widget.MapCallback, Widget.MnemonicActivateCallback, Widget.MoveFocusCallback, Widget.QueryTooltipCallback, Widget.RealizeCallback, Widget.ShowCallback, Widget.StateFlagsChangedCallback, Widget.UnmapCallback, Widget.UnrealizeCallback, Widget.Widget$Impl, Widget.WidgetClass

Nested classes/interfaces inherited from class org.gnome.gobject.InitiallyUnowned

InitiallyUnowned.InitiallyUnownedClass

Nested classes/interfaces inherited from class org.gnome.gobject.GObject

GObject.NotifyCallback, GObject.ObjectClass

Nested classes/interfaces inherited from interface org.gnome.gtk.Accessible

Accessible.Accessible$Impl, Accessible.AccessibleInterface

Nested classes/interfaces inherited from interface org.gnome.gtk.Buildable

Buildable.Buildable$Impl, Buildable.BuildableIface

Nested classes/interfaces inherited from interface org.gnome.gtk.ConstraintTarget

ConstraintTarget.ConstraintTarget$Impl, ConstraintTarget.ConstraintTargetInterface

Nested classes/interfaces inherited from interface org.gnome.gtk.Native

Native.Native$Impl, Native.NativeInterface

Nested classes/interfaces inherited from interface org.gnome.gtk.Root

Root.Root$Impl, Root.RootInterface

Nested classes/interfaces inherited from interface org.gnome.gtk.ShortcutManager

ShortcutManager.ShortcutManager$Impl, ShortcutManager.ShortcutManagerInterface

Constructor Summary

Constructors

Constructor	Description
PrintUnixDialog()	Creates a new PrintUnixDialog.
PrintUnixDialog(@Nullable String title, @Nullable Window parent)	Creates a new GtkPrintUnixDialog.
PrintUnixDialog(MemorySegment address)	Create a PrintUnixDialog proxy instance for the provided memory address.

Method Summary

Modifier and Type	Method	Description
void	addCustomTab(Widget child, Widget tabLabel)	Adds a custom tab to the print dialog.
protected PrintUnixDialog	asParent()	Returns this instance as if it were its parent type.
static PrintUnixDialog.Builder<? extends PrintUnixDialog.Builder>	builder()	A PrintUnixDialog.Builder object constructs a PrintUnixDialog with the specified properties.
int	getCurrentPage()	Gets the current page of the GtkPrintUnixDialog.
boolean	getEmbedPageSetup()	Gets whether to embed the page setup.
boolean	getHasSelection()	Gets whether there is a selection.
Set<PrintCapabilities>	getManualCapabilities()	Gets the capabilities that have been set on this GtkPrintUnixDialog.
PageSetup	getPageSetup()	Gets the page setup that is used by the GtkPrintUnixDialog.
boolean	getPageSetupSet()	Gets whether a page setup was set by the user.
PrintSettings	getPrintSettings()	Gets a new GtkPrintSettings object that represents the current values in the print dialog.
@Nullable Printer	getSelectedPrinter()	Gets the currently selected printer.
boolean	getSupportSelection()	Gets whether the print dialog allows user to print a selection.
static @Nullable Type	getType()	Get the GType of the PrintUnixDialog class
void	setCurrentPage(int currentPage)	Sets the current page number.
void	setEmbedPageSetup(boolean embed)	Embed page size combo box and orientation combo box into page setup page.
void	setHasSelection(boolean hasSelection)	Sets whether a selection exists.
void	setManualCapabilities(Set<PrintCapabilities> capabilities)	This lets you specify the printing capabilities your application supports.
void	setManualCapabilities(PrintCapabilities... capabilities)	This lets you specify the printing capabilities your application supports.
void	setPageSetup(PageSetup pageSetup)	Sets the page setup of the GtkPrintUnixDialog.
void	setSettings(@Nullable PrintSettings settings)	Sets the GtkPrintSettings for the GtkPrintUnixDialog.
void	setSupportSelection(boolean supportSelection)	Sets whether the print dialog allows user to print a selection.

Methods inherited from class org.gnome.gtk.Dialog

addActionWidget, addButton, addButtons, close, emitClose, emitResponse, getContentArea, getHeaderBar, getMemoryLayout, getResponseForWidget, getWidgetForResponse, onClose, onResponse, response, setDefaultResponse, setResponseSensitive, withButtons, withButtons

Methods inherited from class org.gnome.gtk.Window

activateDefault, activateFocus, closeRequest, destroy, emitActivateDefault, emitActivateFocus, emitCloseRequest, emitEnableDebugging, emitKeysChanged, enableDebugging, fullscreen, fullscreenOnMonitor, getApplication, getChild, getDecorated, getDefaultIconName, getDefaultSize, getDefaultWidget, getDeletable, getDestroyWithParent, getFocus, getFocusVisible, getGravity, getGroup, getHandleMenubarAccel, getHideOnClose, getIconName, getMnemonicsVisible, getModal, getResizable, getTitle, getTitlebar, getToplevels, getTransientFor, hasGroup, isActive, isFullscreen, isMaximized, isSuspended, keysChanged, listToplevels, maximize, minimize, onActivateDefault, onActivateFocus, onCloseRequest, onEnableDebugging, onKeysChanged, present, presentWithTime, setApplication, setAutoStartupNotification, setChild, setDecorated, setDefaultIconName, setDefaultSize, setDefaultWidget, setDeletable, setDestroyWithParent, setDisplay, setFocus, setFocusVisible, setGravity, setHandleMenubarAccel, setHideOnClose, setIconName, setInteractiveDebugging, setMnemonicsVisible, setModal, setResizable, setStartupId, setTitle, setTitlebar, setTransientFor, unfullscreen, unmaximize, unminimize

Methods inherited from class org.gnome.gtk.Widget

actionSetEnabled, activateActionIfExists, activateWidget, addController, addCssClass, addMnemonicLabel, addTickCallback, allocate, childFocus, computeBounds, computeExpand, computeExpand, computePoint, computeTransform, contains, createPangoContext, createPangoLayout, cssChanged, directionChanged, disposeTemplate, dragCheckThreshold, emitDestroy, emitDirectionChanged, emitHide, emitKeynavFailed, emitMap, emitMnemonicActivate, emitMoveFocus, emitQueryTooltip, emitRealize, emitShow, emitStateFlagsChanged, emitUnmap, emitUnrealize, errorBell, focus, getAllocatedBaseline, getAllocatedHeight, getAllocatedWidth, getAllocation, getAncestor, getBaseline, getCanFocus, getCanTarget, getChildVisible, getClipboard, getColor, getCssClasses, getCssName, getCursor, getDefaultDirection, getDirection, getDisplay, getFirstChild, getFocusable, getFocusChild, getFocusOnClick, getFontMap, getFontOptions, getFrameClock, getHalign, getHasTooltip, getHeight, getHexpand, getHexpandSet, getLastChild, getLayoutManager, getLimitEvents, getMapped, getMarginBottom, getMarginEnd, getMarginStart, getMarginTop, getName, getNative, getNextSibling, getOpacity, getOverflow, getPangoContext, getParent, getPreferredSize, getPrevSibling, getPrimaryClipboard, getRealized, getReceivesDefault, getRequestMode, getRoot, getScaleFactor, getSensitive, getSettings, getSize, getSizeRequest, getStateFlags, getStyleContext, getTemplateChild, getTooltipMarkup, getTooltipText, getValign, getVexpand, getVexpandSet, getVisible, getWidth, grabFocus, hasCssClass, hasDefault, hasFocus, hasVisibleFocus, hide, inDestruction, initTemplate, insertActionGroup, insertAfter, insertBefore, isAncestor, isDrawable, isFocus, isSensitive, isVisible, keynavFailed, listMnemonicLabels, map, measure, mnemonicActivate, moveFocus, observeChildren, observeControllers, onDestroy, onDirectionChanged, onHide, onKeynavFailed, onMap, onMnemonicActivate, onMoveFocus, onQueryTooltip, onRealize, onShow, onStateFlagsChanged, onUnmap, onUnrealize, pick, pick, queryTooltip, queueAllocate, queueDraw, queueResize, realize, removeController, removeCssClass, removeMnemonicLabel, removeTickCallback, root, setCanFocus, setCanTarget, setChildVisible, setCssClasses, setCursor, setCursorFromName, setDefaultDirection, setDirection, setFocusable, setFocusChild, setFocusOnClick, setFontMap, setFontOptions, setHalign, setHasTooltip, setHexpand, setHexpandSet, setLayoutManager, setLimitEvents, setMarginBottom, setMarginEnd, setMarginStart, setMarginTop, setName, setOpacity, setOverflow, setParent, setReceivesDefault, setSensitive, setSizeRequest, setStateFlags, setStateFlags, setTooltipMarkup, setTooltipText, setValign, setVexpand, setVexpandSet, setVisible, shouldLayout, show, sizeAllocate, sizeAllocate, snapshot, snapshotChild, stateFlagsChanged, systemSettingChanged, translateCoordinates, triggerTooltipQuery, unmap, unparent, unrealize, unroot, unsetStateFlags, unsetStateFlags

Methods inherited from class org.gnome.gobject.GObject

addToggleRef, addWeakPointer, bindProperty, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, compatControl, connect, connect, connect, constructed, disconnect, dispatchPropertiesChanged, dispose, dupData, dupQdata, emit, emitNotify, finalize_, forceFloating, freezeNotify, get, getData, getProperty, getProperty, getProperty, getQdata, getv, interfaceFindProperty, interfaceInstallProperty, interfaceListProperties, isFloating, newInstance, newInstance, newv, notify, notify, notifyByPspec, onNotify, ref, refSink, removeToggleRef, removeWeakPointer, replaceData, replaceQdata, runDispose, set, setData, setDataFull, setProperty, setProperty, setProperty, setQdata, setQdataFull, setv, stealData, stealQdata, takeRef, thawNotify, unref, watchClosure, weakRef, weakUnref, withProperties

Methods inherited from class org.gnome.gobject.TypeInstance

callParent, callParent, cast, getPrivate, readGClass, writeGClass

Methods inherited from class org.javagi.base.ProxyInstance

equals, handle, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.gnome.gtk.Accessible

announce, getAccessibleParent, getAccessibleRole, getAtContext, getBounds, getFirstAccessibleChild, getNextAccessibleSibling, getPlatformState, resetProperty, resetRelation, resetState, setAccessibleParent, updateNextAccessibleSibling, updatePlatformState, updateProperty, updateRelation, updateState

Methods inherited from interface org.gnome.gtk.Buildable

getBuildableId

Methods inherited from interface org.gnome.gtk.Native

getRenderer, getSurface, getSurfaceTransform, realize, unrealize

Methods inherited from interface org.javagi.base.Proxy

handle

Methods inherited from interface org.gnome.gtk.Root

getDisplay, getFocus, setFocus

Constructor Details

PrintUnixDialog

public PrintUnixDialog(MemorySegment address)

Create a PrintUnixDialog proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

PrintUnixDialog

public PrintUnixDialog(@Nullable String title,
 @Nullable Window parent)

Creates a new GtkPrintUnixDialog.

Parameters:

title - Title of the dialog

parent - Transient parent of the dialog

PrintUnixDialog

public PrintUnixDialog()

Creates a new PrintUnixDialog.

Method Details

getType

public static @Nullable Type getType()

Get the GType of the PrintUnixDialog class

Returns:

the GType

asParent

protected PrintUnixDialog asParent()

Returns this instance as if it were its parent type. This is mostly synonymous to the Java super keyword, but will set the native typeclass function pointers to the parent type. When overriding a native virtual method in Java, "chaining up" with super.methodName() doesn't work, because it invokes the overridden function pointer again. To chain up, call asParent().methodName(). This will call the native function pointer of this virtual method in the typeclass of the parent type.

Overrides:

asParent in class Dialog

addCustomTab

public void addCustomTab(Widget child,
 Widget tabLabel)

Adds a custom tab to the print dialog.

Parameters:

child - the widget to put in the custom tab

tabLabel - the widget to use as tab label

getCurrentPage

public int getCurrentPage()

Gets the current page of the GtkPrintUnixDialog.

Returns:

the current page of this PrintUnixDialog

getEmbedPageSetup

public boolean getEmbedPageSetup()

Gets whether to embed the page setup.

Returns:

whether to embed the page setup

getHasSelection

public boolean getHasSelection()

Gets whether there is a selection.

Returns:

whether there is a selection

getManualCapabilities

public Set<PrintCapabilities> getManualCapabilities()

Gets the capabilities that have been set on this GtkPrintUnixDialog.

Returns:

the printing capabilities

getPageSetup

public PageSetup getPageSetup()

Gets the page setup that is used by the GtkPrintUnixDialog.

Returns:

the page setup of dialog.

getPageSetupSet

public boolean getPageSetupSet()

Gets whether a page setup was set by the user.

Returns:

whether a page setup was set by user.

getSelectedPrinter

public @Nullable Printer getSelectedPrinter()

Gets the currently selected printer.

Returns:

the currently selected printer

getPrintSettings

public PrintSettings getPrintSettings()

Gets a new GtkPrintSettings 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 GtkPrintSettings object with the values from this PrintUnixDialog

getSupportSelection

public boolean getSupportSelection()

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

Returns:

whether the application supports print of selection

setCurrentPage

public void setCurrentPage(int currentPage)

Sets the current page number.

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

Parameters:

currentPage - the current page number.

setEmbedPageSetup

public void setEmbedPageSetup(boolean embed)

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

Parameters:

embed - embed page setup selection

setHasSelection

public void setHasSelection(boolean hasSelection)

Sets whether a selection exists.

Parameters:

hasSelection - true indicates that a selection exists

setManualCapabilities

public void setManualCapabilities(Set<PrintCapabilities> capabilities)

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.

Parameters:

capabilities - the printing capabilities of your application

setManualCapabilities

public void setManualCapabilities(PrintCapabilities... capabilities)

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.

Parameters:

capabilities - the printing capabilities of your application

setPageSetup

public void setPageSetup(PageSetup pageSetup)

Sets the page setup of the GtkPrintUnixDialog.

Parameters:

pageSetup - a GtkPageSetup

setSettings

public void setSettings(@Nullable PrintSettings settings)

Sets the GtkPrintSettings for the GtkPrintUnixDialog.

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

Parameters:

settings - a GtkPrintSettings

setSupportSelection

public void setSupportSelection(boolean supportSelection)

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

Parameters:

supportSelection - true to allow print selection

builder

public static PrintUnixDialog.Builder<? extends PrintUnixDialog.Builder> builder()

A PrintUnixDialog.Builder object constructs a PrintUnixDialog with the specified properties. Use the various set...() methods to set properties, and finish construction with PrintUnixDialog.Builder.build().

Returns:

the builder object