Returns a list of four elements describing the screen area of the character, sgml tag, or embedded window given by index.
The first two elements of the list give the x and y coordinates of the upper-left corner of the area occupied by the character, and the last two elements give the width and height of the area. If the character is only partially visible on the screen, then the return value reflects just the visible part. If the character is not visible on the screen then the return value is an empty list.
Returns a list with five elements describing the area occupied by the display line containing index.
The first two elements of the list give the x and y coordinates of the upper-left corner of the area occupied by the line, the third and fourth elements give the width and height of the area, and the fifth element gives the position of the baseline for the line, measured down from the top of the area.
All of this information is measured in pixels. If the current wrap mode is none and the line extends beyond the boundaries of the window, the area returned reflects the entire area of the line, including the portions that are out of the window. If the line is shorter than the full width of the window then the area returned reflects just the portion of the line that is occupied by characters, sgml tags, and embedded windows. If the display line containing index is not visible on the screen then the return value is an empty list.
Adjusts the view in the window so that the character given by index is completely visible.
If index is already visible then the command does nothing. If index is a short distance out of view, the command adjusts the view just enough to make index visible at the edge of the window. If index is far out of view, then the command centers index in the window.
This command is used to query and change the horizontal position of the text in the widget's window. It can take any of the following forms:
Returns a list containing two elements. Each element is a real fraction between 0 and 1; together they describe the portion of the document's horizontal span that is visible in the window.
For example, if the first element is .2 and the second element is .6, 20% of the text is off-screen to the left, the middle 40% is visible in the window, and 40% of the text is off-screen to the right. The fractions refer only to the lines that are actually visible in the window: if the lines in the window are all very short, so that they are entirely visible, the returned fractions will be 0 and 1, even if there are other lines in the text that are much wider than the window.
These are the same values passed to scrollbars via the -xscrollcommand option.
pathname xview moveto fraction
Adjusts the view in the window so that fraction of the horizontal span of the text is off-screen to the left. Fraction is a fraction between 0 and 1.
pathname xview scroll number what
This command shifts the view in the window left or right according to number and what. Number must be an integer. What must be either units or pages or an abbreviation of one of these. If what is units, the view adjusts left or right by number average-width characters on the display; if it is pages then the view adjusts by number screenfuls.
If number is negative then characters farther to the left become visible; if it is positive then characters farther to the right become visible.
This command is used to query and change the vertical position of the text in the widget's window. It can take any of the following forms:
Returns a list containing two elements, both of which are real fractions between 0 and 1. The first element gives the position of the first character in the top line in the window, relative to the text as a whole (0.5 means it is halfway through the text, for example). The second element gives the position of the character just after the last one in the bottom line of the window, relative to the text as a whole. These are the same values passed to scrollbars via the yscrollcommand option.
pathname yview moveto fraction
Adjusts the view in the window so that the character given by fraction appears on the top line of the window.
Fraction is a fraction between 0 and 1; 0 indicates the first character in the text, 0.33 indicates the character one-third the way through the text, and so on.
pathname yview scroll number what
This command adjust the view in the window up or down according to number and what.
Number must be an integer. What must be either units or pages. If what is units, the view adjusts up or down by number lines on the display; if it is pagesthen the view adjusts by number screenfuls. If number is negative then earlier positions in the text become visible; if it is positive then later positions in the text become visible.
The command turns the display of SGML tags on or off depending on status. Status can be any boolean value as described in section xxx. If the optional parameter status has been omitted, the command returns the current tag display status as a boolean value.
![]() |
All operations that modify the document structure are disabled while SGML tags are turned off. |
Most prominently, the element insert, element delete, and element split commands are disabled while tags are off.