< 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 &gt;= 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 &gt;= 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 &gt;= 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 &gt;= 0. This * would be the starting offset of the fragment * returned * @param pos the position along the axis that the
< prev index next >