<     > 

Text Editor Widget

Text editor widgets are similar to multi-line text boxes, except that they use the customizable Scintilla editing component which supports many extra features, such as text customization, (font, color, size), syntax styling, folding, auto-complete and highlighting for keywords, and you can also enable some of the same menu options as appear in the Softimage Script Editor. They are also associated to an underlying String parameter.

You create them using the PPGLayout.AddItem method with the siControlTextEditor control type enum:

var oTextWidget = oLayout.AddItem( "TextEditorWidget", "Text Editor Widget", siControlTextEditor );

Here are some tips and tricks for how to set up some of the special features for text editor (Scintilla) widgets:

• To enable Auto-Complete and Keyword Highlighting

• To enable Syntax Styling

• To enable Folding

• To provide File and Edit menus

• To customize the general look of the editor

The following item attributes are available:

To enable Auto-Complete and Keyword Highlighting

Keyword lists can be used for highlighting in the text editor or with the auto-complete feature while you type. Lists of keywords are always separated by a space and there are two ways you can specify them:

• Pass in the list to the SetAttribute method along with the siUIKeywords value:

oTextWidget.SetAttribute( siUIKeywords, "X3DObject Property Camera Parameter Light" )

• Specify the location of a file containing the list of keywords along with the siUIKeywordFile value:

oTextWidget.SetAttribute( siUIKeywordFile, "C:\\temp\\xsi_om.keywords" )

Auto-complete works on both commands and keywords by default; however, you turn it off for commands, keywords, or both with one of the siAutoCompleteMode values. For example:

oTextWidget.SetAttribute( siUIAutoComplete, siNone )

To enable Syntax Styling

You can customize the color of comments and preprocessor statements, and you can also specify a different font for comments (for example, if you want the comments to appear in Arial but keep the main code in Courier New). For example:

oTextWidget.SetAttribute( siUICommentFont, "Verdana" ) // verdana and fuscia comments
oTextWidget.SetAttribute( siUICommentColor, 0xFF00FF )
oTextWidget.SetAttribute( siUIPreprocessorColor, 0x808080 ) // gray preprocessor text

To enable Folding

Folding is the ability to collapse and expand major blocks of code, such as functions and subroutines. Being able to collapse large functions makes code easier to read in a script editor. To enable folding, use this:

oTextWidget.SetAttribute( siUIFolding, true )

To provide File and Edit menus

To display the File and Edit menu, set the siUIToolbar to true:

oTextWidget.SetAttribute( siUIToolbar, true )

You can also limit which menu options are available in the File menu by passing one of the siTextEditorCapability enum values with the siUICapability value. For example, to disable the New and Open options, use the siCanLoad value:

oTextWidget.SetAttribute( siUICapability, siCanLoad )

To customize the general look of the editor

There are several options available to you, which you can enable by passing in the variable indicated below to the SetAttribute method on the text editor widget:

oTextWidget.SetAttribute( siUIFont, "Comic Sans MS" )

oTextWidget.SetAttribute( siUIFontSize, 10 )

oTextWidget.SetAttribute( siUIHeight, 500 )

oTextWidget.SetAttribute( siUIBackgroundColor, 0xCCCCFF )

oTextWidget.SetAttribute( siUIForegroundColor, 0xCC3366 )

oTextWidget.SetAttribute( siUIHorizontalScroll, true )

oTextWidget.SetAttribute( siUIVerticalScroll, true )

oTextWidget.SetAttribute( siUILineNumbering, true )

oTextWidget.SetAttribute( siUILineWrap, true )

oTextWidget.SetAttribute( siUIMarginWidth, 5 )

Autodesk Softimage v7.5     <     >