|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.gnu.glib.GObject
org.gnu.gtk.GtkObject
org.gnu.gtk.Widget
org.gnu.gtk.Container
org.gnu.gtk.TextView
Widget for displaying textual data.
java-gnome has an extremely powerful framework for multiline text editing. The
primary objects involved in the process are TextBuffer
, which represents
the text being edited, and TextView
, a widget which can display a
TextBuffer. Each buffer can be displayed by any number of views.
One of the important things to remember about text in java-gnome is that it's in the UTF-8 encoding. This means that one character can be encoded as multiple bytes. Character counts are usually referred to as offsets, while byte counts are called indexes. If you confuse these two, things will work fine with ASCII, but as soon as your buffer contains multibyte characters, bad things will happen.
Text in a buffer can be marked with tags. A tag is an attribute that can
be applied to some range of text. For example, a tag might be called "bold"
and make the text inside the tag bold. However, the tag concept is more
general than that; tags don't have to affect appearance. They can instead
affect the behavior of mouse and key presses, "lock" a range of text so the
user can't edit it, or countless other things. A tag is represented by a
TextTag
object. One TextTag can be applied to any number of text
ranges in any number of buffers.
Each tag is stored in a TextTagTable
. A tag table defines a set of
tags that can be used together. Each buffer has one tag table associated with
it; only tags from that tag table can be used with the buffer. A single tag
table can be shared between multiple buffers, however.
Tags can have names, which is convenient sometimes (for example, you can name your tag that makes things bold "bold"), but they can also be anonymous (which is convenient if you're creating tags on-the-fly).
Most text manipulation is accomplished with iterators, represented by a
TextIter
. An iterator represents a position between two characters in
the text buffer. Iterators are not valid indefinitely; whenever the buffer is
modified in a way that affects the number of characters in the buffer, all
outstanding iterators become invalid. (Note that deleting 5 characters and
then reinserting 5 still invalidates iterators, though you end up with the
same number of characters you pass through a state with a different number).
Because of this, iterators can't be used to preserve positions across
buffer modifications. To preserve a position, the TextMark
object is
ideal. You can think of a mark as an invisible cursor or insertion point; it
floats in the buffer, saving a position. If the text surrounding the mark is
deleted, the mark remains in the position the text once occupied; if text is
inserted at the mark, the mark ends up either to the left or to the right of
the new text, depending on its gravity. The standard text cursor in
left-to-right languages is a mark with right gravity, because it stays to the
right of inserted text.
Like tags, marks can be either named or anonymous. There are two marks
built-in to TextBuffer
; these are named "insert" and
"selection_bound" and refer to the insertion point and the boundary of the
selection which is not the insertion point, respectively. If no text is
selected, these two marks will be in the same position. You can manipulate
what is selected and where the cursor appears by moving these marks around.
Text buffers always contain at least one line, but may be empty (that is, buffers can contain zero characters). The last line in the text buffer never ends in a line separator (such as newline); the other lines in the buffer always end in a line separator. Line separators count as characters when computing character counts and character offsets. Note that some Unicode line separators are represented with multiple bytes in UTF-8, and the two-character sequence "\r\n" is also considered a line separator.
Field Summary |
Fields inherited from class org.gnu.glib.GObject |
eventsInitialized |
Constructor Summary | |
TextView()
Constructs a new TextView. |
|
TextView(Handle handle)
Construct a TextView from a handle to a native resource. |
|
TextView(TextBuffer buffer)
Creates a new TextView widget displaying the buffer buffer. |
Method Summary | |
void |
addChild(Widget child,
TextChildAnchor anchor)
Adds a child widget in the text buffer, at the given anchor. |
void |
addListener(TextViewListener listener)
Register an object to receive text view event notification. |
protected void |
fireTextViewEvent(TextViewEvent event)
|
boolean |
getAcceptsTab()
Returns whether pressing the Tab key inserts a tab characters. |
TextBuffer |
getBuffer()
Returns the buffer being used |
TextAttributes |
getDefaultAttributes()
Obtains a copy of the default text attributes. |
boolean |
getEditable()
Returns the default editability of the GtkTextView. |
java.lang.Class |
getEventListenerClass(java.lang.String signal)
|
EventType |
getEventType(java.lang.String signal)
|
Adjustment |
getHAdjustment()
|
protected static Handle |
getHAdjustment(Handle textView)
|
boolean |
getOverwrite()
Returns whether the TextView is in overwrite mode or not. |
static Type |
getType()
Retrieve the runtime type used by the GLib library. |
Adjustment |
getVAdjustment()
|
protected static Handle |
getVAdjustment(Handle textView)
|
protected static void |
gtk_text_view_add_child_at_anchor(Handle textView,
Handle child,
Handle anchor)
|
protected static void |
gtk_text_view_add_child_in_window(Handle textView,
Handle child,
int whichWindow,
int xpos,
int ypos)
|
protected static boolean |
gtk_text_view_backward_display_line_start(Handle textView,
Handle iter)
|
protected static boolean |
gtk_text_view_backward_display_line(Handle textView,
Handle iter)
|
protected static void |
gtk_text_view_buffer_to_window_coords(Handle textView,
int win,
int bufferX,
int bufferY,
int[] windowX,
int[] windowY)
|
protected static boolean |
gtk_text_view_forward_display_line_end(Handle textView,
Handle iter)
|
protected static boolean |
gtk_text_view_forward_display_line(Handle textView,
Handle iter)
|
protected static boolean |
gtk_text_view_get_accepts_tab(Handle textview)
|
protected static int |
gtk_text_view_get_border_window_size(Handle textView,
int type)
|
protected static Handle |
gtk_text_view_get_buffer(Handle textView)
|
protected static boolean |
gtk_text_view_get_cursor_visible(Handle textView)
|
protected static Handle |
gtk_text_view_get_default_attributes(Handle textView)
|
protected static boolean |
gtk_text_view_get_editable(Handle textView)
|
protected static int |
gtk_text_view_get_indent(Handle textView)
|
protected static void |
gtk_text_view_get_iter_at_location(Handle textView,
Handle iter,
int x,
int y)
|
protected static void |
gtk_text_view_get_iter_location(Handle textView,
Handle iter,
int location)
|
protected static int |
gtk_text_view_get_justification(Handle textView)
|
protected static int |
gtk_text_view_get_left_margin(Handle textView)
|
protected static void |
gtk_text_view_get_line_at_y(Handle textView,
Handle targetIter,
int y,
int[] lneTop)
|
protected static void |
gtk_text_view_get_line_yrange(Handle textView,
Handle iter,
int[] y,
int[] height)
|
protected static boolean |
gtk_text_view_get_overwrite(Handle view)
|
protected static int |
gtk_text_view_get_pixels_above_lines(Handle textView)
|
protected static int |
gtk_text_view_get_pixels_below_lines(Handle textView)
|
protected static int |
gtk_text_view_get_pixels_inside_wrap(Handle textView)
|
protected static int |
gtk_text_view_get_right_margin(Handle textView)
|
protected static Handle |
gtk_text_view_get_tabs(Handle textView)
|
protected static int |
gtk_text_view_get_type()
|
protected static void |
gtk_text_view_get_visible_rect(Handle textView,
Handle visibleRect)
|
protected static int |
gtk_text_view_get_window_type(Handle textView,
Handle window)
|
protected static Handle |
gtk_text_view_get_window(Handle textView,
int win)
|
protected static int |
gtk_text_view_get_wrap_mode(Handle textView)
|
protected static void |
gtk_text_view_move_child(Handle textView,
Handle child,
int xpos,
int ypos)
|
protected static boolean |
gtk_text_view_move_mark_onscreen(Handle textView,
Handle mark)
|
protected static boolean |
gtk_text_view_move_visually(Handle textView,
Handle iter,
int count)
|
protected static Handle |
gtk_text_view_new_with_buffer(Handle buffer)
|
protected static Handle |
gtk_text_view_new()
|
protected static boolean |
gtk_text_view_place_cursor_onscreen(Handle textView)
|
protected static void |
gtk_text_view_scroll_mark_onscreen(Handle textView,
Handle mark)
|
protected static boolean |
gtk_text_view_scroll_to_iter(Handle textView,
Handle iter,
double withinMargin,
boolean useAlign,
double xalign,
double yalign)
|
protected static void |
gtk_text_view_scroll_to_mark(Handle textView,
Handle mark,
double withinMargin,
boolean useAlign,
double xalign,
double yalign)
|
protected static void |
gtk_text_view_set_accepts_tab(Handle view,
boolean setting)
|
protected static void |
gtk_text_view_set_border_window_size(Handle textView,
int type,
int size)
|
protected static void |
gtk_text_view_set_buffer(Handle textView,
Handle buffer)
|
protected static void |
gtk_text_view_set_cursor_visible(Handle textView,
boolean setting)
|
protected static void |
gtk_text_view_set_editable(Handle textView,
boolean setting)
|
protected static void |
gtk_text_view_set_indent(Handle textView,
int indent)
|
protected static void |
gtk_text_view_set_justification(Handle textView,
int justification)
|
protected static void |
gtk_text_view_set_left_margin(Handle textView,
int leftMargin)
|
protected static void |
gtk_text_view_set_overwrite(Handle view,
boolean setting)
|
protected static void |
gtk_text_view_set_pixels_above_lines(Handle textView,
int pixelsAboveLines)
|
protected static void |
gtk_text_view_set_pixels_below_lines(Handle textView,
int pixelsBelowLines)
|
protected static void |
gtk_text_view_set_pixels_inside_wrap(Handle textView,
int pixelsInsideWrap)
|
protected static void |
gtk_text_view_set_right_margin(Handle textView,
int rightMargin)
|
protected static void |
gtk_text_view_set_tabs(Handle textView,
Handle tabs)
|
protected static void |
gtk_text_view_set_wrap_mode(Handle textView,
int wrapMode)
|
protected static boolean |
gtk_text_view_starts_display_line(Handle textView,
Handle iter)
|
protected static void |
gtk_text_view_window_to_buffer_coords(Handle textView,
int win,
int windowX,
int windowY,
int[] bufferX,
int[] bufferY)
|
boolean |
moveCursorOnScreen()
Moves the cursor to the currently visible region of the buffer, it it isn't there already. |
void |
removeListener(TextViewListener listener)
Unregister an object that was receiving text view event notification. |
boolean |
scrollToIter(TextIter iter,
double withinMargin)
Scrolls text view so that iter is on the screen. |
boolean |
scrollToIter(TextIter iter,
double withinMargin,
double xAlign,
double yAlign)
Scrolls text view so that iter is on the screen in the position indicated by xalign and yalign. |
void |
scrollToMark(TextMark mark,
double withinMargin)
Scrolls the view so that mark is on the screen. |
void |
scrollToMark(TextMark mark,
double withinMargin,
boolean useAlign,
double xAlign,
double yAlign)
Scrolls the view so that mark is on the screen in the position indicated by xAlign and yAlign. |
void |
setAcceptsTab(boolean acceptsTab)
Sets the behavior of the text widget when the Tab key is pressed. |
void |
setBuffer(TextBuffer buffer)
Sets buffer as the buffer being displayed by the view. |
void |
setCursorVisible(boolean setting)
Toggles whether the insertion point is displayed. |
void |
setEditable(boolean setting)
Sets the default editability of the GtkTextView. |
void |
setIndent(int indent)
Sets the default indentation for paragraphs in text_view. |
void |
setJustification(Justification justification)
Sets the default justification of text in text_view. |
void |
setLeftMargin(int leftMargin)
Sets the default left margin for text in text_view. |
void |
setOverwrite(boolean overwrite)
Changes the overwrite mode (whether text is overwritten) |
void |
setPixelsAboveLines(int pixelsAboveLines)
Sets the default number of blank pixels above paragraphs in text_view. |
void |
setPixelsBelowLine(int pixelsBelowLines)
Sets the default number of pixels of blank space to put below paragraphs in text_view. |
void |
setPixelsInsideWrap(int pixelsInsideWrap)
Sets the default number of pixels of blank space to leave between display/wrapped lines within a paragraph. |
void |
setRightMargin(int rightMargin)
Sets the default right margin for text in text_view. |
void |
setTabs(TabArray tabStops)
Sets the default tab stops for paragraphs in text_view. |
void |
setWrapMode(WrapMode wrapMode)
Sets the line wrapping for the view. |
Methods inherited from class org.gnu.gtk.GtkObject |
getFlags, gtk_object_destroy, gtk_object_get_type, gtk_object_sink, setFlags, sink |
Methods inherited from class java.lang.Object |
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public TextView()
public TextView(TextBuffer buffer)
buffer
- Buffer to usepublic TextView(Handle handle)
Method Detail |
public void setBuffer(TextBuffer buffer)
buffer
- The new buffer to displaypublic TextBuffer getBuffer()
public void scrollToMark(TextMark mark, double withinMargin, boolean useAlign, double xAlign, double yAlign)
mark
- A TextMark
withinMargin
- Margin as a fraction of screen sizeuseAlign
- Whether to use alignment arguments.xAlign
- Horizontal alignment of mark within visible area.yAlign
- : vertical alignment of mark within visible areapublic void scrollToMark(TextMark mark, double withinMargin)
mark
- A TextMark
withinMargin
- Margin as a fraction of screen sizepublic boolean scrollToIter(TextIter iter, double withinMargin, double xAlign, double yAlign)
iter
- a TextIterwithinMargin
- Margin as a [0.0,0.5) fraction of screen size.xAlign
- : horizontal alignment of mark within visible area.yAlign
- : vertical alignment of mark within visible area
public boolean scrollToIter(TextIter iter, double withinMargin)
iter
- a TextIterwithinMargin
- Margin as a [0.0,0.5) fraction of screen size.
public boolean moveCursorOnScreen()
public void addChild(Widget child, TextChildAnchor anchor)
child
- A Widgetanchor
- A TextChildAnchor in the TextBuffer for his viewpublic void setWrapMode(WrapMode wrapMode)
wrapMode
- A WrapModepublic void setEditable(boolean setting)
setting
- Whether it's editablepublic boolean getEditable()
public void setCursorVisible(boolean setting)
setting
- Whether to show the insertion cursorpublic void setPixelsAboveLines(int pixelsAboveLines)
pixelsAboveLines
- Pixels above paragraphspublic void setPixelsBelowLine(int pixelsBelowLines)
pixelsBelowLines
- Pixels below paragraphspublic void setPixelsInsideWrap(int pixelsInsideWrap)
pixelsInsideWrap
- Default number of pixels between wrapped linespublic void setJustification(Justification justification)
justification
- The justification to use.public void setLeftMargin(int leftMargin)
leftMargin
- Size of left margin, in pixelspublic void setRightMargin(int rightMargin)
rightMargin
- Size of right margin, in pixelspublic void setIndent(int indent)
indent
- Indentation in pixelspublic void setTabs(TabArray tabStops)
tabStops
- tabs as a PangoTabArraypublic TextAttributes getDefaultAttributes()
public void setAcceptsTab(boolean acceptsTab)
acceptsTab
- TRUE if pressing the Tab key should insert a tab character, FALSE, if pressing the Tab key should move the keyboard focuspublic boolean getAcceptsTab()
setAcceptsTab(boolean)
public void setOverwrite(boolean overwrite)
overwrite
- TRUE to turn on overwrite mode, FALSE to turn it offpublic boolean getOverwrite()
setOverwrite(boolean)
public Adjustment getHAdjustment()
public Adjustment getVAdjustment()
public java.lang.Class getEventListenerClass(java.lang.String signal)
getEventListenerClass
in class Container
public EventType getEventType(java.lang.String signal)
getEventType
in class Container
public void addListener(TextViewListener listener)
listener
- The object that has implemented the
TextViewListener interface that is to receive the text view events.public void removeListener(TextViewListener listener)
listener
- The object that is to no longer receive
text view events.protected void fireTextViewEvent(TextViewEvent event)
public static Type getType()
protected static final Handle getHAdjustment(Handle textView)
protected static final Handle getVAdjustment(Handle textView)
protected static final int gtk_text_view_get_type()
protected static final Handle gtk_text_view_new()
protected static final Handle gtk_text_view_new_with_buffer(Handle buffer)
protected static final void gtk_text_view_set_buffer(Handle textView, Handle buffer)
protected static final Handle gtk_text_view_get_buffer(Handle textView)
protected static final boolean gtk_text_view_scroll_to_iter(Handle textView, Handle iter, double withinMargin, boolean useAlign, double xalign, double yalign)
protected static final void gtk_text_view_scroll_to_mark(Handle textView, Handle mark, double withinMargin, boolean useAlign, double xalign, double yalign)
protected static final void gtk_text_view_scroll_mark_onscreen(Handle textView, Handle mark)
protected static final boolean gtk_text_view_move_mark_onscreen(Handle textView, Handle mark)
protected static final boolean gtk_text_view_place_cursor_onscreen(Handle textView)
protected static final void gtk_text_view_get_visible_rect(Handle textView, Handle visibleRect)
protected static final void gtk_text_view_set_cursor_visible(Handle textView, boolean setting)
protected static final boolean gtk_text_view_get_cursor_visible(Handle textView)
protected static final void gtk_text_view_get_iter_location(Handle textView, Handle iter, int location)
protected static final void gtk_text_view_get_iter_at_location(Handle textView, Handle iter, int x, int y)
protected static final void gtk_text_view_get_line_yrange(Handle textView, Handle iter, int[] y, int[] height)
protected static final void gtk_text_view_get_line_at_y(Handle textView, Handle targetIter, int y, int[] lneTop)
protected static final void gtk_text_view_buffer_to_window_coords(Handle textView, int win, int bufferX, int bufferY, int[] windowX, int[] windowY)
protected static final void gtk_text_view_window_to_buffer_coords(Handle textView, int win, int windowX, int windowY, int[] bufferX, int[] bufferY)
protected static final Handle gtk_text_view_get_window(Handle textView, int win)
protected static final int gtk_text_view_get_window_type(Handle textView, Handle window)
protected static final void gtk_text_view_set_border_window_size(Handle textView, int type, int size)
protected static final int gtk_text_view_get_border_window_size(Handle textView, int type)
protected static final boolean gtk_text_view_forward_display_line(Handle textView, Handle iter)
protected static final boolean gtk_text_view_backward_display_line(Handle textView, Handle iter)
protected static final boolean gtk_text_view_forward_display_line_end(Handle textView, Handle iter)
protected static final boolean gtk_text_view_backward_display_line_start(Handle textView, Handle iter)
protected static final boolean gtk_text_view_starts_display_line(Handle textView, Handle iter)
protected static final boolean gtk_text_view_move_visually(Handle textView, Handle iter, int count)
protected static final void gtk_text_view_add_child_at_anchor(Handle textView, Handle child, Handle anchor)
protected static final void gtk_text_view_add_child_in_window(Handle textView, Handle child, int whichWindow, int xpos, int ypos)
protected static final void gtk_text_view_move_child(Handle textView, Handle child, int xpos, int ypos)
protected static final void gtk_text_view_set_wrap_mode(Handle textView, int wrapMode)
protected static final int gtk_text_view_get_wrap_mode(Handle textView)
protected static final void gtk_text_view_set_editable(Handle textView, boolean setting)
protected static final boolean gtk_text_view_get_editable(Handle textView)
protected static final void gtk_text_view_set_pixels_above_lines(Handle textView, int pixelsAboveLines)
protected static final int gtk_text_view_get_pixels_above_lines(Handle textView)
protected static final void gtk_text_view_set_pixels_below_lines(Handle textView, int pixelsBelowLines)
protected static final int gtk_text_view_get_pixels_below_lines(Handle textView)
protected static final void gtk_text_view_set_pixels_inside_wrap(Handle textView, int pixelsInsideWrap)
protected static final int gtk_text_view_get_pixels_inside_wrap(Handle textView)
protected static final void gtk_text_view_set_justification(Handle textView, int justification)
protected static final int gtk_text_view_get_justification(Handle textView)
protected static final void gtk_text_view_set_left_margin(Handle textView, int leftMargin)
protected static final int gtk_text_view_get_left_margin(Handle textView)
protected static final void gtk_text_view_set_right_margin(Handle textView, int rightMargin)
protected static final int gtk_text_view_get_right_margin(Handle textView)
protected static final void gtk_text_view_set_indent(Handle textView, int indent)
protected static final int gtk_text_view_get_indent(Handle textView)
protected static final void gtk_text_view_set_tabs(Handle textView, Handle tabs)
protected static final Handle gtk_text_view_get_tabs(Handle textView)
protected static final Handle gtk_text_view_get_default_attributes(Handle textView)
protected static final void gtk_text_view_set_accepts_tab(Handle view, boolean setting)
protected static final boolean gtk_text_view_get_accepts_tab(Handle textview)
protected static final void gtk_text_view_set_overwrite(Handle view, boolean setting)
protected static final boolean gtk_text_view_get_overwrite(Handle view)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |