Class ColorButton
- All Implemented Interfaces:
Accessible, Buildable, ColorChooser, ConstraintTarget, Proxy
The GtkColorButton allows to open a color chooser dialog to change
the color.
It is suitable widget for selecting a color in a preference dialog.
CSS nodes
colorbutton
╰── button.color
╰── [content]
GtkColorButton has a single CSS node with name colorbutton which
contains a button node. To differentiate it from a plain GtkButton,
it gets the .color style class.
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic interfaceDeprecated.Functional interface declaration of theActivateCallbackcallback.static classColorButton.Builder<B extends ColorButton.Builder<B>>Deprecated.Inner class implementing a builder pattern to construct a GObject with properties.static interfaceDeprecated.Functional interface declaration of theColorSetCallbackcallback.Nested classes/interfaces inherited from class 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.WidgetClassNested classes/interfaces inherited from class InitiallyUnowned
InitiallyUnowned.InitiallyUnownedClassNested classes/interfaces inherited from class GObject
GObject.NotifyCallback, GObject.ObjectClassNested classes/interfaces inherited from interface Accessible
Accessible.Accessible$Impl, Accessible.AccessibleInterfaceNested classes/interfaces inherited from interface Buildable
Buildable.Buildable$Impl, Buildable.BuildableIfaceNested classes/interfaces inherited from interface ColorChooser
ColorChooser.ColorActivatedCallback, ColorChooser.ColorChooser$Impl, ColorChooser.ColorChooserInterfaceNested classes/interfaces inherited from interface ConstraintTarget
ConstraintTarget.ConstraintTarget$Impl, ConstraintTarget.ConstraintTargetInterface -
Constructor Summary
ConstructorsConstructorDescriptionDeprecated.Create a new ColorButton.ColorButton(MemorySegment address) Deprecated.Create a ColorButton instance for the provided memory address. -
Method Summary
Modifier and TypeMethodDescriptionprotected ColorButtonasParent()Deprecated.Return this instance as if it were its parent type.static ColorButton.Builder<? extends ColorButton.Builder> builder()Deprecated.AColorButton.Builderobject constructs aColorButtonwith the specified properties.voidDeprecated.Emits the "activate" signal.voidDeprecated.Emits the "color-set" signal.static MemoryLayoutDeprecated.The memory layout of the native struct.booleangetModal()Deprecated.UseColorDialogButtoninsteadgetTitle()Deprecated.UseColorDialogButtoninsteadstatic @Nullable TypegetType()Deprecated.Get the GType of the ColorButton class.onActivate(ColorButton.ActivateCallback handler) Deprecated.Emitted to when the color button is activated.onColorSet(ColorButton.ColorSetCallback handler) Deprecated.Emitted when the user selects a color.voidsetModal(boolean modal) Deprecated.UseColorDialogButtoninsteadvoidDeprecated.UseColorDialogButtoninsteadstatic ColorButtonDeprecated.Creates a new color button showing the given color.Methods inherited from class Widget
actionSetEnabled, activateActionIfExists, activateDefault, 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, unsetStateFlagsMethods inherited from class 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, withPropertiesMethods inherited from class TypeInstance
callParent, callParent, cast, getPrivate, readGClass, writeGClassMethods inherited from class ProxyInstance
equals, handle, hashCodeMethods inherited from class Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface Accessible
announce, getAccessibleId, getAccessibleParent, getAccessibleRole, getAtContext, getBounds, getFirstAccessibleChild, getNextAccessibleSibling, getPlatformState, resetProperty, resetRelation, resetState, setAccessibleParent, updateNextAccessibleSibling, updatePlatformState, updateProperty, updateRelation, updateStateMethods inherited from interface Buildable
getBuildableIdMethods inherited from interface ColorChooser
addPalette, emitColorActivated, getRgba, getUseAlpha, onColorActivated, setRgba, setUseAlpha
-
Constructor Details
-
ColorButton
Deprecated.Create a ColorButton instance for the provided memory address.- Parameters:
address- the memory address of the native object
-
ColorButton
public ColorButton()Deprecated.Create a new ColorButton.
-
-
Method Details
-
getType
Deprecated.Get the GType of the ColorButton class.- Returns:
- the GType
-
getMemoryLayout
Deprecated.The memory layout of the native struct.- Returns:
- the memory layout
-
asParent
Deprecated.Return this instance as if it were its parent type. Comparable to the Javasuperkeyword, but ensures the parent typeclass is also used in native code. -
withRgba
Deprecated.Creates a new color button showing the given color.- Parameters:
rgba- AGdkRGBAto set the current color with- Returns:
- a new color button
-
getModal
Deprecated.UseColorDialogButtoninsteadGets whether the dialog is modal.- Returns:
trueif the dialog is modal
-
getTitle
Deprecated.UseColorDialogButtoninsteadGets the title of the color chooser dialog.- Returns:
- An internal string, do not free the return value
-
setModal
Deprecated.UseColorDialogButtoninsteadSets whether the dialog should be modal.- Parameters:
modal-trueto make the dialog modal
-
setTitle
Deprecated.UseColorDialogButtoninsteadSets the title for the color chooser dialog.- Parameters:
title- String containing new window title
-
onActivate
public SignalConnection<ColorButton.ActivateCallback> onActivate(ColorButton.ActivateCallback handler) Deprecated.Emitted to when the color button is activated.
The
::activatesignal onGtkMenuButtonis an action signal and emitting it causes the button to pop up its dialog.- Parameters:
handler- the signal handler- Returns:
- a signal handler ID to keep track of the signal connection
- Since:
- 4.4
- See Also:
-
emitActivate
public void emitActivate()Deprecated.Emits the "activate" signal. SeeonActivate(ColorButton.ActivateCallback). -
onColorSet
public SignalConnection<ColorButton.ColorSetCallback> onColorSet(ColorButton.ColorSetCallback handler) Deprecated.Emitted when the user selects a color.
When handling this signal, use
ColorChooser.getRgba(RGBA)to find out which color was just selected.Note that this signal is only emitted when the user changes the color. If you need to react to programmatic color changes as well, use the notify::rgba signal.
- Parameters:
handler- the signal handler- Returns:
- a signal handler ID to keep track of the signal connection
- See Also:
-
emitColorSet
public void emitColorSet()Deprecated.Emits the "color-set" signal. SeeonColorSet(ColorButton.ColorSetCallback). -
builder
Deprecated.AColorButton.Builderobject constructs aColorButtonwith the specified properties. Use the variousset...()methods to set properties, and finish construction withColorButton.Builder.build().- Returns:
- the builder object
-
ColorDialogButtoninstead