NAME

ctext -
Ctext a text widget with highlighting support

SYNOPSIS

package require Tk 
package require ctext  ? 3.3 ? 
ctext pathName  ? options ? 
::ctext::addHighlightClass pathName class color keywordlist
::ctext::addHighlightClassWithOnlyCharStart pathName class color char
::ctext::addHighlightClassForSpecialChars pathName class color charstring
::ctext::addHighlightClassForRegexp pathName class color pattern
::ctext::clearHighlightClasses pathName
::ctext::getHighlightClasses pathName
::ctext::deleteHighlightClass pathName class
::ctext::enableComments enable
::ctext::disableComments enable
pathName highlight startIndex endIndex
pathName fastdelete index1  ? index2 ? 
pathName fastinsert
pathName copy
pathName cut
pathName paste
pathName append
pathName configure option value  ? ... ? 

DESCRIPTION

Ctext overloads the text widget and provides new commands, named highlight, copy, paste,cut, append, and edit. It also provides several commands that allow you to define classes. Each class corresponds to a tag in the widget.

COMMANDS

ctext pathName ? options ?

Creates and configures a ctext widget.

HIGHLIGHTING

::ctext::addHighlightClass pathName class color keywordlist

Add a highlighting class class to the ctext widget pathName. The highligthing will be done with the color color. All words in the keywordlist will be highlighted.

	# highlight some tcl keywords
	::ctext::addHighlightClass .t tclkeywords red [list set info interp uplevel upvar]]
 

::ctext::addHighlightClassWithOnlyCharStart pathName class color char

Add a highlighting class class to the ctext widget pathName. The highligthing will be done with the color color. All words starting with char will be highlighted.

	::ctext::addHighlightClassWithOnlyCharStart .t vars blue \$
 

::ctext::addHighlightClassForSpecialChars pathName class color charstring

Add a highlighting class class to the ctext widget pathName. The highligthing will be done with the color color. All chars in charstring will be highlighted.

::ctext::addHighlightClassForRegexp pathName class color pattern

Add a highlighting class class to the ctext widget pathName. The highligthing will be done with the color color. All text parts matching the regexp pattern will be highligthed.

::ctext::clearHighlightClasses pathName

Remove all highlight classes from the widget pathName.

::ctext::getHighlightClasses pathName

List all highlight classes for the widget pathName.

::ctext::deleteHighlightClass pathName class

Delete the highlight class class from the widget pathName

::ctext::enableComments enable

Enable C comment highlighting. The class for c-style comments is _cComment. The C comment highlighting is disabled by default.

::ctext::disableComments enable

Disable C comment highlighting.

WIDGET COMMANDS

pathName highlight startIndex endIndex

Highlight the text between startIndex and endIndex.

pathName fastdelete index1 ? index2 ?

Delete text range without updating the highlighting. Arguments are identical to the pathName delete command inherited from the standard text widget.

pathName fastinsert

Insert text without updating the highlighting. Arguments are identical to the pathName insert command inherited from the standard text widget.

pathName copy

Call tk_textCopy for the ctext instance.

pathName cut

Call tk_textCut for the ctext instance.

pathName paste

Call tk_textPaste for the ctext instance.

pathName append

Append the current selection to the clipboard.

pathName configure option value ? ... ?

Set the options for the ctext widget. Each option name must be followed the new value.

WIDGET OPTIONS

proc linemark_cmd {win type line}.

EXAMPLE

	package require Tk
	package require ctext
	
	proc main {} {
	pack [frame .f] -fill both -expand 1
	pack [scrollbar .f.s -command {.f.t yview}] -side right -fill y

	pack [ctext .f.t -bg black -fg white -insertbackground yellow  -yscrollcommand {.f.s set}] -fill both -expand 1

	ctext::addHighlightClass .f.t widgets purple  [list ctext button label text frame toplevel  scrollbar checkbutton canvas listbox menu menubar menubutton  radiobutton scale entry message tk_chooseDir tk_getSaveFile  tk_getOpenFile tk_chooseColor tk_optionMenu]

	ctext::addHighlightClass .f.t flags orange  [list -text -command -yscrollcommand  -xscrollcommand -background -foreground -fg -bg  -highlightbackground -y -x -highlightcolor -relief -width  -height -wrap -font -fill -side -outline -style -insertwidth  -textvariable -activebackground -activeforeground -insertbackground  -anchor -orient -troughcolor -nonewline -expand -type -message  -title -offset -in -after -yscroll -xscroll -forward -regexp -count  -exact -padx -ipadx -filetypes -all -from -to -label -value -variable  -regexp -backwards -forwards -bd -pady -ipady -state -row -column  -cursor -highlightcolors -linemap -menu -tearoff -displayof -cursor  -underline -tags -tag]

	ctext::addHighlightClass .f.t stackControl red  {proc uplevel namespace while for foreach if else}
	ctext::addHighlightClassWithOnlyCharStart .f.t vars mediumspringgreen "\$"
	ctext::addHighlightClass .f.t variable_funcs gold {set global variable unset}
	ctext::addHighlightClassForSpecialChars .f.t brackets green {[]{}}
	ctext::addHighlightClassForRegexp .f.t paths lightblue {\.[a-zA-Z0-9\_\-]+}
	ctext::addHighlightClassForRegexp .f.t comments khaki {#[^\n\r]*}
	.f.t fastinsert end [info body main]
	
	pack [frame .f1] -fill x

	.f.t highlight 1.0 end
	
	pack [button .f1.exit -text Exit -command exit] -side left

	pack [entry .e] -side bottom -fill x
	.e insert end "ctext::deleteHighlightClass .f.t "
	bind .e <Return> {eval [.e get]}
	}
	main
	

THANKS

SEE ALSO

text, re_syntax

KEYWORDS

text, widget, syntax highlighting