Line (Text API)

java.lang.Object
- org.openide.text.Annotatable
- - org.openide.text.Line

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

DocumentLine
```
public abstract class Line
extends Annotatable
implements java.io.Serializable
```
Represents one line in a text document. The line number may change when the text is modified, but the identity of the line is retained. It is designed to allow line-dependent modules of the IDE (such as the compiler and debugger) to make use of a line consistently even as the text is modified.

See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type	Class	Description
`static class`	`Line.Part`	Representation of the part of the Line's text.
`static class`	`Line.Set`	Object that represents a snapshot of lines at the time it was created.
`static class`	`Line.ShowOpenType`	ShowOpenType and ShowVisibilityType is replacement for constants SHOW_TRY_SHOW, SHOW_SHOW, SHOW_GOTO, SHOW_TOFRONT, SHOW_REUSE, SHOW_REUSE_NEW.
`static class`	`Line.ShowVisibilityType`	ShowOpenType and ShowVisibilityType is replacement for constants SHOW_TRY_SHOW, SHOW_SHOW, SHOW_GOTO, SHOW_TOFRONT, SHOW_REUSE, SHOW_REUSE_NEW.

Field Summary

Fields
Modifier and Type	Field	Description
`static java.lang.String`	`PROP_LINE_NUMBER`	Property name of the line number
`static int`	`SHOW_GOTO`	Deprecated. Deprecated since 6.21. Use `Line.ShowOpenType.OPEN` and `Line.ShowVisibilityType.FOCUS` instead.
`static int`	`SHOW_REUSE`	Deprecated. Deprecated since 6.21. Use `Line.ShowOpenType.REUSE` and `Line.ShowVisibilityType.FOCUS` instead.
`static int`	`SHOW_REUSE_NEW`	Deprecated. Deprecated since 6.21. Use `Line.ShowOpenType.REUSE_NEW` and `Line.ShowVisibilityType.FOCUS` instead.
`static int`	`SHOW_SHOW`	Deprecated. Deprecated since 6.21. Use `Line.ShowOpenType.OPEN` and `Line.ShowVisibilityType.NONE` instead.
`static int`	`SHOW_TOFRONT`	Deprecated. Deprecated since 6.21. Use `Line.ShowOpenType.OPEN` and `Line.ShowVisibilityType.FRONT` instead.
`static int`	`SHOW_TRY_SHOW`	Deprecated. Deprecated since 6.21. Use `Line.ShowOpenType.NONE` and `Line.ShowVisibilityType.NONE` instead.

Fields inherited from class org.openide.text.Annotatable
PROP_ANNOTATION_COUNT, PROP_DELETED, PROP_TEXT

Constructor Summary

Constructors
Constructor	Description
`Line(java.lang.Object source)`	Create a new line object based on a given data object.
`Line(org.openide.util.Lookup context)`	Create a new line object based on a given data object.

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods
Modifier and Type	Method	Description
`boolean`	`canBeMarkedCurrent(int action, Line previousLine)`	Deprecated. Deprecated since 1.20, as `markCurrentLine()` is deprecated by `Annotation.attach(org.openide.text.Annotatable)`.
`Line.Part`	`createPart(int column, int length)`	Create object which represent part of the text on the line.
`java.lang.String`	`getDisplayName()`	Composes a human presentable name for the line.
`abstract int`	`getLineNumber()`	Get the line number.
`org.openide.util.Lookup`	`getLookup()`	Provides access to the context passed into the line constructor.
`java.lang.String`	`getText()`	Get content of the annotatable.
`abstract boolean`	`isBreakpoint()`	Deprecated. Deprecated since 1.20. Use `Annotation` instead.
`abstract void`	`markCurrentLine()`	Deprecated. Deprecated since 1.20. Use `Annotation.attach(org.openide.text.Annotatable)` instead.
`abstract void`	`markError()`	Deprecated. Deprecated since 1.20. Use `Annotation.attach(org.openide.text.Annotatable)` instead.
`abstract void`	`setBreakpoint(boolean b)`	Deprecated. Deprecated since 1.20. Use `Annotation.attach(org.openide.text.Annotatable)` instead.
`void`	`show(int kind)`	Deprecated. Deprecated since 6.21. Use `show(ShowOpenType, ShowVisibilityType)` instead.
`abstract void`	`show(int kind, int column)`	Deprecated. Deprecated since 6.21. Use `show(ShowOpenType, ShowVisibilityType, int)` instead.
`void`	`show(Line.ShowOpenType openType, Line.ShowVisibilityType visibilityType)`	Shows the line (at the first column).
`void`	`show(Line.ShowOpenType openType, Line.ShowVisibilityType visibilityType, int column)`	Show the line.
`abstract void`	`unmarkCurrentLine()`	Deprecated. Deprecated since 1.20. Use `Annotation.detach()` instead.
`abstract void`	`unmarkError()`	Deprecated. Deprecated since 1.20. Use `Annotation.detach()` instead.

Methods inherited from class org.openide.text.Annotatable
addAnnotation, addPropertyChangeListener, firePropertyChange, getAnnotationCount, isDeleted, removeAnnotation, removePropertyChangeListener

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - PROP_LINE_NUMBER
```
public static final java.lang.String PROP_LINE_NUMBER
```
    Property name of the line number
    
    See Also:
    
    Constant Field Values
  - SHOW_TRY_SHOW
```
@Deprecated
public static final int SHOW_TRY_SHOW
```
    Deprecated. Deprecated since 6.21. Use Line.ShowOpenType.NONE and Line.ShowVisibilityType.NONE instead.
    
    Shows the line only if the editor is open.
    
    See Also:
    
    show, Constant Field Values
  - SHOW_SHOW
```
@Deprecated
public static final int SHOW_SHOW
```
    Deprecated. Deprecated since 6.21. Use Line.ShowOpenType.OPEN and Line.ShowVisibilityType.NONE instead.
    
    Opens the editor if necessary and shows the line.
    
    See Also:
    
    show, Constant Field Values
  - SHOW_GOTO
```
@Deprecated
public static final int SHOW_GOTO
```
    Deprecated. Deprecated since 6.21. Use Line.ShowOpenType.OPEN and Line.ShowVisibilityType.FOCUS instead.
    
    Opens the editor if necessary, shows the line, and takes the focus.
    
    See Also:
    
    show, Constant Field Values
  - SHOW_TOFRONT
```
@Deprecated
public static final int SHOW_TOFRONT
```
    Deprecated. Deprecated since 6.21. Use Line.ShowOpenType.OPEN and Line.ShowVisibilityType.FRONT instead.
    
    Same as SHOW_GOTO except that the Window Manager attempts to front the editor window (i.e. make it the top most window).
    
    Since:
    
    5.8
    
    See Also:
    
    show, TopComponent.toFront(), Constant Field Values
  - SHOW_REUSE
```
@Deprecated
public static final int SHOW_REUSE
```
    Deprecated. Deprecated since 6.21. Use Line.ShowOpenType.REUSE and Line.ShowVisibilityType.FOCUS instead.
    
    Takes the focus in case the editor is already opened and shows the line. Replaces (closes) the last editor opened using SHOW_REUSE in case the user haven't interacted with it much (e.g. haven't modified it). Opens a new editor in case there is no such reusable editor and marks it for editor reusal.
    
    Since:
    
    org.openide.text 6.14
    
    See Also:
    
    show, Constant Field Values
  - SHOW_REUSE_NEW
```
@Deprecated
public static final int SHOW_REUSE_NEW
```
    Deprecated. Deprecated since 6.21. Use Line.ShowOpenType.REUSE_NEW and Line.ShowVisibilityType.FOCUS instead.
    
    Focuses or opens given editor, marking it as reusable editor if it was not opened before. Similar to SHOW_REUSE but ignores currently reusable editor.
    
    Since:
    
    org.openide.text 6.14
    
    See Also:
    
    show, Constant Field Values
- Constructor Detail
  - Line
```
public Line(org.openide.util.Lookup context)
```
    Create a new line object based on a given data object. This implementation is abstract, so the specific line number is not used here. Subclasses should somehow specify the position.
    The context argument shall contain information about the producer of the Line, that can be then extracted by getLookup() call.
    
    Parameters:
    
    context - the context for this line
  - Line
```
public Line(java.lang.Object source)
```
    Create a new line object based on a given data object. This implementation is abstract, so the specific line number is not used here. Subclasses should somehow specify the position.
    
    Parameters:
    
    source - the object that is producing the Line
- Method Detail
  - getDisplayName
```
public java.lang.String getDisplayName()
```
    Composes a human presentable name for the line. The default implementation uses the name of data object and the line number to create the display name.
    
    Returns:
    
    human presentable name that should identify the line
  - getLookup
```
public final org.openide.util.Lookup getLookup()
```
    Provides access to the context passed into the line constructor. For example lines produced by DataEditorSupport provide DataObject as the content of the lookup. One can use:
```
   dataObjectOrNull = (DataObject)line.getLookup ().lookup (DataObject.class);
 
```
    to get the access.
    Returns:
    
    context associated with the line
    
    Since:
    
    4.3
  - getLineNumber
```
public abstract int getLineNumber()
```
    Get the line number. The last condition in following should always be true:
```
   Line.Set lineSet = 
   Line l = 

   l.equals (lineSet.getCurrent (l.getLineNumber ()))
 
```
    Returns:
    
    current line number (may change as text is edited) (starting at 0)
  - show
```
@Deprecated
public abstract void show(int kind,
                          int column)
```
    Deprecated. Deprecated since 6.21. Use show(ShowOpenType, ShowVisibilityType, int) instead.
    
    Show the line.
    
    Parameters:
    
    kind - one of SHOW_TRY_SHOW, SHOW_SHOW, or SHOW_GOTO
    
    column - the column of this line which should be selected (starting at 0), value -1 does not change previously selected column
  - show
```
@Deprecated
public void show(int kind)
```
    Deprecated. Deprecated since 6.21. Use show(ShowOpenType, ShowVisibilityType) instead.
    
    Shows the line (at the first column).
    
    Parameters:
    
    kind - one of SHOW_TRY_SHOW, SHOW_SHOW, SHOW_GOTO, SHOW_REUSE or SHOW_REUSE_NEW
    
    See Also:
    
    show(int, int)
  - show
```
public void show(Line.ShowOpenType openType,
                 Line.ShowVisibilityType visibilityType,
                 int column)
```
    Show the line.
    
    Parameters:
    
    openType - one of Line.ShowOpenType.NONE, Line.ShowOpenType.OPEN, Line.ShowOpenType.REUSE or Line.ShowOpenType.REUSE_NEW
    
    visibilityType - one of Line.ShowVisibilityType.NONE, Line.ShowVisibilityType.FRONT or Line.ShowVisibilityType.FOCUS
    
    column - the column of this line which should be selected (starting at 0), value -1 does not change previously selected column
    
    Since:
    
    org.openide.text 6.21
  - show
```
public void show(Line.ShowOpenType openType,
                 Line.ShowVisibilityType visibilityType)
```
    Shows the line (at the first column).
    
    Parameters:
    
    openType - one of Line.ShowOpenType.NONE, Line.ShowOpenType.OPEN, Line.ShowOpenType.REUSE or Line.ShowOpenType.REUSE_NEW
    
    visibilityType - one of Line.ShowVisibilityType.NONE, Line.ShowVisibilityType.FRONT or Line.ShowVisibilityType.FOCUS
    
    Since:
    
    org.openide.text 6.21
    
    See Also:
    
    show(ShowOpenType, ShowVisibilityType, int)
  - setBreakpoint
```
@Deprecated
public abstract void setBreakpoint(boolean b)
```
    Deprecated. Deprecated since 1.20. Use Annotation.attach(org.openide.text.Annotatable) instead.
    
    Set or clear a (debugger) breakpoint at this line.
    
    Parameters:
    
    b - true to turn on
  - isBreakpoint
```
@Deprecated
public abstract boolean isBreakpoint()
```
    Deprecated. Deprecated since 1.20. Use Annotation instead.
    
    Test if there is a breakpoint set at this line.
    
    Returns:
    
    true is there is
  - markError
```
@Deprecated
public abstract void markError()
```
    Deprecated. Deprecated since 1.20. Use Annotation.attach(org.openide.text.Annotatable) instead.
    
    Mark an error at this line.
  - unmarkError
```
@Deprecated
public abstract void unmarkError()
```
    Deprecated. Deprecated since 1.20. Use Annotation.detach() instead.
    
    Unmark error at this line.
  - markCurrentLine
```
@Deprecated
public abstract void markCurrentLine()
```
    Deprecated. Deprecated since 1.20. Use Annotation.attach(org.openide.text.Annotatable) instead.
    
    Mark this line as current.
  - unmarkCurrentLine
```
@Deprecated
public abstract void unmarkCurrentLine()
```
    Deprecated. Deprecated since 1.20. Use Annotation.detach() instead.
    
    Unmark this line as current.
  - canBeMarkedCurrent
```
@Deprecated
public boolean canBeMarkedCurrent(int action,
                                  Line previousLine)
```
    Deprecated. Deprecated since 1.20, as markCurrentLine() is deprecated by Annotation.attach(org.openide.text.Annotatable).
    
    Method that should allow the debugger to communicate with lines that wants to have a control over the current line of debugger. It allows the line to refuse the current status and force the debugger to continue over this line.
    The default implementation simply returns true.
    
    Parameters:
    
    action - type of action that is trying to mark this line as current one of constants (Debugger.ACTION_BREAKPOINT_HIT, Debugger.ACTION_TRACE_OVER, etc.)
    
    previousLine - previous line (if any) or null
    
    Returns:
    
    true if this line accepts the "current" state or false if the line wants the debugger to proceed with next instruction
  - createPart
```
public Line.Part createPart(int column,
                            int length)
```
    Create object which represent part of the text on the line. This part of the line can be used for attaching of annotations.
    
    Parameters:
    
    column - starting column of the part of the text (starting at 0)
    
    length - length of the part of the text
    
    Returns:
    
    instance of the Line.Part which represent the part of the text
    
    Since:
    
    1.20
  - getText
```
public java.lang.String getText()
```
    Description copied from class: Annotatable
    
    Get content of the annotatable. The listeners can listen on changes of PROP_TEXT property to learn that content of Annotatable is changing.
    
    Specified by:
    
    getText in class Annotatable
    
    Returns:
    
    text representing the content of annotatable. The return value can be null, what means that document is closed.

Class Line

Nested Class Summary

Field Summary

Fields inherited from class org.openide.text.Annotatable

Constructor Summary

Method Summary

Methods inherited from class org.openide.text.Annotatable

Methods inherited from class java.lang.Object

Field Detail

PROP_LINE_NUMBER

SHOW_TRY_SHOW

SHOW_SHOW

SHOW_GOTO

SHOW_TOFRONT

SHOW_REUSE

SHOW_REUSE_NEW

Constructor Detail

Line

Line

Method Detail

getDisplayName

getLookup

getLineNumber

show

show

show

show

setBreakpoint

isBreakpoint

markError

unmarkError

markCurrentLine

unmarkCurrentLine

canBeMarkedCurrent

createPart

getText