< prev index next >
src/java.desktop/share/classes/javax/swing/text/html/InlineView.java
Print this page
*** 49,59 ****
}
/**
* Gives notification that something was inserted into
* the document in a location that this view is responsible for.
! * If either parameter is <code>null</code>, behavior of this method is
* implementation dependent.
*
* @param e the change information from the associated document
* @param a the current allocation of the view
* @param f the factory to use to rebuild if the view has children
--- 49,59 ----
}
/**
* Gives notification that something was inserted into
* the document in a location that this view is responsible for.
! * If either parameter is {@code null}, behavior of this method is
* implementation dependent.
*
* @param e the change information from the associated document
* @param a the current allocation of the view
* @param f the factory to use to rebuild if the view has children
*** 65,75 ****
}
/**
* Gives notification that something was removed from the document
* in a location that this view is responsible for.
! * If either parameter is <code>null</code>, behavior of this method is
* implementation dependent.
*
* @param e the change information from the associated document
* @param a the current allocation of the view
* @param f the factory to use to rebuild if the view has children
--- 65,75 ----
}
/**
* Gives notification that something was removed from the document
* in a location that this view is responsible for.
! * If either parameter is {@code null}, behavior of this method is
* implementation dependent.
*
* @param e the change information from the associated document
* @param a the current allocation of the view
* @param f the factory to use to rebuild if the view has children
*** 106,134 ****
}
/**
* Determines how attractive a break opportunity in
* this view is. This can be used for determining which
! * view is the most attractive to call <code>breakView</code>
* on in the process of formatting. A view that represents
* text that has whitespace in it might be more attractive
* than a view that has no whitespace, for example. The
* higher the weight, the more attractive the break. A
! * value equal to or lower than <code>BadBreakWeight</code>
* should not be considered for a break. A value greater
! * than or equal to <code>ForcedBreakWeight</code> should
* be broken.
* <p>
* This is implemented to provide the default behavior
! * of returning <code>BadBreakWeight</code> unless the length
* is greater than the length of the view in which case the
* entire view represents the fragment. Unless a view has
* been written to support breaking behavior, it is not
* attractive to try and break the view. An example of
! * a view that does support breaking is <code>LabelView</code>.
* An example of a view that uses break weight is
! * <code>ParagraphView</code>.
*
* @param axis may be either View.X_AXIS or View.Y_AXIS
* @param pos the potential location of the start of the
* broken view >= 0. This may be useful for calculating tab
* positions.
--- 106,134 ----
}
/**
* Determines how attractive a break opportunity in
* this view is. This can be used for determining which
! * view is the most attractive to call {@code breakView}
* on in the process of formatting. A view that represents
* text that has whitespace in it might be more attractive
* than a view that has no whitespace, for example. The
* higher the weight, the more attractive the break. A
! * value equal to or lower than {@code BadBreakWeight}
* should not be considered for a break. A value greater
! * than or equal to {@code ForcedBreakWeight} should
* be broken.
* <p>
* This is implemented to provide the default behavior
! * of returning {@code BadBreakWeight} unless the length
* is greater than the length of the view in which case the
* entire view represents the fragment. Unless a view has
* been written to support breaking behavior, it is not
* attractive to try and break the view. An example of
! * a view that does support breaking is {@code LabelView}.
* An example of a view that uses break weight is
! * {@code ParagraphView}.
*
* @param axis may be either View.X_AXIS or View.Y_AXIS
* @param pos the potential location of the start of the
* broken view >= 0. This may be useful for calculating tab
* positions.
*** 152,168 ****
/**
* Tries to break this view on the given axis. Refer to
* {@link javax.swing.text.View#breakView} for a complete
* description of this method.
! * <p>Behavior of this method is unspecified in case <code>axis</code>
! * is neither <code>View.X_AXIS</code> nor <code>View.Y_AXIS</code>, and
! * in case <code>offset</code>, <code>pos</code>, or <code>len</code>
* is null.
*
! * @param axis may be either <code>View.X_AXIS</code> or
! * <code>View.Y_AXIS</code>
* @param offset the location in the document model
* that a broken fragment would occupy >= 0. This
* would be the starting offset of the fragment
* returned
* @param pos the position along the axis that the
--- 152,168 ----
/**
* Tries to break this view on the given axis. Refer to
* {@link javax.swing.text.View#breakView} for a complete
* description of this method.
! * <p>Behavior of this method is unspecified in case {@code axis}
! * is neither {@code View.X_AXIS} nor {@code View.Y_AXIS}, and
! * in case {@code offset}, {@code pos}, or {@code len}
* is null.
*
! * @param axis may be either {@code View.X_AXIS} or
! * {@code View.Y_AXIS}
* @param offset the location in the document model
* that a broken fragment would occupy >= 0. This
* would be the starting offset of the fragment
* returned
* @param pos the position along the axis that the
< prev index next >