io.github.cottonmc.cotton.gui.widget

Class WPanel

java.lang.Object

io.github.cottonmc.cotton.gui.widget.WWidget

io.github.cottonmc.cotton.gui.widget.WPanel

Direct Known Subclasses:

WBox, WCardPanel, WClippedPanel, WGridPanel, WPlainPanel, WTabPanel

public abstract class WPanel
extends WWidget

Panels are widgets that contain other widgets.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.List<WWidget>	children The widgets contained within this panel.

Fields inherited from class io.github.cottonmc.cotton.gui.widget.WWidget

height, host, parent, width, x, y

Constructor Summary

Constructors

Constructor and Description
WPanel()

Method Summary

Modifier and Type	Method and Description
void	addPainters() Adds the default background painters to this widget and all children.
boolean	canResize() Checks whether this widget can be resized using WWidget.setSize(int, int).
void	createPeers(GuiDescription c) Creates "heavyweight" component peers
@Nullable WWidget	cycleFocus(boolean lookForwards) Cycles the focus inside this widget.
@Nullable WWidget	cycleFocus(boolean lookForwards, @Nullable WWidget pivot) Cycles the focus inside this panel.
protected void	expandToFit(WWidget w) Expands this panel be at least as large as the widget.
protected void	expandToFit(WWidget w, Insets insets) Expands this panel be at least as large as the widget.
BackgroundPainter	getBackgroundPainter() Gets the current BackgroundPainter of this panel.
WWidget	hit(int x, int y) Finds the most specific child node at this location.
void	layout() Uses this Panel's layout rules to reposition and resize components to fit nicely in the panel.
void	onHidden() Notifies this widget that it won't be drawn and hides any visible peers of itself and its children.
void	onShown() Notifies this widget that it is visible and shows any hidden peers of itself and its children.
void	paint(net.minecraft.client.util.math.MatrixStack matrices, int x, int y, int mouseX, int mouseY) Paints this widget.
void	remove(WWidget w) Removes the widget from this panel.
WPanel	setBackgroundPainter(BackgroundPainter painter) Sets the BackgroundPainter of this panel.
void	tick() Ticks all children of this panel.
java.lang.String	toString()
void	validate(GuiDescription c) Creates component peers, lays out children, and initializes animation data for this Widget and all its children.

Methods inherited from class io.github.cottonmc.cotton.gui.widget.WWidget

addTooltip, canFocus, getAbsoluteX, getAbsoluteY, getHeight, getHost, getParent, getWidth, getX, getY, isActivationKey, isFocused, isWithinBounds, onCharTyped, onClick, onFocusGained, onFocusLost, onKeyPressed, onKeyReleased, onMouseDown, onMouseDrag, onMouseMove, onMouseScroll, onMouseUp, releaseFocus, renderTooltip, requestFocus, setHost, setLocation, setParent, setSize

Methods inherited from class java.lang.Object

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

Field Detail

children

protected final java.util.List<WWidget> children

The widgets contained within this panel.

The list is mutable.

Constructor Detail

WPanel

public WPanel()

Method Detail

createPeers

public void createPeers(GuiDescription c)

Description copied from class: WWidget

Creates "heavyweight" component peers

Overrides:

createPeers in class WWidget

Parameters:

c - the top-level Container that will hold the peers

remove

public void remove(WWidget w)

Removes the widget from this panel.

Parameters:

w - the removed widget

canResize

public boolean canResize()

Description copied from class: WWidget

Checks whether this widget can be resized using WWidget.setSize(int, int).

Overrides:

canResize in class WWidget

Returns:

true if this widget can be resized, false otherwise

setBackgroundPainter

@Environment(value=CLIENT)
public WPanel setBackgroundPainter(BackgroundPainter painter)

Sets the BackgroundPainter of this panel.

Parameters:

painter - the new painter

Returns:

this panel

getBackgroundPainter

@Environment(value=CLIENT)
public BackgroundPainter getBackgroundPainter()

Gets the current BackgroundPainter of this panel.

Returns:

the painter

layout

public void layout()

Uses this Panel's layout rules to reposition and resize components to fit nicely in the panel.

expandToFit

protected void expandToFit(WWidget w)

Expands this panel be at least as large as the widget.

Parameters:

w - the widget

expandToFit

protected void expandToFit(WWidget w,
                           Insets insets)

Expands this panel be at least as large as the widget.

Parameters:

w - the widget

insets - the layout insets

Since:

4.0.0

hit

public WWidget hit(int x,
                   int y)

Finds the most specific child node at this location.

Overrides:

hit in class WWidget

validate

public void validate(GuiDescription c)

Creates component peers, lays out children, and initializes animation data for this Widget and all its children. The host container must clear any heavyweight peers from its records before this method is called.

Subclasses should call super.validate(c) to ensure that children are validated.

Overrides:

validate in class WWidget

Parameters:

c - the host GUI description

paint

@Environment(value=CLIENT)
public void paint(net.minecraft.client.util.math.MatrixStack matrices,
                                              int x,
                                              int y,
                                              int mouseX,
                                              int mouseY)

Description copied from class: WWidget

Paints this widget.

Overrides:

paint in class WWidget

Parameters:

matrices - the rendering matrix stack

x - this widget's X coordinate on the screen

y - this widget's Y coordinate on the screen

mouseX - the X coordinate of the cursor

mouseY - the X coordinate of the cursor

tick

@Environment(value=CLIENT)
public void tick()

Ticks all children of this panel.

Overrides:

tick in class WWidget

cycleFocus

@Nullable
public @Nullable WWidget cycleFocus(boolean lookForwards)

Description copied from class: WWidget

Cycles the focus inside this widget.

If this widget is not focusable, returns null.

Overrides:

cycleFocus in class WWidget

Parameters:

lookForwards - whether this should cycle forwards (true) or backwards (false)

Returns:

the next focused widget, or null if should exit to the parent panel

cycleFocus

@Nullable
public @Nullable WWidget cycleFocus(boolean lookForwards,
                                               @Nullable
                                               @Nullable WWidget pivot)

Cycles the focus inside this panel.

Parameters:

lookForwards - whether this should cycle forwards (true) or backwards (false)

pivot - the widget that should be cycled around (can be null for beginning / end)

Returns:

the next focused widget, or null if should exit to the parent panel

Since:

2.0.0

onShown

public void onShown()

Description copied from class: WWidget

Notifies this widget that it is visible and shows any hidden peers of itself and its children.

Overrides:

onShown in class WWidget

onHidden

public void onHidden()

Description copied from class: WWidget

Notifies this widget that it won't be drawn and hides any visible peers of itself and its children.

The default implementation releases this widget's focus if it is focused. Overriding implementations might want to do this as well.

Overrides:

onHidden in class WWidget

addPainters

@Environment(value=CLIENT)
public void addPainters()

Adds the default background painters to this widget and all children.

Always called before GuiDescription.addPainters() to allow users to modify painters.

Subclasses should call super.addPainters() to ensure that children have proper default painters.

Overrides:

addPainters in class WWidget

Since:

3.0.0

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object