TScintilla

Fonte: source/classes/scintila.prg

Hierarchy: TScintilla → TControl

TScintilla wraps the Scintilla source code editing component (scintilla.org) for use within FiveWin applications. It provides a full-featured code editor with syntax highlighting, code folding, line numbering, bookmarks, search/replace, undo/redo, and support for multiple lexers including Harbour/xHarbour syntax.

SCINTILLA Command

@ nRow, nCol SCINTILLA oSci SIZE nW, nH OF oWnd FONT oFont LEXER cLexer

Key DATA Members

Methods

Example: Code Editor

#include "FiveWin.ch"

function Main()

   local oWnd, oSci, oFont

   DEFINE FONT oFont NAME "Consolas" SIZE 0, -12

   DEFINE WINDOW oWnd TITLE "Source Editor" ;
      SIZE 800, 600

   @ 0, 0 SCINTILLA oSci SIZE 800, 570 OF oWnd ;
      FONT oFont LEXER ""

   oSci:lMargLin   := .T.
   oSci:lFolding   := .T.
   oSci:lMarking   := .T.
   oSci:SetUp()

   // Toolbar buttons
   @ 575, 10 BUTTON "&Open" SIZE 50, 20 ;
      ACTION oSci:Open()

   @ 575, 65 BUTTON "&Save" SIZE 50, 20 ;
      ACTION oSci:Save()

   @ 575, 120 BUTTON "&Find" SIZE 50, 20 ;
      ACTION oSci:DlgFindText()

   @ 575, 175 BUTTON "&Undo" SIZE 50, 20 ;
      ACTION oSci:Undo()

   @ 575, 230 BUTTON "&Redo" SIZE 50, 20 ;
      ACTION oSci:Redo()

   @ 575, 620 BUTTON "E&xit" SIZE 50, 20 ;
      ACTION oWnd:End()

   ACTIVATE WINDOW oWnd ;
      VALID ( oSci:End(), oFont:End(), .T. )

return nil

Lexer Configuration

TScintilla supports syntax highlighting via configurable keyword color sets and token-specific color arrays:

Each color array contains three elements:

• nForeColor — Foreground (text) color as an RGB numeric value.
• nBackColor — Background color as an RGB numeric value.
• nCase — Case mode: SC_CASE_MIXED, SC_CASE_UPPER, or SC_CASE_LOWER.

Default colors for Harbour/xHarbour syntax are defined as class data members:

DATA cCComment  INIT { CLR_GRAY,    CLR_WHITE, SC_CASE_MIXED }
DATA cCString   INIT { CLR_HRED,    CLR_WHITE, SC_CASE_MIXED }
DATA cCNumber   INIT { CLR_HBLUE,   CLR_WHITE, SC_CASE_MIXED }
DATA cCOperator INIT { CLR_HBLACK,  CLR_WHITE, SC_CASE_MIXED }
DATA cCKeyw1    INIT { METRO_ORANGE,CLR_WHITE, SC_CASE_MIXED }
DATA cCKeyw2    INIT { CLR_HGREEN,  CLR_WHITE, SC_CASE_MIXED }
DATA cCKeyw3    INIT { CLR_HPURPLE, CLR_WHITE, SC_CASE_MIXED }
DATA cCKeyw4    INIT { CLR_HCYAN,   CLR_WHITE, SC_CASE_MIXED }
DATA cCKeyw5    INIT { CLR_HRED,    CLR_WHITE, SC_CASE_MIXED }

File Encoding Modes

TScintilla supports multiple file encoding modes for reading and saving documents in different character encodings. These are controlled by the nModeSave and nModeLoad data members along with the lBom flag.

• nModeLoad controls how the file is interpreted when opened. Mode 0 reads as ANSI; modes 1–3 decode the appropriate Unicode format.
• nModeSave controls how the document is written back to disk.
• lBom (logical) controls whether a Byte Order Mark is written at the beginning of the file on save. Relevant for UTF-8 and UTF-16 modes.
• When OpenFile() loads a document, UTF-8 BOM is detected automatically regardless of nModeLoad.

Editor Control Comparison

Notes

• TScintilla requires the Scintilla DLL (SciLexer.dll for 32-bit or SciLex64.dll for 64-bit) at runtime. The DLL is loaded dynamically via LoadLibrary.
• Harbour/xHarbour syntax highlighting is activated by passing "Harbour" or the corresponding lexer number as the cLex parameter.
• Use cCKeyw1 through cCKeyw5 to customize syntax colors. Each is an array of { nForeColor, nBackColor, nCaseMode }.
• The lModified flag and bModified codeblock let you track unsaved changes, e.g., to update a window title with a modified indicator.
• The class provides built-in dialogs for find/replace (DlgFindText(), DlgReplace()), go-to-line (DlgGoToLine()), and character insertion (DlgInsChar()).
• Margins are configured via nMargLines, nMargSymbol, nMargFold, and nMargText. Call SetUp() after changing margin settings.

Veja Também

• Classes Alfabético
• Funções