Package org.gnome.gtk

Class Constraint

java.lang.Object

org.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.gnome.gtk.Constraint

All Implemented Interfaces:

Proxy

@Generated("io.github.jwharm.JavaGI")
public class Constraint
extends GObject

Describes a constraint between attributes of two widgets, expressed as a linear equation.

The typical equation for a constraint is:

   target.target_attr = source.source_attr × multiplier + constant
 

Each GtkConstraint is part of a system that will be solved by a ConstraintLayout in order to allocate and position each child widget or guide.

The source and target, as well as their attributes, of a GtkConstraint instance are immutable after creation.

Nested Class Summary

Nested Classes

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

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

GObject.NotifyCallback, GObject.ObjectClass

Constructor Summary

Constructors

Constructor	Description
Constraint()	Creates a new Constraint.
Constraint(MemorySegment address)	Create a Constraint proxy instance for the provided memory address.
Constraint(@Nullable ConstraintTarget target, ConstraintAttribute targetAttribute, ConstraintRelation relation, @Nullable ConstraintTarget source, ConstraintAttribute sourceAttribute, double multiplier, double constant, int strength)	Creates a new constraint representing a relation between a layout attribute on a source and a layout attribute on a target.

Method Summary

Modifier and Type	Method	Description
protected Constraint	asParent()	Returns this instance as if it were its parent type.
static Constraint.Builder<? extends Constraint.Builder>	builder()	A Constraint.Builder object constructs a Constraint with the specified properties.
static Constraint	constant(@Nullable ConstraintTarget target, ConstraintAttribute targetAttribute, ConstraintRelation relation, double constant, int strength)	Creates a new constraint representing a relation between a layout attribute on a target and a constant value.
double	getConstant()	Retrieves the constant factor added to the source attributes' value.
double	getMultiplier()	Retrieves the multiplication factor applied to the source attribute's value.
ConstraintRelation	getRelation()	The order relation between the terms of the constraint.
@Nullable ConstraintTarget	getSource()	Retrieves the ConstraintTarget used as the source for the constraint.
ConstraintAttribute	getSourceAttribute()	Retrieves the attribute of the source to be read by the constraint.
int	getStrength()	Retrieves the strength of the constraint.
@Nullable ConstraintTarget	getTarget()	Retrieves the ConstraintTarget used as the target for the constraint.
ConstraintAttribute	getTargetAttribute()	Retrieves the attribute of the target to be set by the constraint.
static @Nullable Type	getType()	Get the GType of the Constraint class
boolean	isAttached()	Checks whether the constraint is attached to a ConstraintLayout, and it is contributing to the layout.
boolean	isConstant()	Checks whether the constraint describes a relation between an attribute on the Gtk.Constraint:target and a constant value.
boolean	isRequired()	Checks whether the constraint is a required relation for solving the constraint layout.

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, getMemoryLayout, 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

Constructor Details

Constraint

public Constraint(MemorySegment address)

Create a Constraint proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

Constraint

public Constraint(@Nullable ConstraintTarget target,
 ConstraintAttribute targetAttribute,
 ConstraintRelation relation,
 @Nullable ConstraintTarget source,
 ConstraintAttribute sourceAttribute,
 double multiplier,
 double constant,
 int strength)

Creates a new constraint representing a relation between a layout attribute on a source and a layout attribute on a target.

Parameters:

target - the target of the constraint

targetAttribute - the attribute of target to be set

relation - the relation equivalence between target_attribute and source_attribute

source - the source of the constraint

sourceAttribute - the attribute of source to be read

multiplier - a multiplication factor to be applied to source_attribute

constant - a constant factor to be added to source_attribute

strength - the strength of the constraint

Constraint

public Constraint()

Creates a new Constraint.

Method Details

getType

public static @Nullable Type getType()

Get the GType of the Constraint class

Returns:

the GType

asParent

protected Constraint 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 GObject

constant

public static Constraint constant(@Nullable ConstraintTarget target,
 ConstraintAttribute targetAttribute,
 ConstraintRelation relation,
 double constant,
 int strength)

Creates a new constraint representing a relation between a layout attribute on a target and a constant value.

Parameters:

target - a the target of the constraint

targetAttribute - the attribute of target to be set

relation - the relation equivalence between target_attribute and constant

constant - a constant factor to be set on target_attribute

strength - the strength of the constraint

Returns:

the newly created constraint

getConstant

public double getConstant()

Retrieves the constant factor added to the source attributes' value.

Returns:

a constant factor

getMultiplier

public double getMultiplier()

Retrieves the multiplication factor applied to the source attribute's value.

Returns:

a multiplication factor

getRelation

public ConstraintRelation getRelation()

The order relation between the terms of the constraint.

Returns:

a relation type

getSource

public @Nullable ConstraintTarget getSource()

Retrieves the ConstraintTarget used as the source for the constraint.

If the source is set to NULL at creation, the constraint will use the widget using the ConstraintLayout as the source.

Returns:

the source of the constraint

getSourceAttribute

public ConstraintAttribute getSourceAttribute()

Retrieves the attribute of the source to be read by the constraint.

Returns:

the source's attribute

getStrength

public int getStrength()

Retrieves the strength of the constraint.

Returns:

the strength value

getTarget

public @Nullable ConstraintTarget getTarget()

Retrieves the ConstraintTarget used as the target for the constraint.

If the targe is set to NULL at creation, the constraint will use the widget using the ConstraintLayout as the target.

Returns:

a GtkConstraintTarget

getTargetAttribute

public ConstraintAttribute getTargetAttribute()

Retrieves the attribute of the target to be set by the constraint.

Returns:

the target's attribute

isAttached

public boolean isAttached()

Checks whether the constraint is attached to a ConstraintLayout, and it is contributing to the layout.

Returns:

TRUE if the constraint is attached

isConstant

public boolean isConstant()

Checks whether the constraint describes a relation between an attribute on the Gtk.Constraint:target and a constant value.

Returns:

TRUE if the constraint is a constant relation

isRequired

public boolean isRequired()

Checks whether the constraint is a required relation for solving the constraint layout.

Returns:

true if the constraint is required

builder

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

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

Returns:

the builder object