Package org.fest.swing.core

Class LabelMatcher

java.lang.Object

org.fest.swing.core.AbstractComponentMatcher

org.fest.swing.core.LabelMatcher

All Implemented Interfaces:

ComponentMatcher, ResettableComponentMatcher

public class LabelMatcher
extends AbstractComponentMatcher

Understands Component matching by the text of the associated JLabel and (optionally) by type.

See Also:

• JLabel.getLabelFor()
• JLabel.setLabelFor(Component)

Field Summary

Fields

Modifier and Type	Field	Description
private final String	label
private final Class<? extends Component>	type

Constructor Summary

Constructors

Constructor	Description
LabelMatcher(String label)	Creates a new LabelMatcher.
LabelMatcher(String label, boolean requireShowing)	Creates a new LabelMatcher.
LabelMatcher(String label, Class<? extends Component> type)	Creates a new LabelMatcher.
LabelMatcher(String label, Class<? extends Component> type, boolean requireShowing)	Creates a new LabelMatcher.

Method Summary

Modifier and Type	Method	Description
boolean	matches(Component c)	Indicates whether the given Component matches the criteria specified in this matcher: the text of the JLabel attached to the component to look for matches the text specified in this matcher the component to look for is of the type specified in this matcher (if specified) visibility of the given Component matches the value specified in this matcher
String	toString()

Methods inherited from class org.fest.swing.core.AbstractComponentMatcher

requireShowing, requireShowing, requireShowingMatches, reset

Methods inherited from class java.lang.Object

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

Field Details

label

private final String label

type

private final Class<? extends Component> type

Constructor Details

LabelMatcher

public LabelMatcher(String label)

Creates a new LabelMatcher. The component to match does not have to be showing.

Parameters:

label - the text of the label associated to the component we are looking for.

Throws:

NullPointerException - if the given label is null.

IllegalArgumentException - if the given label is empty.

LabelMatcher

public LabelMatcher(String label,
 boolean requireShowing)

Creates a new LabelMatcher.

Parameters:

label - the text of the label associated to the component we are looking for.

requireShowing - indicates if the component to match should be showing or not.

Throws:

NullPointerException - if the given label is null.

IllegalArgumentException - if the given label is empty.

LabelMatcher

public LabelMatcher(String label,
 Class<? extends Component> type)

Creates a new LabelMatcher. The component to match does not have to be showing.

Parameters:

label - the text of the label associated to the component we are looking for.

type - the type of the component we are looking for.

Throws:

NullPointerException - if the given label is null.

IllegalArgumentException - if the given label is empty.

NullPointerException - if the given type is null.

LabelMatcher

public LabelMatcher(String label,
 Class<? extends Component> type,
 boolean requireShowing)

Creates a new LabelMatcher.

Parameters:

label - the text of the label associated to the component we are looking for.

type - the type of the component we are looking for.

requireShowing - indicates if the component to match should be showing or not.

Throws:

NullPointerException - if the given label is null.

IllegalArgumentException - if the given label is empty.

NullPointerException - if the given type is null.

Method Details

matches

@RunsInCurrentThread
public boolean matches(Component c)

Indicates whether the given Component matches the criteria specified in this matcher:

1. the text of the JLabel
attached to the component to look for matches the text specified in this matcher
2. the component to look for is of the type specified in this matcher (if specified)
3. visibility of the given Component matches the value specified in this matcher

Note: This method is not executed in the event dispatch thread (EDT.) Clients are responsible for invoking this method in the EDT.

Parameters:

c - the Component to verify.

Returns:

true if the name and visibility of the given Component matches the values specified in this matcher, false otherwise.

toString

public String toString()

Overrides:

toString in class Object