PyFrame Guide to wxPython
Copyright and License information Home
__ A B C D E F G H I L M P R S T U V W
Colourise
GetLexer
SetKeyWords
SetLexer
SetLexerLanguage
SetProperty
Summary:
Support for syntax coloration and possibly folding is provided by a lexer. The wxPython distribution of the Scintilla editing component includes support for a number of languages. Support for a particular language is set by using the SetLexer method. If you wanted to have your code perform the lexing (unlikely...) you could set the lexer to wxSTC_LEX_CONTAINER; but this is beyond the scope of this guide. If you did use wxSTC_LEX_CONTAINER, you would get STYLE_NEEDED event, see EVT_STC_STYLENEEDED.
You can configure some operational aspects of some of the lexers with SetProperty.
It's also a good idea to examine the SCITE editor's properties files (*.properties) and Embedded.properties; you can find lists of keywords and examples of how to set styles for colorizing.
----
Colourise(start,end)
Manually request the lexer to style a range. start and end are integer character positions in the Document. Returns None. Not really useful in wxPython (?) as the lexer should do this automatically. However, this is the method you'd use if handling a STYLE_NEEDED event as discussed in the Summary section of this page.
top
GetLexer()
Returns an integer object with the lexer selection value.
SetKeyWords(keywordSet,keyWords)
If you want to colorize language keywords, this method is for you. This saucy little number takes an integer parameter keywordSet and a space-delimited set of keywords in the string parameter keyWords. Impudently returns the omnipresent None.
Some lexers have embedded-language support, controlled by the keywordSet parameter. For example, HTML can have embedded languages like VBScript, Javascript, and a few others.
wxSTC_LEX_BAAN
wxSTC_LEX_CONF
wxSTC_LEX_CPP
wxSTC_LEX_HTML, wxSTC_LEX_XML, wxSTC_LEX_ASP, wxSTC_LEX_PHP
wxSTC_LEX_NNCRONTAB
wxSTC_LEX_LUA
wxSTC_LEX_PASCAL
Examples
Python
stcInstance.SetKeyWords(0,string.join(python_keywords.kwlist))
HTML with optional Zope DTML support
htmlKeywords = ( "a abbr acronym address applet area b base basefont bdo big blockquote" " body br button caption center cite code col colgroup dd del dfn dir" " div dl dt em fieldset font form frame frameset h1 h2 h3 h4 h5 h6" " head hr html i iframe img input ins isindex kbd label legend li link" " map menu meta noframes noscript object ol optgroup option p param" " pre q s samp script select small span strike strong style sub sup" " table tbody td textarea tfoot th thead title tr tt u ul var xml" " xmlns abbr accept-charset accept accesskey action align alink alt" " archive axis background bgcolor border cellpadding cellspacing char" " charoff charset checked cite class classid clear codebase codetype" " color cols colspan compact content coords data datafld dataformatas" " datapagesize datasrc datetime declare defer dir disabled enctype" " event face for frame frameborder headers height href hreflang hspace" " http-equiv id ismap label lang language leftmargin link longdesc" " marginwidth marginheight maxlength media method multiple name nohref" " noresize noshade nowrap object onblur onchange onclick ondblclick" " onfocus onkeydown onkeypress onkeyup onload onmousedown onmousemove" " onmouseover onmouseout onmouseup onreset onselect onsubmit onunload" " profile prompt readonly rel rev rows rowspan rules scheme scope" " selected shape size span src standby start style summary tabindex" " target text title topmargin type usemap valign value valuetype" " version vlink vspace width text password checkbox radio submit reset" " file hidden image public !doctype") dtmlKeywords = ( "dtml-var dtml-if dtml-unless dtml-in dtml-with dtml-let dtml-call" "dtml-raise dtml-try dtml-comment dtml-tree") keywords = htmlKeywords if self.submode and 1: #add DTML keywords keywords = htmlKeywords + ' ' + dtmlKeywords stcInstance.SetKeyWords(0,keywords)
SetLexer(lexer)
Set the lexer support for a particular language. The integer parameter lexer should be chosen from the following list. Note that the list indicates whether or not folding is supported and any properties (SetProperty) used by the lexer. The method returns None.
Note that the number of styling bits for a new document is set to 5. If you are using the HTML lexer you need to set this to 7 after using SetLexer.
It's important to set the keywords and properties as well; just setting the lexer is not enough!
Value
Folding?
properties
wxSTC_LEX_ADA
no
wxSTC_LEX_ASP
see wxSTC_LEX_HTML
wxSTC_LEX_AUTOMATIC
N.A.
wxSTC_LEX_AVE
no?
"fold" (not implemented?)
yes
"styling.within.preprocessor"
"fold.comment"
"fold.compact"
wxSTC_LEX_BATCH
wxSTC_LEX_BULLANT
no (Apache config files)
wxSTC_LEX_CONTAINER
"fold.preprocessor"
wxSTC_LEX_DIFF
wxSTC_LEX_EIFFEL
wxSTC_LEX_EIFFELKW
wxSTC_LEX_ERRORLIST
wxSTC_LEX_HTML
"asp.default.language" (javascript)
"fold.html"
"fold"
wxSTC_LEX_LATEX
wxSTC_LEX_LISP
wxSTC_LEX_MAKEFILE
wxSTC_LEX_MATLAB
wxSTC_LEX_NULL
Null language just handles the protocol but does nothing. Use for plain text.
wxSTC_LEX_PERL
wxSTC_LEX_PHP
wxSTC_LEX_PROPERTIES
wxSTC_LEX_PYTHON
"fold.comment.python"
"fold.quotes.python"
"tab.timmy.whinge.level"
wxSTC_LEX_RUBY
wxSTC_LEX_SCRIPTOL
Unknown
Although defined, support doesn't exist.
wxSTC_LEX_SQL
wxSTC_LEX_TCL
see wxSTC_LEX_CPP
wxSTC_LEX_VB
wxSTC_LEX_VBSCRIPT
wxSTC_LEX_XCODE
Although defined, support doesn't exist. It's for for DevelopMentor's GenX product.
wxSTC_LEX_XML
Note: "tab.timmy.whinge.level" is a setting that determines how to indicate bad indentation.
0 = ignore (default)
1 = inconsistent
2 = mixed spaces/tabs
3 = spaces are bad
4 = tabs are bad
When a lexer specifies its language as wxSTC_LEX_AUTOMATIC it receives a value assigned in sequence from wxSTC_LEX_AUTOMATIC+1 (wxSTC_LEX_AUTOMATIC = 1000). This is ordinarily not useful in a wxPython application.
wxSTC_LEX_NULL is useful (believe it or not) when you're editing plain text, although one supposes you could not set this one and the STC would still work just fine.
SetLexerLanguage()
Set the lexer language using a string rather than one of the integers shown in SetLexer. Returns None.
The strings that can be used are: ada, ave, baan, bullant, conf, cpp, tcl, nncrontab, eiffel, eiffelkw, hypertext (this is for HTML), xml, asp, php, lisp, lua, matlab, batch, diff, props, makefile, errorlist, latex, pascal, perl, python, ruby, sql, vb, and vbscript.
SetProperty(key,value)
This method is used to set a property for a lexer to a certain value. This method returns None. Both the key and value parameters are string objects. For example, if you were using the Python lexer, you might want to twiddle the "tab.timmy.whinge.level" (whatever that means!) setting like this:
stcInstance.SetProperty("tab.timmy.whinge.level", "1")
See SetLexer for supported properties.
To install Wx::Scintilla, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Wx::Scintilla
CPAN shell
perl -MCPAN -e shell install Wx::Scintilla
For more information on module installation, please visit the detailed CPAN module installation guide.