Package org.gnome.gobject

Class GObject.Builder<B extends GObject.Builder<B>>

java.lang.Object

io.github.jwharm.javagi.gobject.Builder<B>

org.gnome.gobject.GObject.Builder<B>

Type Parameters:

B - the type of the Builder that is returned

All Implemented Interfaces:

BuilderInterface

Direct Known Subclasses:

Adapter.Builder, AlertDialog.Builder, Animation.Builder, AnimationTarget.Builder, AppInfoMonitor.Builder, AppLaunchContext.Builder, Application.Builder, ApplicationCommandLine.Builder, AssistantPage.Builder, ATContext.Builder, Auth.Builder, AuthDomain.Builder, AuthenticationRequest.Builder, AuthManager.Builder, AutomationSession.Builder, BackForwardList.Builder, Binding.Builder, BindingGroup.Builder, BookmarkList.Builder, Breakpoint.Builder, BuilderCScope.Builder, BytesIcon.Builder, Cache.Builder, Cancellable.Builder, CellAreaContext.Builder, CharsetConverter.Builder, CicpParams.Builder, Class.Builder, Clipboard.Builder, ClipboardPermissionRequest.Builder, ColorBalanceChannel.Builder, ColorChooserRequest.Builder, ColorDialog.Builder, ColumnViewColumn.Builder, ColumnViewRow.Builder, Completion.Builder, CompletionContext.Builder, CompletionSnippets.Builder, CompletionWords.Builder, Constraint.Builder, ConstraintGuide.Builder, ContentDecoder.Builder, ContentDeserializer.Builder, ContentProvider.Builder, ContentSerializer.Builder, ContentSniffer.Builder, Context.Builder, Context.Builder, ContextMenu.Builder, ContextMenu.Builder, CookieJar.Builder, CookieManager.Builder, Coverage.Builder, Credentials.Builder, CssProvider.Builder, Cursor.Builder, DataQueue.Builder, DBusActionGroup.Builder, DBusAuthObserver.Builder, DBusConnection.Builder, DBusInterfaceSkeleton.Builder, DBusMessage.Builder, DBusMethodInvocation.Builder, DBusObjectManagerClient.Builder, DBusObjectManagerServer.Builder, DBusObjectProxy.Builder, DBusObjectSkeleton.Builder, DBusProxy.Builder, DBusServer.Builder, DebugControllerDBus.Builder, DesktopAppInfo.Builder, Device.Builder, DeviceInfoPermissionRequest.Builder, DeviceTool.Builder, DirectoryList.Builder, Display.Builder, DisplayManager.Builder, DmabufTextureBuilder.Builder, Download.Builder, Drag.Builder, DrawContext.Builder, Drop.Builder, EditorState.Builder, Emblem.Builder, EmblemedIcon.Builder, EntryBuffer.Builder, EntryCompletion.Builder, EnumListItem.Builder, EnumListModel.Builder, EventController.Builder, Exception.Builder, FaviconDatabase.Builder, File.Builder, FileChooserRequest.Builder, FileDialog.Builder, FileEnumerator.Builder, FileIcon.Builder, FileInfo.Builder, FileLauncher.Builder, FileLoader.Builder, FileMonitor.Builder, FilenameCompleter.Builder, FileSaver.Builder, Filter.Builder, FilterListModel.Builder, FindController.Builder, FlattenListModel.Builder, Font.Builder, FontDialog.Builder, FontFace.Builder, FontFamily.Builder, FontMap.Builder, Fontset.Builder, FormSubmissionRequest.Builder, Frame.Builder, FrameClock.Builder, GeolocationManager.Builder, GeolocationPermissionRequest.Builder, GLShader.Builder, GLTextureBuilder.Builder, GtkBuilder.Builder, GutterLines.Builder, HitTestResult.Builder, HitTestResult.Builder, Hover.Builder, HoverContext.Builder, HSTSEnforcer.Builder, IconPaintable.Builder, IconTheme.Builder, IMContext.Builder, InetAddress.Builder, InetAddressMask.Builder, InitiallyUnowned.Builder, InputMethodContext.Builder, InputStream.Builder, IOStream.Builder, Language.Builder, LanguageManager.Builder, Layout.Builder, Layout.Builder, LayoutChild.Builder, LayoutManager.Builder, LeafletPage.Builder, ListHeader.Builder, ListItem.Builder, ListItemFactory.Builder, ListStore.Builder, ListStore.Builder, Logger.Builder, MapListModel.Builder, MarkAttributes.Builder, MediaKeySystemPermissionRequest.Builder, MediaStream.Builder, MemoryTextureBuilder.Builder, MenuAttributeIter.Builder, MenuItem.Builder, MenuLinkIter.Builder, MenuModel.Builder, Message.Builder, Monitor.Builder, MountOperation.Builder, MultiSelection.Builder, NativeDialog.Builder, NetworkAddress.Builder, NetworkService.Builder, NetworkSession.Builder, NoSelection.Builder, NotebookPage.Builder, Notification.Builder, Notification.Builder, NotificationPermissionRequest.Builder, OptionMenu.Builder, OsxAppInfo.Builder, OutputStream.Builder, PageSetup.Builder, Permission.Builder, Pixbuf.Builder, PixbufAnimation.Builder, PixbufAnimationIter.Builder, PixbufLoader.Builder, PointerLockPermissionRequest.Builder, PolicyDecision.Builder, PrintCompositor.Builder, PrintContext.Builder, PrintDialog.Builder, Printer.Builder, PrintJob.Builder, PrintOperation.Builder, PrintOperation.Builder, PrintSettings.Builder, PropertyAction.Builder, RecentManager.Builder, Region.Builder, Renderer.Builder, Renderer.Builder, Resolver.Builder, ScriptWorld.Builder, SearchContext.Builder, SearchSettings.Builder, Seat.Builder, SecurityManager.Builder, SelectionFilterModel.Builder, Server.Builder, ServerMessage.Builder, Session.Builder, Settings.Builder, Settings.Builder, Settings.Builder, SettingsBackend.Builder, Shortcut.Builder, ShortcutAction.Builder, ShortcutTrigger.Builder, SignalGroup.Builder, SimpleAction.Builder, SimpleActionGroup.Builder, SimpleAsyncResult.Builder, SimpleProxyResolver.Builder, SingleSelection.Builder, SizeGroup.Builder, SliceListModel.Builder, Snapshot.Builder, Snippet.Builder, SnippetContext.Builder, SnippetManager.Builder, Socket.Builder, SocketAddress.Builder, SocketAddressEnumerator.Builder, SocketClient.Builder, SocketControlMessage.Builder, SocketListener.Builder, Sorter.Builder, SortListModel.Builder, SpaceDrawer.Builder, SpinnerPaintable.Builder, SqueezerPage.Builder, StackPage.Builder, StringList.Builder, StringObject.Builder, Style.Builder, StyleContext.Builder, StyleManager.Builder, StyleScheme.Builder, StyleSchemeManager.Builder, Subprocess.Builder, SubprocessLauncher.Builder, Surface.Builder, SwipeTracker.Builder, TabPage.Builder, Task.Builder, TestDBus.Builder, TextBuffer.Builder, TextChildAnchor.Builder, TextMark.Builder, TextTag.Builder, TextTagTable.Builder, Texture.Builder, ThemedIcon.Builder, TlsCertificate.Builder, TlsDatabase.Builder, TlsInteraction.Builder, TlsPassword.Builder, Toast.Builder, Tooltip.Builder, TreeListModel.Builder, TreeListRow.Builder, TreeModelFilter.Builder, TreeModelSort.Builder, TreeSelection.Builder, TreeStore.Builder, TypeModule.Builder, UnixFDList.Builder, UnixMountMonitor.Builder, UriLauncher.Builder, URIRequest.Builder, URIRequest.Builder, URIResponse.Builder, URIResponse.Builder, URISchemeRequest.Builder, URISchemeResponse.Builder, UserContentFilterStore.Builder, UserContentManager.Builder, UserMediaPermissionRequest.Builder, Value.Builder, Vfs.Builder, ViewStackPage.Builder, ViewStackPages.Builder, VirtualMachine.Builder, VolumeMonitor.Builder, WeakValue.Builder, WebContext.Builder, WebEditor.Builder, WebFormManager.Builder, WebHitTestResult.Builder, WebInspector.Builder, WebPage.Builder, WebProcessExtension.Builder, WebResource.Builder, WebsiteDataAccessPermissionRequest.Builder, WebsiteDataManager.Builder, WebsitePolicies.Builder, WebsocketConnection.Builder, WebsocketExtension.Builder, WebsocketExtensionManager.Builder, WidgetPaintable.Builder, WindowGroup.Builder, WindowProperties.Builder, ZlibCompressor.Builder, ZlibDecompressor.Builder

Enclosing class:

GObject

public static class GObject.Builder<B extends GObject.Builder<B>>
extends Builder<B>

Inner class implementing a builder pattern to construct a GObject with properties.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Builder()	Default constructor for a Builder object.

Method Summary

Modifier and Type	Method	Description
GObject	build()	Finish building the GObject object.
B	onNotify(@Nullable String detail, GObject.NotifyCallback handler)	The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

Methods inherited from class io.github.jwharm.javagi.gobject.Builder

addBuilderProperty, connect, connect, connectSignals, getArena, getNames, getValues

Methods inherited from class java.lang.Object

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

Constructor Details

Builder

protected Builder()

Default constructor for a Builder object.

Method Details

build

public GObject build()

Finish building the GObject object. This will call GObject.withProperties(org.gnome.glib.Type, java.lang.String[], org.gnome.gobject.Value[]) to create a new GObject instance, which is then cast to GObject.

Returns:

a new instance of GObject with the properties that were set in the Builder object.

onNotify

public B onNotify(@Nullable
 @Nullable String detail,
 GObject.NotifyCallback handler)

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

Note that getting this signal doesn’t itself guarantee that the value of the property has actually changed. When it is emitted is determined by the derived GObject class. If the implementor did not create the property with ParamFlags.EXPLICIT_NOTIFY, then any call to g_object_set_property() results in ::notify being emitted, even if the new value is the same as the old. If they did pass ParamFlags.EXPLICIT_NOTIFY, then this signal is emitted only when they explicitly call g_object_notify() or g_object_notify_by_pspec(), and common practice is to do that only when the value has actually changed.

This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the g_signal_connect() call, like this:

g_signal_connect (text_view->buffer, "notify::paste-target-list",
                   G_CALLBACK (gtk_text_view_target_list_notify),
                   text_view)
 

It is important to note that you must use GObject.ParamSpec#parameter-names as detail strings for the notify signal.

Parameters:

handler - the signal handler

Returns:

the Builder instance is returned, to allow method chaining

See Also:

• GObject.NotifyCallback.run(org.gnome.gobject.ParamSpec)