Text Items

Preface
Introduction
Tutorial
Implementation
Commands
- bitmap
- eval-wish
- get-tk-var
- photo
- set-tk-var!
- tk
  - create-widget
    - button
    - canvas
      - Introduction
      - Items
        
        Options
        
        Arc
        
        Bitmap
        
        Image
        
        Line
        
        Oval
        
        Polygon
        
        Rectangle
        
        Text
        
        Window
      - Command
      - Options
    - checkbutton
    - entry
    - frame
    - label
    - labelframe
    - listbox
    - menu
    - menubutton
    - message
    - panedwindow
    - radiobutton
    - scale
    - scrollbar
    - scrolledtext
    - spinbox
    - text
    - tk_optionMenu
    - toplevel
  - get-id
  - exec
  - call
- tk-id->widget
- tk-var
- tk/after
- tk/appname
- tk/bind
- tk/bindtags
- tk/caret
- tk/choosecolor
- tk/choosedirectory
- tk/clipboard
- tk/console
- tk/destroy
- tk/dialog
- tk/event
- tk/focus
- tk/getopenfile
- tk/getsavefile
- tk/grab
- tk/grid
- tk/image
- tk/lower
- tk/messagebox
- tk/option
- tk/pack
- tk/place
- tk/popup
- tk/raise
- tk/scaling
- tk/update
- tk/useinputmethods
- tk/wait
- tk/windowingsystem
- tk/winfo
- tk/wm
Options
Extensions
Changes

A text item displays a string of characters on the screen in one or more lines. Text items support indexing and selection, along with the following text-related canvas widget commands: dchars, focus, icursor, index, insert, select. Text items are created with widget commands of the following form:

(#<widget> 'create 'text x y ?option value option value ...?)
(#<widget> 'create 'text coordList ?option value option value ...?)

The arguments x and y or coordList specify the coordinates of a point used to position the text on the display (see the options below for more information on how text is displayed). After the coordinates there may be any number of option-value pairs, each of which sets one of the configuration options for the item. These same option-value pairs may be used in itemconfigure widget commands to change the item's configuration.

The following standard options are supported by text items:

#:fill
#:activefill
#:disabledfill
#:stipple
#:activestipple
#:disabledstipple
#:state
#:tags

The following extra options are supported for text items:

#:anchor anchorPos: AnchorPos tells how to position the text relative to the positioning point for the text; it may have any of the forms accepted by Tk_GetAnchor. For example, if anchorPos is center then the text is centered on the point; if anchorPos is n then the text will be drawn such that the top center point of the rectangular region occupied by the text will be at the positioning point. This option defaults to center.
#:font fontName: Specifies the font to use for the text item. FontName may be any string acceptable to Tk_GetFont. If this option isn't specified, it defaults to a system-dependent font.
#:justify how: Specifies how to justify the text within its bounding region. How must be one of the values left, right, or center. This option will only matter if the text is displayed as multiple lines. If the option is omitted, it defaults to left.
#:text string: String specifies the characters to be displayed in the text item. Newline characters cause line breaks. The characters in the item may also be changed with the insert and delete widget commands. This option defaults to an empty string.
#:width lineLength: Specifies a maximum line length for the text, in any of the forms described in the COORDINATES section above. If this option is zero (the default) the text is broken into lines only at newline characters. However, if this option is non-zero then any line that would be longer than lineLength is broken just before a space character to make the line shorter than lineLength; the space character is treated as if it were a newline character.


		Text Items
		Text Items

	Preface Introduction Tutorial Implementation Commands bitmap eval-wish get-tk-var photo set-tk-var! tk create-widget button canvas Introduction Items Options Arc Bitmap Image Line Oval Polygon Rectangle Text Window Command Options checkbutton entry frame label labelframe listbox menu menubutton message panedwindow radiobutton scale scrollbar scrolledtext spinbox text tk_optionMenu toplevel get-id exec call tk-id->widget tk-var tk/after tk/appname tk/bind tk/bindtags tk/caret tk/choosecolor tk/choosedirectory tk/clipboard tk/console tk/destroy tk/dialog tk/event tk/focus tk/getopenfile tk/getsavefile tk/grab tk/grid tk/image tk/lower tk/messagebox tk/option tk/pack tk/place tk/popup tk/raise tk/scaling tk/update tk/useinputmethods tk/wait tk/windowingsystem tk/winfo tk/wm Options Extensions Changes	A text item displays a string of characters on the screen in one or more lines. Text items support indexing and selection, along with the following text-related canvas widget commands: dchars, focus, icursor, index, insert, select. Text items are created with widget commands of the following form: (#<widget> 'create 'text x y ?option value option value ...?) (#<widget> 'create 'text coordList ?option value option value ...?) The arguments x and y or coordList specify the coordinates of a point used to position the text on the display (see the options below for more information on how text is displayed). After the coordinates there may be any number of option-value pairs, each of which sets one of the configuration options for the item. These same option-value pairs may be used in itemconfigure widget commands to change the item's configuration. The following standard options are supported by text items: #:fill #:activefill #:disabledfill #:stipple #:activestipple #:disabledstipple #:state #:tags The following extra options are supported for text items: #:anchor anchorPos AnchorPos tells how to position the text relative to the positioning point for the text; it may have any of the forms accepted by Tk_GetAnchor. For example, if anchorPos is center then the text is centered on the point; if anchorPos is n then the text will be drawn such that the top center point of the rectangular region occupied by the text will be at the positioning point. This option defaults to center. #:font fontName Specifies the font to use for the text item. FontName may be any string acceptable to Tk_GetFont. If this option isn't specified, it defaults to a system-dependent font. #:justify how Specifies how to justify the text within its bounding region. How must be one of the values left, right, or center. This option will only matter if the text is displayed as multiple lines. If the option is omitted, it defaults to left. #:text string String specifies the characters to be displayed in the text item. Newline characters cause line breaks. The characters in the item may also be changed with the insert and delete widget commands. This option defaults to an empty string. #:width lineLength Specifies a maximum line length for the text, in any of the forms described in the COORDINATES section above. If this option is zero (the default) the text is broken into lines only at newline characters. However, if this option is non-zero then any line that would be longer than lineLength is broken just before a space character to make the line shorter than lineLength; the space character is treated as if it were a newline character. © Author \| Home \| Sitemap