Package org.fest.swing.core

Class BasicComponentPrinter

java.lang.Object

org.fest.swing.core.BasicComponentPrinter

All Implemented Interfaces:

ComponentPrinter

public final class BasicComponentPrinter
extends Object
implements ComponentPrinter

Understands printing the String representation of Components to facilitate debugging.

Field Summary

Fields

Modifier and Type	Field	Description
private static final ComponentMatcher	ALWAYS_MATCHES
private final ComponentHierarchy	hierarchy
private static final String	INDENTATION

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	BasicComponentPrinter(ComponentHierarchy hierarchy)	Creates a new BasicComponentPrinter.

Method Summary

Modifier and Type	Method	Description
private static ComponentMatcher	alwaysMatches()
protected final ComponentHierarchy	hierarchy()	Returns the component hierarchy used by this printer.
private ComponentHierarchy	hierarchy(Container root)
private static void	print(Component c, int level, PrintStream out)
private static void	print(Component c, ComponentHierarchy h, ComponentMatcher matcher, int level, PrintStream out)
private static void	print(ComponentHierarchy hierarchy, ComponentMatcher matcher, PrintStream out)
void	printComponents(PrintStream out)	Prints all the components in the hierarchy.
void	printComponents(PrintStream out, Container root)	Prints all the components in the hierarchy under the given root.
void	printComponents(PrintStream out, Class<? extends Component> type)	Prints only the components of the given type in the hierarchy.
void	printComponents(PrintStream out, Class<? extends Component> type, Container root)	Prints all the components of the given type in the hierarchy under the given root.
void	printComponents(PrintStream out, ComponentMatcher matcher)	$Prints only the components that match the given search criteria in the hierarchy.
void	printComponents(PrintStream out, ComponentMatcher matcher, Container root)	$Prints all the components that match the given search criteria under the given root.
static ComponentPrinter	printerWithCurrentAwtHierarchy()	Creates a new BasicComponentPrinter that has access to all the GUI components in the AWT hierarchy.
static ComponentPrinter	printerWithNewAwtHierarchy()	Creates a new BasicComponentPrinter with a new AWT hierarchy.
private void	validateNotNull(PrintStream out)

Methods inherited from class java.lang.Object

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

Field Details

INDENTATION

private static final String INDENTATION

See Also:

• Constant Field Values

ALWAYS_MATCHES

private static final ComponentMatcher ALWAYS_MATCHES

hierarchy

private final ComponentHierarchy hierarchy

Constructor Details

BasicComponentPrinter

protected BasicComponentPrinter(ComponentHierarchy hierarchy)

Creates a new BasicComponentPrinter.

Parameters:

hierarchy - the component hierarchy to use.

Method Details

alwaysMatches

private static ComponentMatcher alwaysMatches()

printerWithNewAwtHierarchy

public static ComponentPrinter printerWithNewAwtHierarchy()

Creates a new BasicComponentPrinter with a new AWT hierarchy. Components created before the created BasicComponentPrinter cannot be accessed by the created BasicComponentPrinter.

Returns:

the created finder.

printerWithCurrentAwtHierarchy

public static ComponentPrinter printerWithCurrentAwtHierarchy()

Creates a new BasicComponentPrinter that has access to all the GUI components in the AWT hierarchy.

Returns:

the created printer.

hierarchy

protected final ComponentHierarchy hierarchy()

Returns the component hierarchy used by this printer.

Returns:

the component hierarchy used by this printer.

printComponents

@RunsInEDT
public void printComponents(PrintStream out)

Prints all the components in the hierarchy.

Specified by:

printComponents in interface ComponentPrinter

Parameters:

out - the output stream where to print the components to.

See Also:

• Formatting.format(Component)

printComponents

@RunsInEDT
public void printComponents(PrintStream out,
 Container root)

Prints all the components in the hierarchy under the given root.

Specified by:

printComponents in interface ComponentPrinter

Parameters:

out - the output stream where to print the components to.

root - the root used as the starting point of the search.

See Also:

• Formatting.format(Component)

printComponents

@RunsInEDT
public void printComponents(PrintStream out,
 Class<? extends Component> type)

Prints only the components of the given type in the hierarchy.

Specified by:

printComponents in interface ComponentPrinter

Parameters:

out - the output stream where to print the components to.

type - the type of components to print.

See Also:

• Formatting.format(Component)

printComponents

@RunsInEDT
public void printComponents(PrintStream out,
 Class<? extends Component> type,
 Container root)

Prints all the components of the given type in the hierarchy under the given root.

Specified by:

printComponents in interface ComponentPrinter

Parameters:

out - the output stream where to print the components to.

type - the type of components to print.

root - the root used as the starting point of the search.

See Also:

• Formatting.format(Component)

printComponents

public void printComponents(PrintStream out,
 ComponentMatcher matcher)

$Prints only the components that match the given search criteria in the hierarchy.

Specified by:

printComponents in interface ComponentPrinter

Parameters:

out - the output stream where to print the components to.

matcher - specifies the search criteria to use filter the components to print.

See Also:

• Formatting.format(Component)

printComponents

public void printComponents(PrintStream out,
 ComponentMatcher matcher,
 Container root)

$Prints all the components that match the given search criteria under the given root.

Specified by:

printComponents in interface ComponentPrinter

Parameters:

out - the output stream where to print the components to.

matcher - specifies the search criteria to use filter the components to print.

root - the root used as the starting point of the search.

See Also:

• Formatting.format(Component)

validateNotNull

private void validateNotNull(PrintStream out)

hierarchy

private ComponentHierarchy hierarchy(Container root)

print

@RunsInEDT
private static void print(ComponentHierarchy hierarchy,
 ComponentMatcher matcher,
 PrintStream out)

print

@RunsInCurrentThread
private static void print(Component c,
 ComponentHierarchy h,
 ComponentMatcher matcher,
 int level,
 PrintStream out)

print

@RunsInCurrentThread
private static void print(Component c,
 int level,
 PrintStream out)