1. /*

  2.  * @(#)TabableView.java	1.6 00/02/02

  3.  *

  4.  * Copyright 1998-2000 Sun Microsystems, Inc. All Rights Reserved.

  5.  * 

  6.  * This software is the proprietary information of Sun Microsystems, Inc.  

  7.  * Use is subject to license terms.

  8.  * 

  9.  */

  10. package javax.swing.text;

  11. 

  12. 

  13. /**

  14.  * Interface for View's that have size dependant

  15.  * upon tabs.  

  16.  * 

  17.  * @author  Timothy Prinzing

  18.  * @author  Scott Violet

  19.  * @version 1.6 02/02/00

  20.  * @see TabExpander

  21.  * @see LabelView

  22.  * @see ParagraphView

  23.  */

  24. public interface TabableView {

  25. 

  26.     /**

  27.      * Determines the desired span when using the given 

  28.      * tab expansion implementation.  If a container 

  29.      * calls this method, it will do so prior to the

  30.      * normal layout which would call getPreferredSpan.

  31.      * A view implementing this should give the same

  32.      * result in any subsequent calls to getPreferredSpan

  33.      * along the axis of tab expansion.

  34.      *

  35.      * @param x the position the view would be located

  36.      *  at for the purpose of tab expansion >= 0.

  37.      * @param e how to expand the tabs when encountered.

  38.      * @return the desired span >= 0

  39.      */

  40.     float getTabbedSpan(float x, TabExpander e);

  41. 

  42.     /**

  43.      * Determines the span along the same axis as tab 

  44.      * expansion for a portion of the view.  This is

  45.      * intended for use by the TabExpander for cases

  46.      * where the tab expansion involves aligning the

  47.      * portion of text that doesn't have whitespace 

  48.      * relative to the tab stop.  There is therefore

  49.      * an assumption that the range given does not

  50.      * contain tabs.

  51.      *

  52.      * @param p0 the starting location in the text document >= 0

  53.      * @param p1 the ending location in the text document >= p0

  54.      * @return the span >= 0

  55.      */

  56.     float getPartialSpan(int p0, int p1);

  57. }