codeeditor — u_pbt_codeeditor #

← Riferimento dei componenti · Sommario della guida

Editor di codice con evidenziazione della sintassi: dieci linguaggi, numeri di riga, compressione delle regioni, ricerca integrata e rilascio di file.

▶ Vederlo dal vivo — Applicazione dimostrativa, riquadro Code editor: l'anteprima, il codice che lo produce e questa pagina, affiancati.

In breve #

Avvio rapido #

// event open della finestra
uo_editeur.is_syntax = uo_editeur.SYNTAX_SQL
uo_editeur.is_text   = "SELECT c.name, SUM(o.amount) AS total~r~n" &
                       + "FROM customer c~r~n" &
                       + "WHERE o.status = 'paid'"

// Rileggere cio che l'utente ha realmente digitato
string ls_sql

ls_sql = uo_editeur.of_get_text()

is_text restituisce la stessa cosa: la digitazione dell'utente vi arriva non appena l'immissione si posa (event ue_changed).

Linguaggi riconosciuti #

is_syntax accetta una di queste costanti, oppure SYNTAX_NONE (stringa vuota) per testo semplice senza evidenziazione.

I linguaggi di una stessa famiglia condividono l'evidenziazione (SYNTAX_JAVA colora come SYNTAX_C, SYNTAX_XML come SYNTAX_HTML): la costante scelta documenta la Sua intenzione, il risultato sullo schermo è lo stesso. Il valore non distingue tra maiuscole e minuscole e un nome sconosciuto ricade sul testo semplice, senza errore.

Proprietà #

Contenuto e linguaggio #

Visualizzazione #

Navigazione e interazioni #

Metodi #

Event #

Esempi #

Un editor di query SQL #

uo_requete.of_set_redraw(false)

uo_requete.is_syntax = uo_requete.SYNTAX_SQL
uo_requete.is_text   = "-- Migliori clienti per fatturato incassato~r~n" &
                       + "SELECT c.name, SUM(o.amount) AS total~r~n" &
                       + "FROM customer c~r~n" &
                       + "  INNER JOIN orders o ON o.cust_id = c.id~r~n" &
                       + "WHERE o.status = 'paid'~r~n" &
                       + "GROUP BY c.name~r~n" &
                       + "ORDER BY total DESC"

uo_requete.of_set_redraw(true)

// event clicked di cb_executer
string ls_sql

ls_sql = uo_requete.of_get_text()     // la digitazione reale dell'utente
of_executer(ls_sql)

Un visualizzatore in sola lettura #

Ideale per presentare codice generato, un registro o un estratto che l'utente deve leggere senza modificarlo.

uo_apercu.is_syntax = uo_apercu.SYNTAX_POWERSCRIPT

uo_apercu.ib_readonly     = true      // sola consultazione, nessun cursore di immissione
uo_apercu.ib_line_numbers = false     // nasconde il margine dei numeri
uo_apercu.ib_current_line = false     // nessuna evidenziazione della riga corrente
uo_apercu.ib_wrap         = true      // manda a capo invece di scorrere
uo_apercu.ii_tab_size     = 2         // tabulazioni visualizzate su 2 colonne

uo_apercu.is_text = of_generer_code()

Seguire la posizione del cursore in una barra di stato #

uo_editeur.ib_track_caret = true       // adesione esplicita : altrimenti nessun evento

// event ue_caret_changed di uo_editeur : (long al_line, long al_col)
uo_statut.of_item("pos").is_text = "Riga " + String(al_line) + ", col. " + String(al_col)

Senza ib_track_caret, il cursore non riporta nulla: questo trigger ha una frequenza elevata e rimane disattivato finché non lo richiede.

Cercare e andare a una riga #

// Apre la barra di ricerca ed evidenzia tutte le occorrenze
uo_editeur.of_find(/*testo*/ "ll_total")

// event ue_find_result di uo_editeur : (long al_count, long al_index)
if al_count = 0 then
    uo_statut.of_item("main").is_text = "Nessuna occorrenza"
else
    uo_statut.of_item("main").is_text = String(al_index) + " / " + String(al_count)
end if

// Andare direttamente alla riga segnalata da un compilatore
uo_editeur.ii_doc_line = ll_ligne_erreur     // scorre e seleziona la riga

Aprire un file rilasciato da Esplora file #

uo_editeur.ib_allow_drop = true

// event ue_drop_files di uo_editeur : (string as_files[])
string ls_contenu, ls_ligne
integer li_fichier

// as_files[1] porta il percorso COMPLETO del primo file rilasciato
li_fichier = FileOpen(as_files[1], StreamMode!, Read!)
if li_fichier > 0 then
    FileReadEx(li_fichier, ls_contenu)
    FileClose(li_fichier)

    uo_editeur.is_syntax = of_langage_selon_extension(as_files[1])
    uo_editeur.is_text   = ls_contenu
end if

Reagire alle modifiche #

// event ue_changed di uo_editeur : (string as_text)
ib_modifie = true
uo_statut.of_item("main").is_text = String(Len(as_text)) + " caratteri"

L'event viene attivato solo una volta stabilizzata la digitazione: un'immissione continua non genera un event per ogni tasto.

Buone pratiche #

• Imposti sempre is_syntax prima di is_text: il codice è colorato fin dalla prima visualizzazione, senza ricolorazione visibile.
• Per una visualizzazione in sola consultazione, la combinazione ib_readonly + ib_line_numbers = false + ib_wrap offre un visualizzatore sobrio che non sembra più un editor.
• Per recuperare un'immissione, legga is_text (oppure of_get_text()) una volta posata la digitazione, o prenda il parametro as_text di ue_changed.
• ib_folding ha senso solo su file lunghi e strutturati; lo lasci disattivato per brevi estratti.
• Racchiuda il caricamento di un file di grandi dimensioni tra of_set_redraw(false) e of_set_redraw(true).
• Chiami of_reset() prima di caricare un documento di natura diversa: senza di esso, il linguaggio, la dimensione di tabulazione o la modalità di sola lettura precedenti restano attivi.

← Riferimento dei componenti · Sommario della guida