sgcRichEdit: procesor tekstu w Twojej własnej aplikacji

Prędzej czy później każda aplikacja biznesowa potrzebuje prawdziwych dokumentów. System CRM pisze listy do klientów, program do zarządzania praktyką przechowuje notatki z przypadków, ERP zapisuje szablony ofert, a help desk odpowiada sformatowanym tekstem. Zwykłe pole tekstowe do tego nie wystarczy.

sgcRichEdit to kompletny edytor dokumentów wbudowany w sgcUI. Utrzymuje prawdziwy model dokumentu z nazwanymi stylami, listami wielopoziomowymi, tabelami ze scalonymi komórkami, obrazami w tekście i hiperłączami, a dokument układa na stronach. Jeden model dokumentu napędza kontrolki VCL, FireMonkey, WinForms, WPF i Avalonia, a ten sam model wczytuje, konwertuje i eksportuje dokumenty także bez żadnego okna.

sgcRichEdit w 60 sekund

Style, tabele, każdy język, motyw jasny i ciemny, każdy format i każda platforma w jedną minutę. Także na YouTube.

Prawdziwy dokument, a nie pole tekstowe

Umowy, raporty i listy muszą wyglądać tak samo przy każdym otwarciu. sgcRichEdit przechowuje akapity z nazwanymi stylami, a formatowanie wynika z łańcucha stylów i formatowania bezpośredniego, więc zmiana stylu Nagłówek 1 zmienia jednocześnie wszystkie nagłówki dokumentu.

Z bliska

Pogrubienie, kursywa, podkreślenie, przekreślenie, indeks górny i dolny, nazwy czcionek, rozmiary, kolory i wyróżnienia, wyrównanie, wcięcia i interlinia. Oto formatowanie powyższego dokumentu przy powiększeniu 200%.

Tabele, obrazy i strony

Edytor dzieli dokument na strony zgodnie z własnymi ustawieniami strony. Akapity dzielą się po wierszach, wiersze nagłówka tabeli powtarzają się na każdej stronie, a podziały stron są zachowywane, więc użytkownik drukuje dokładnie to, co widzi. Print i PrintPreview działają na pulpicie, a ExportToPNG renderuje dowolną stronę w wybranej rozdzielczości.

Trzy strony dokumentu ze zrzutów ekranu, zapisane przez ExportToPNG przy 150 DPI.

Każdy język, każdy użytkownik

Użytkownicy japońscy, chińscy i koreańscy piszą przez edytor metody wprowadzania, a użytkownicy arabscy i hebrajscy piszą od prawej do lewej, często z angielskimi słowami w tym samym zdaniu. sgcRichEdit pokazuje kompozycję IME w tekście przy karetce i zatwierdza ją jako jeden krok cofania. Akapity dwukierunkowe utrzymują karetkę i zaznaczenie tam, gdzie czytelnik się ich spodziewa, a każdy akapit ma własny kierunek.

• Kompozycja IME w tekście dla języka japońskiego, chińskiego i koreańskiego.
• Akapity od prawej do lewej oraz mieszany tekst arabski i angielski w jednym wierszu. Ctrl+Right Shift i Ctrl+Left Shift ustawiają kierunek akapitu.
• Wzorzec tekstowy UI Automation w systemie Windows, dla kontrolek VCL, FireMonkey, WinForms i WPF: czytnik ekranu czyta po znaku, słowie, wierszu i akapicie, zapowiada formatowanie i podąża za karetką. Obrazy są nazywane na podstawie tekstu alternatywnego, a łącza są zgłaszane jako łącza.
• Teksty edytora w 12 językach: angielskim, hiszpańskim, niemieckim, francuskim, włoskim, portugalskim (Brazylia), niderlandzkim, polskim, tureckim, japońskim, koreańskim i chińskim.

Jasny, ciemny, Fluent lub Classic

sgcRichEdit jest kontrolką sgcUI, więc podąża za motywem aplikacji tak jak reszta pakietu. Wybierz preset Fluent, a edytor i wstążka przyjmą wygląd Windows 11. Przełącz na ciemny, a wstążka, pasek stanu i backstage przyciemnią się, podczas gdy strona pozostanie biała, jak papier.

uses
  sgcUICore_Theme;

// the Windows 11 look for every sgcUI control, sgcRichEdit included
sgcUISetApplicationThemePreset('Fluent');
// follow the light / dark setting of Windows, live
sgcUISetApplicationThemeFollow(utfSystem, True);

Jeden dokument, każdy format

Dokumenty przychodzą jako RTF z Worda, jako HTML z przeglądarki lub e-maila i jako Markdown z narzędzia programisty. sgcRichEdit odczytuje i zapisuje je wszystkie oraz ma własny natywny format JSON, który przechowuje każdy szczegół dokumentu. LoadFromFile rozpoznaje format, SaveToFile zapisuje w żądanym formacie, a AsHTML, AsRTF i AsMarkdown odczytują i zapisują dokument jako ciąg znaków.

Każda jednostka formatu w klauzuli uses rejestruje swój czytnik lub zapis, a sgcUIPDF_Export łączy eksport PDF z silnikiem sgcPDF, który jest instalowany razem z sgcRichEdit.

uses
  sgcRichEdit_Formats, sgcRichEdit_VCL,
  sgcRichEdit_RTF_Reader, sgcRichEdit_HTML_Writer, sgcRichEdit_Markdown,
  sgcRichEdit_DOCX, sgcUIPDF_Export;

procedure TForm1.ConvertContract;
begin
  sgcVCLRichEdit1.LoadFromFile('contract.rtf');
  sgcVCLRichEdit1.SaveToFile('contract.html', refHTML);
  sgcVCLRichEdit1.SaveToFile('contract.md', refMarkdown);
  sgcVCLRichEdit1.SaveToFile('contract.docx', refDOCX);
  sgcVCLRichEdit1.ExportToPDF('contract.pdf');
  sgcVCLRichEdit1.ExportToPNG('page1.png', 0, 150);
end;

• RTF z Worda zachowuje tekst, czcionki, kolory, formatowanie akapitów, style, listy, tabele ze scalonymi komórkami, hiperłącza oraz obrazy PNG i JPEG.
• Czytnik HTML rozumie CSS, tabele oraz wskazówki list z Worda i Outlooka.
• Markdown obejmuje nagłówki, wyróżnienia, kod, cytaty, listy, łącza, obrazy, tabele i przekreślenie.
• ExportToPDF zapisuje PDF ze znacznikami, z nagłówkami, listami, tabelami, obrazami z tekstem alternatywnym i łączami.
• Kopiowanie umieszcza zaznaczenie w schowku jako RTF, HTML i zwykły tekst, więc wkleja się ono z formatowaniem do Worda, e-maila lub formularza WWW. Wklejanie przyjmuje RTF i HTML z Worda i przeglądarek, a Ctrl+Shift+V wkleja zwykły tekst.

Edycja, która wydaje się znajoma

Użytkownicy przynoszą ze sobą nawyki z procesorów tekstu. Edytor reaguje na zwykłe skróty (Ctrl+B, Ctrl+I, Ctrl+U, wyrównanie, nagłówki, punktory i Ctrl+K dla łączy), przechowuje pełną historię cofania i ponawiania oraz wyszukuje i zamienia tekst w akapitach i komórkach tabel.

Każde polecenie jest dostępne z kodu przez ExecuteCommand i CommandState oraz przez akcje VCL i FireMonkey, więc Twój własny pasek narzędzi lub wstążka sgcToolbar pozostaje zsynchronizowana z zaznaczeniem.

uses
  sgcRichEdit_Commands;

procedure TForm1.btnBoldClick(Sender: TObject);
begin
  sgcVCLRichEdit1.ExecuteCommand(recBold);
end;

procedure TForm1.sgcVCLRichEdit1SelectionChange(Sender: TObject);
begin
  // the button shows the state of the selection
  btnBold.Down := sgcVCLRichEdit1.CommandState(recBold).Checked;
end;

Twoje dokumenty w Twojej bazie danych

Notatki, listy i szablony zwykle znajdują się w polu bazy danych. TsgcVCLDBRichEdit i TsgcFMXDBRichEdit łączą się z TDataSource, odczytują pola memo i BLOB, przełączają zbiór danych w tryb edycji przy pierwszej zmianie i zapisują dokument z powrotem, gdy użytkownik opuści kontrolkę. Escape przywraca wartość pola, a AutoDisplay wczytuje duże dokumenty na żądanie.

uses
  sgcRichEdit_Formats, sgcRichEdit_VCL_DB;

sgcVCLDBRichEdit1.DataSource := dsNotes;
sgcVCLDBRichEdit1.DataField := 'NOTE';
// store the documents as JSON; refAuto, the default, detects the format
sgcVCLDBRichEdit1.FieldFormat := refJSON;

Bez okna, nawet na Linux64

Dokumenty często trzeba konwertować na serwerze: RTF do HTML dla portalu, JSON do PDF dla archiwum, stronę do PNG jako miniaturę. Model dokumentu, formaty, układ i eksporty nie zależą od VCL ani FireMonkey, więc usługa Windows lub demon Linux64 (Delphi 10.2 i nowsze) może wczytywać, zmieniać, renderować i eksportować dokumenty bez okna, z tym samym układem stron co kontrolki wizualne.

uses
  sgcRichEdit_Model, sgcRichEdit_Formats, sgcRichEdit_Print,
  sgcRichEdit_RTF_Reader, sgcRichEdit_HTML_Writer, sgcUIPDF_Export;

var
  oDocument: TsgcRichDocument;
begin
  oDocument := TsgcRichDocument.Create;
  try
    sgcRichLoadFromFile(oDocument, 'letter.rtf');
    sgcRichSaveToFile(oDocument, 'letter.html', refHTML);
    // tagged PDF, no window and no VCL or FireMonkey needed
    sgcRichExportPDF(oDocument, nil, 'letter.pdf');
  finally
    oDocument.Free;
  end;
end;

Także dla .NET

Kontrolki .NET dla WinForms, WPF i Avalonia używają tych samych nazw co kontrolki Delphi. Biblioteka główna obsługuje .NET Standard 2.0, .NET Framework 4.7.2 oraz .NET 6, 8, 9 i 10, a właściwość DocumentText wiąże się z Twoimi danymi we wszystkich trzech frameworkach.

using esegece.sgcRichEdit;
using esegece.sgcUICore;

// once at startup: PDF export through the esegece.sgcUICore.sgcPDF package
TsgcUIPDFExporter.Register();

richEdit.LoadFromFile("contract.rtf");
richEdit.SaveToFile("contract.html", TsgcRichEditFormat.refHTML);
richEdit.SaveToFile("contract.docx", TsgcRichEditFormat.refDOCX);
richEdit.ExportToPDF("contract.pdf");

Uruchom dema

Dema Delphi i C++ Builder instalują się z wersją próbną sgcUI, a dema .NET są dołączone do pobrania Registered dla .NET.

• Editor: kompletny procesor tekstu VCL ze wstążką zbudowaną w sgcToolbar. Otwieranie i zapis JSON, RTF, HTML, Markdown i tekstu, eksport do DOCX i PDF ze znacznikami, drukowanie i podgląd, znajdowanie i zamiana.
• EditorFMX: ten sam edytor na FireMonkey, z trybem dotykowym i eksportem PDF.
• DataAware i DataAwareFMX: edytor powiązany z danymi i zbiorem danych, jeden dokument na rekord.
• .NET: Editor dla WinForms, EditorWpf, EditorAvalonia oraz DataBinding, które wiąże DocumentText ze źródłem danych.

Gdzie jest dołączony sgcRichEdit

sgcRichEdit jest sprzedawany osobno dla Delphi i C++ Builder oraz dla .NET, a także wchodzi w skład sgcUI Enterprise i pakietu All-Access. Pojedynczy pakiet instaluje również sgcPDF, więc eksport PDF zawsze działa. Nie ma bezpłatnej edycji Community. Szczegóły znajdziesz na stronie z cennikiem.

Pytania lub uwagi? Skontaktuj się z nami, odpowiedzą Ci osoby, które napisały ten kod.