java.lang.Object
javax.swing.text.View
javax.swing.text.CompositeView
javax.swing.text.BoxView
javax.swing.text.FlowView
- All Implemented Interfaces:
SwingConstants
- Direct Known Subclasses:
ParagraphView
A View that tries to flow it's children into some
partially constrained space. This can be used to
build things like paragraphs, pages, etc. The
flow is made up of the following pieces of functionality.
- A logical set of child views, which as used as a layout pool from which a physical view is formed.
- A strategy for translating the logical view to a physical (flowed) view.
- Constraints for the strategy to work against.
- A physical structure, that represents the flow. The children of this view are where the pieces of of the logical views are placed to create the flow.
- Since:
- 1.3
- See Also:
-
Nested Class Summary
Modifier and TypeClassDescriptionstatic class
Strategy for maintaining the physical form of the flow. -
Field Summary
Modifier and TypeFieldDescriptionprotected View
These are the views that represent the child elements of the element this view represents (The logical view to translate to a physical view).protected int
Default constraint against which the flow is created against.protected FlowView.FlowStrategy
The behavior for keeping the flow updated.Fields declared in class javax.swing.text.View
BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS
Fields declared in interface javax.swing.SwingConstants
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionprotected SizeRequirements
calculateMinorAxisRequirements
(int axis, SizeRequirements r) Calculate requirements along the minor axis.void
changedUpdate
(DocumentEvent changes, Shape a, ViewFactory f) Gives notification from the document that attributes were changed in a location that this view is responsible for.protected abstract View
Create a View that should be used to hold a a rows worth of children in a flow.int
Fetches the axis along which views should be flowed.int
getFlowSpan
(int index) Fetch the constraining span to flow against for the given child index.int
getFlowStart
(int index) Fetch the location along the flow axis that the flow span will start at.protected int
getViewIndexAtPosition
(int pos) Fetches the child view index representing the given position in the model.void
insertUpdate
(DocumentEvent changes, Shape a, ViewFactory f) Gives notification that something was inserted into the document in a location that this view is responsible for.protected void
layout
(int width, int height) Lays out the children.protected void
Loads all of the children to initialize the view.void
removeUpdate
(DocumentEvent changes, Shape a, ViewFactory f) Gives notification that something was removed from the document in a location that this view is responsible for.Methods declared in class javax.swing.text.BoxView
baselineLayout, baselineRequirements, calculateMajorAxisRequirements, childAllocation, flipEastAndWestAtEnds, forwardUpdate, getAlignment, getAxis, getChildAllocation, getHeight, getMaximumSpan, getMinimumSpan, getOffset, getPreferredSpan, getResizeWeight, getSpan, getViewAtPoint, getWidth, isAfter, isAllocationValid, isBefore, isLayoutValid, layoutChanged, layoutMajorAxis, layoutMinorAxis, modelToView, paint, paintChild, preferenceChanged, replace, setAxis, setSize, viewToModel
Methods declared in class javax.swing.text.CompositeView
getBottomInset, getInsideAllocation, getLeftInset, getNextEastWestVisualPositionFrom, getNextNorthSouthVisualPositionFrom, getNextVisualPositionFrom, getRightInset, getTopInset, getView, getViewAtPosition, getViewCount, getViewIndex, modelToView, setInsets, setParagraphInsets, setParent
Methods declared in class javax.swing.text.View
append, breakView, createFragment, forwardUpdateToView, getAttributes, getBreakWeight, getContainer, getDocument, getElement, getEndOffset, getGraphics, getParent, getStartOffset, getToolTipText, getViewFactory, getViewIndex, insert, isVisible, modelToView, remove, removeAll, updateChildren, updateLayout, viewToModel
-
Field Details
-
layoutSpan
protected int layoutSpanDefault constraint against which the flow is created against. -
layoutPool
These are the views that represent the child elements of the element this view represents (The logical view to translate to a physical view). These are not directly children of this view. These are either placed into the rows directly or used for the purpose of breaking into smaller chunks, to form the physical view. -
strategy
The behavior for keeping the flow updated. By default this is a singleton shared by all instances of FlowView (FlowStrategy is stateless). Subclasses can create an alternative strategy, which might keep state.
-
-
Constructor Details
-
FlowView
Constructs a FlowView for the given element.- Parameters:
elem
- the element that this view is responsible foraxis
- may be either View.X_AXIS or View.Y_AXIS
-
-
Method Details
-
getFlowAxis
public int getFlowAxis()Fetches the axis along which views should be flowed. By default, this will be the axis orthogonal to the axis along which the flow rows are tiled (the axis of the default flow rows themselves). This is typically used by theFlowStrategy
.- Returns:
- the axis along which views should be flowed
-
getFlowSpan
public int getFlowSpan(int index) Fetch the constraining span to flow against for the given child index. This is called by the FlowStrategy while it is updating the flow. A flow can be shaped by providing different values for the row constraints. By default, the entire span inside of the insets along the flow axis is returned.- Parameters:
index
- the index of the row being updated. This should be a value >= 0 and < getViewCount().- Returns:
- the constraining span to flow against for the given child index
- See Also:
-
getFlowStart
public int getFlowStart(int index) Fetch the location along the flow axis that the flow span will start at. This is called by the FlowStrategy while it is updating the flow. A flow can be shaped by providing different values for the row constraints.- Parameters:
index
- the index of the row being updated. This should be a value >= 0 and < getViewCount().- Returns:
- the location along the flow axis that the flow span will start at
- See Also:
-
createRow
Create a View that should be used to hold a a rows worth of children in a flow. This is called by the FlowStrategy when new children are added or removed (i.e. rows are added or removed) in the process of updating the flow.- Returns:
- a View that should be used to hold a a rows worth of children in a flow
-
loadChildren
Loads all of the children to initialize the view. This is called by thesetParent
method. This is reimplemented to not load any children directly (as they are created in the process of formatting). If the layoutPool variable is null, an instance of LogicalView is created to represent the logical view that is used in the process of formatting.- Overrides:
loadChildren
in classCompositeView
- Parameters:
f
- the view factory- See Also:
-
getViewIndexAtPosition
protected int getViewIndexAtPosition(int pos) Fetches the child view index representing the given position in the model.- Overrides:
getViewIndexAtPosition
in classCompositeView
- Parameters:
pos
- the position >= 0- Returns:
- index of the view representing the given position, or -1 if no view represents that position
-
layout
protected void layout(int width, int height) Lays out the children. If the span along the flow axis has changed, layout is marked as invalid which which will cause the superclass behavior to recalculate the layout along the box axis. The FlowStrategy.layout method will be called to rebuild the flow rows as appropriate. If the height of this view changes (determined by the preferred size along the box axis), a preferenceChanged is called. Following all of that, the normal box layout of the superclass is performed. -
calculateMinorAxisRequirements
Calculate requirements along the minor axis. This is implemented to forward the request to the logical view by calling getMinimumSpan, getPreferredSpan, and getMaximumSpan on it.- Overrides:
calculateMinorAxisRequirements
in classBoxView
- Parameters:
axis
- the axis being studiedr
- theSizeRequirements
object; ifnull
one will be created- Returns:
- the newly initialized
SizeRequirements
object - See Also:
-
insertUpdate
Gives notification that something was inserted into the document in a location that this view is responsible for.- Overrides:
insertUpdate
in classView
- Parameters:
changes
- the change information from the associated documenta
- the current allocation of the viewf
- the factory to use to rebuild if the view has children- See Also:
-
removeUpdate
Gives notification that something was removed from the document in a location that this view is responsible for.- Overrides:
removeUpdate
in classView
- Parameters:
changes
- the change information from the associated documenta
- the current allocation of the viewf
- the factory to use to rebuild if the view has children- See Also:
-
changedUpdate
Gives notification from the document that attributes were changed in a location that this view is responsible for.- Overrides:
changedUpdate
in classView
- Parameters:
changes
- the change information from the associated documenta
- the current allocation of the viewf
- the factory to use to rebuild if the view has children- See Also:
-