org.assertj.swing.fixture

Class JListItemFixture

java.lang.Object

org.assertj.swing.fixture.JListItemFixture

All Implemented Interfaces:

ItemFixture<JListItemFixture>, MouseInputSimulationFixture<JListItemFixture>

public class JListItemFixture
extends Object
implements ItemFixture<JListItemFixture>

Supports functional testing of single items in JLists.

Author:

Yvonne Wang, Alex Ruiz, Christian Rösch

Constructor Summary

Constructors

Constructor and Description
JListItemFixture(JListFixture list, int index) Creates a new JListItemFixture.

Method Summary

Modifier and Type	Method and Description
JListItemFixture	click() Simulates a user clicking this fixture's list item.
JListItemFixture	click(MouseButton button) Simulates a user clicking this fixture's list item.
JListItemFixture	click(MouseClickInfo mouseClickInfo) Simulates a user clicking this fixture's list item.
JListItemFixture	doubleClick() Simulates a user double-clicking this fixture's list item.
JListItemFixture	drag() Simulates a user dragging this fixture's list item.
JListItemFixture	drop() Simulates a user dropping into this fixture's list item.
int	index()
JListItemFixture	rightClick() Simulates a user right-clicking this fixture's list item.
JListItemFixture	select() Simulates a user selecting this fixture's list item.
JPopupMenuFixture	showPopupMenu() Shows a pop-up menu using this fixture's list item as the invoker of the pop-up menu.
JListItemFixture	unselect() Simulates a user unselecting this fixture's list item.
String	value() Returns the String representation of the value of this fixture's list item, using the JListCellReader from the JListFixture that created this JListItemFixture.

Methods inherited from class java.lang.Object

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

Constructor Detail

JListItemFixture

public JListItemFixture(@Nonnull
                        JListFixture list,
                        int index)

Creates a new JListItemFixture.

Parameters:

list - manages the JList containing the list item to be managed by this fixture.

index - index of the list item to be managed by this fixture.

Throws:

NullPointerException - if list is null.

Method Detail

select

@Nonnull
public final JListItemFixture select()

Simulates a user selecting this fixture's list item.

Specified by:

select in interface ItemFixture<JListItemFixture>

Returns:

this fixture.

Throws:

IllegalStateException - if this fixture's JList is disabled.

IllegalStateException - if this fixture's JList is not showing on the screen.

IndexOutOfBoundsException - if this item's index is negative or greater than the index of the last item in the JList.

unselect

@Nonnull
public final JListItemFixture unselect()

Simulates a user unselecting this fixture's list item.

Returns:

this fixture.

Throws:

IllegalStateException - if this fixture's JList is disabled.

IllegalStateException - if this fixture's JList is not showing on the screen.

IndexOutOfBoundsException - if this item's index is negative or greater than the index of the last item in the JList.

click

@Nonnull
public final JListItemFixture click()

Simulates a user clicking this fixture's list item.

Specified by:

click in interface MouseInputSimulationFixture<JListItemFixture>

Returns:

this fixture.

Throws:

IllegalStateException - if this fixture's JList is disabled.

IllegalStateException - if this fixture's JList is not showing on the screen.

IndexOutOfBoundsException - if this item's index is negative or greater than the index of the last item in the JList.

click

@Nonnull
public final JListItemFixture click(@Nonnull
                                             MouseButton button)

Simulates a user clicking this fixture's list item.

Specified by:

click in interface MouseInputSimulationFixture<JListItemFixture>

Parameters:

button - the button to click.

Returns:

this fixture.

Throws:

NullPointerException - if the given MouseButton is null.

IllegalStateException - if this fixture's JList is disabled.

IllegalStateException - if this fixture's JList is not showing on the screen.

IndexOutOfBoundsException - if this item's index is negative or greater than the index of the last item in the JList.

click

@Nonnull
public final JListItemFixture click(@Nonnull
                                             MouseClickInfo mouseClickInfo)

Simulates a user clicking this fixture's list item.

Specified by:

click in interface MouseInputSimulationFixture<JListItemFixture>

Parameters:

mouseClickInfo - specifies the button to click and the times the button should be clicked.

Returns:

this fixture.

Throws:

NullPointerException - if the given MouseClickInfo is null.

IllegalStateException - if this fixture's JList is disabled.

IllegalStateException - if this fixture's JList is not showing on the screen.

IndexOutOfBoundsException - if this item's index is negative or greater than the index of the last item in the JList.

doubleClick

@Nonnull
public final JListItemFixture doubleClick()

Simulates a user double-clicking this fixture's list item.

Specified by:

doubleClick in interface MouseInputSimulationFixture<JListItemFixture>

Returns:

this fixture.

Throws:

IllegalStateException - if this fixture's JList is disabled.

IllegalStateException - if this fixture's JList is not showing on the screen.

IndexOutOfBoundsException - if this item's index is negative or greater than the index of the last item in the JList.

rightClick

@Nonnull
public final JListItemFixture rightClick()

Simulates a user right-clicking this fixture's list item.

Specified by:

rightClick in interface MouseInputSimulationFixture<JListItemFixture>

Returns:

this fixture.

Throws:

IllegalStateException - if this fixture's JList is disabled.

IllegalStateException - if this fixture's JList is not showing on the screen.

IndexOutOfBoundsException - if this item's index is negative or greater than the index of the last item in the JList.

showPopupMenu

@Nonnull
public final JPopupMenuFixture showPopupMenu()

Shows a pop-up menu using this fixture's list item as the invoker of the pop-up menu.

Specified by:

showPopupMenu in interface ItemFixture<JListItemFixture>

Returns:

a fixture that manages the displayed pop-up menu.

Throws:

IllegalStateException - if this fixture's JList is disabled.

IllegalStateException - if this fixture's JList is not showing on the screen.

IndexOutOfBoundsException - if this item's index is negative or greater than the index of the last item in the JList.

ComponentLookupException - if a pop-up menu cannot be found.

value

@Nullable
public final String value()

Returns the String representation of the value of this fixture's list item, using the JListCellReader from the JListFixture that created this JListItemFixture.

Specified by:

value in interface ItemFixture<JListItemFixture>

Returns:

the String representation of the value of this fixture's list item.

Throws:

IndexOutOfBoundsException - if this item's index is negative or greater than the index of the last item in the JList.

See Also:

JListFixture.replaceCellReader(JListCellReader)

drag

@Nonnull
public final JListItemFixture drag()

Simulates a user dragging this fixture's list item.

Specified by:

drag in interface ItemFixture<JListItemFixture>

Returns:

this fixture.

Throws:

IllegalStateException - if this fixture's JList is disabled.

IllegalStateException - if this fixture's JList is not showing on the screen.

IndexOutOfBoundsException - if this item's index is negative or greater than the index of the last item in the JList.

drop

@Nonnull
public final JListItemFixture drop()

Simulates a user dropping into this fixture's list item.

Specified by:

drop in interface ItemFixture<JListItemFixture>

Returns:

this fixture.

Throws:

IllegalStateException - if this fixture's JList is disabled.

IllegalStateException - if this fixture's JList is not showing on the screen.

IndexOutOfBoundsException - if this item's index is negative or greater than the index of the last item in the JList.

ActionFailedException - if there is no drag action in effect.

index

public final int index()

Returns:

the index of this fixture's list item.