codeeditor — u_pbt_codeeditor #

← Referencia de componentes · Índice de la guía

Editor de código con resaltado de sintaxis: diez lenguajes, números de línea, plegado de regiones, búsqueda integrada y arrastre de archivos.

▶ Verlo en vivo — Aplicación de demostración, mosaico Code editor: la vista previa, el código que lo genera y esta página, uno al lado del otro.

De un vistazo #

Inicio rápido #

// event open de la ventana
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'"

// Releer lo que el usuario ha escrito realmente
string ls_sql

ls_sql = uo_editeur.of_get_text()

is_text devuelve lo mismo: lo que escribe el usuario llega ahí en cuanto la escritura se asienta (event ue_changed).

Lenguajes reconocidos #

is_syntax acepta una de estas constantes, o SYNTAX_NONE (cadena vacía) para texto sin formato, sin resaltado.

Los lenguajes de una misma familia comparten el resaltado (SYNTAX_JAVA colorea como SYNTAX_C, SYNTAX_XML como SYNTAX_HTML): la constante que elija documenta su intención, el resultado en pantalla es el mismo. El valor no distingue mayúsculas de minúsculas y un nombre desconocido recurre al texto sin formato, sin error.

Propiedades #

Contenido y lenguaje #

Visualización #

Navegación e interacciones #

Métodos #

Eventos #

Ejemplos #

Un editor de consultas SQL #

uo_requete.of_set_redraw(false)

uo_requete.is_syntax = uo_requete.SYNTAX_SQL
uo_requete.is_text   = "-- Mejores clientes por facturacion cobrada~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 de cb_executer
string ls_sql

ls_sql = uo_requete.of_get_text()     // lo que el usuario ha escrito realmente
of_executer(ls_sql)

Un visor de solo lectura #

Ideal para presentar código generado, un registro o un extracto que el usuario debe leer sin modificarlo.

uo_apercu.is_syntax = uo_apercu.SYNTAX_POWERSCRIPT

uo_apercu.ib_readonly     = true      // solo consulta, sin cursor de escritura
uo_apercu.ib_line_numbers = false     // oculta el margen de numeros
uo_apercu.ib_current_line = false     // sin resaltado de la linea actual
uo_apercu.ib_wrap         = true      // ajusta al ancho en vez de desplazarse
uo_apercu.ii_tab_size     = 2         // tabulaciones mostradas en 2 columnas

uo_apercu.is_text = of_generer_code()

Seguir la posición del cursor en una barra de estado #

uo_editeur.ib_track_caret = true       // suscripcion explicita: si no, ningun evento

// event ue_caret_changed de uo_editeur : (long al_line, long al_col)
uo_statut.of_item("pos").is_text = "Línea " + String(al_line) + ", col. " + String(al_col)

Sin ib_track_caret, el cursor no informa de nada: este disparador es de frecuencia elevada y permanece desactivado mientras no lo solicite.

Buscar e ir a una línea #

// Abre la barra de busqueda y resalta todas las apariciones
uo_editeur.of_find(/*texto*/ "ll_total")

// event ue_find_result de uo_editeur : (long al_count, long al_index)
if al_count = 0 then
    uo_statut.of_item("main").is_text = "Ninguna aparición"
else
    uo_statut.of_item("main").is_text = String(al_index) + " / " + String(al_count)
end if

// Ir directamente a la linea erronea indicada por un compilador
uo_editeur.ii_doc_line = ll_ligne_erreur     // desplaza y selecciona la linea

Abrir un archivo soltado desde el Explorador #

uo_editeur.ib_allow_drop = true

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

// as_files[1] lleva la ruta COMPLETA del primer archivo soltado
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

Reaccionar a las modificaciones #

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

El evento solo se dispara una vez que la escritura se ha estabilizado: escribir de forma continua no genera un evento por tecla.

Buenas prácticas #

• Asigne siempre is_syntax antes que is_text: el código aparece coloreado desde la primera visualización, sin recoloración visible.
• Para una presentación en modo consulta, la combinación ib_readonly + ib_line_numbers = false + ib_wrap da un visor sobrio que ya no parece un editor.
• Para recuperar lo escrito, lea is_text (o of_get_text()) una vez asentada la escritura, o tome el parámetro as_text de ue_changed.
• ib_folding solo resulta interesante en archivos largos y estructurados; déjelo desactivado para extractos breves.
• Enmarque la carga de un archivo grande con of_set_redraw(false) / of_set_redraw(true).
• Llame a of_reset() antes de cargar un documento de otra naturaleza: sin ello, el lenguaje, el tamaño de tabulación o el modo de solo lectura anteriores siguen vigentes.

← Referencia de componentes · Índice de la guía