markdownview — u_pbt_markdownview #

← Riferimento dei componenti · Sommario della guida

markdownview mostra un documento Markdown in sola lettura, con i colori del tema: titoli, elenchi, tabelle, elenchi di attività, codice colorato, immagini. Si imposta il testo in is_markdown, o il percorso di un file in is_source; un link non naviga mai, solleva ue_link_clicked e decide l'applicazione. L'HTML grezzo di un documento non viene mai eseguito.

▶ Vederlo dal vivo — Applicazione dimostrativa, tessera Markdown viewer, con il codice e questa pagina fianco a fianco.

In breve #

Avvio rapido #

// Show a Markdown file : its pictures and relative links are read against its folder
uo_md.is_source = "C:\Acme\Help\guide.md"

// ... or any text the application has
uo_md.is_markdown = "# Release notes~n~n- [x] Orders~n- [ ] Invoices"

// ue_link_clicked : the viewer never navigates, the application decides where to open as_url

Proprietà #

Metodi #

Eventi #

Esempio #

Una guida in linea che apre i suoi link #

// ue_link_clicked of uo_md : the viewer never navigates, the application decides
if Lower(Right(as_url, 3)) = ".md" and FileExists(as_url) then
	uo_md.is_source = as_url                        // another page of the help
else
	ShellExecuteW(0, "open", as_url, "", "", 1)     // a web page, a mail
end if

Modificare Markdown: un codeeditor e un markdownview #

// The editor colours Markdown ; the viewer shows the page
uo_editor.is_syntax = u_pbt_codeeditor.SYNTAX_MARKDOWN
uo_editor.is_text = ls_notes
uo_md.is_markdown = ls_notes

// ue_changed of uo_editor : the whole recipe
uo_md.is_markdown = uo_editor.is_text

Un indice in un elenco #

// Local variables
string ls_titles[], ls_anchors[]
long ll_levels[], ll_i

// One line per heading, indented by its level
for ll_i = 1 to uo_md.of_toc(/*titles*/ ls_titles, /*levels*/ ll_levels, /*anchors*/ ls_anchors)
	lb_toc.AddItem(Fill(" ", (ll_levels[ll_i] - 1) * 3) + ls_titles[ll_i])
next

// SelectionChanged of lb_toc : bring that heading to the top
uo_md.of_scroll_to(/*anchor*/ ls_anchors[index])

Buone pratiche #

• È un lettore, non un editor: per scrivere Markdown, mettete accanto un codeeditor in SYNTAX_MARKDOWN, collegato da una riga nel suo ue_changed (vedere l'esempio).
• I link sono vostri: niente si apre da solo; ue_link_clicked dà l'indirizzo, già risolto rispetto alla cartella del file, e scegliete voi — il browser, un altro documento nello stesso componente, una schermata dell'applicazione.
• Un documento non esegue nulla: l'HTML grezzo è mostrato come scritto, un link javascript: resta testo, un'immagine http:// è rifiutata — un documento venuto da fuori si mostra senza rischi.
• Le immagini: un percorso relativo si legge rispetto alla cartella del file; per un'immagine del Web, preferite https://, o scaricatela prima (restclient.of_download) e date il suo percorso.
• Un documento grande resta fluido: i primi blocchi compaiono subito, il resto negli istanti seguenti; la ricerca, of_scroll_to e la stampa aspettano che sia completo.
• Da destra a sinistra: il documento segue il verso dell'applicazione (elenchi, citazioni e tabelle si capovolgono), un blocco di codice resta da sinistra a destra.

Ereditato dalla base comune #

Questi membri esistono su tutti i componenti visivi — non sono propri di questo. Sono descritti una sola volta, nei capitoli trasversali; questa tabella dice solo dove leggerli.

← Riferimento dei componenti · Sommario della guida