Přehled vlastností, metod a událostí objektu:
--------------------------------------------------------------------------
Align (RW) Alignment (RW) BorderStyle (RW)
Color (RW) Ctl3D (RW) Cursor (RW)
Enabled (RW) Font (RW) Height (RW)
HelpContext (RW) HideScrollBars (RW) HideSelection (RW)
Hint (RW) Left (RW) Lines (RW)
MaxLength (RW) Modified (*RW) Name (R)
Paragraph.Alignment (RW) ParentColor (RW) ParentCtl3D (RW)
ParentFont (RW) ParentShowHint (RW) PlainText (RW)
PopupMenu (RW) ReadOnly (RW) ScrollBars (RW)
SelAttributes (RW) SelLength (*RW) SelStart (*RW)
SelText (*RW) ShowHint (RW) TabOrder (RW)
TabStop (RW) Tag (RW) Text (RW)
Top (RW) Visible (RW) WantReturns (RW)
WantTabs (RW) Width (RW) WordWrap (RW)
--------------------------------------------------------------------------
Clear ClearSelection CopyToClipboard
CutToClipboard FindText PasteFromClipboard
Print SelectAll
--------------------------------------------------------------------------
OnChange OnEnter OnExit
OnKeyDown OnKeyPress OnKeyUp
OnMouseDown OnMouseMove OnMouseUp
OnSelectionChange
--------------------------------------------------------------------------
Legenda: * -> pouze z programu, R -> lze číst, W -> lze zadat
Komponenta RichEdit slouží pro zápis a editaci víceřádkového textu s možností formátování textu. Zadat je možné pro každou část textu font (velikost, barvu ...) a zarovnávání řádků (vlevo, centrovat a vpravo). Pokud požadujete práci s běžným textem, použijte raději komponentu Memo.
Editovaný text lze uložit do souboru na disk. Standardní přípona souboru pro uložení a načtení textu objektu RichEdit je *.RTF. S uvedeným formátem souborů umí pracovat většina textových editorů pro systém Windows (např. Word).
Text obsahuje běžně nezobrazované znaky, které udávají vizuální formátování textu na formuláři. Například změnu fontu, barvu textu, zarovnávání řádků a podobně. Uvedené formátovací znaky značně prodlužují velikost souboru, který je ukládán na disk. Text lze zobrazit včetně formátovacích znaků nastavením vlastnosti PlainText.
Druh orámování textu zadává vlastnost BorderStyle, barvu podkladu textu zadáte ve vlastnosti Color. Pokud požadujete možnost přístupu k editovanému textu na formuláři pomocí rychlé Alt klávesy, umístěte nad editovaný text komponentu Label s nastavením vlastnosti FocusControl, ve které zadáte objekt s editovaným textem.
Editovaný text lze přenášet přes schránku Windows do jiného textu. Buď uživatelsky z klávesnice, nebo z programu. Vybraný text lze označit pomocí vlastností SelStart, SelLength a SelText. Celý text lze označit metodou SelectAll, pro výmaz označené části textu se použije metoda ClearSelection. Přenos textu mezi schránkou a objektem zajišťují metody CopyToClipboard, CutToClipboard a PasteFromClipboard.
Komponenta obsahuje mimo běžných událostí i událost OnChange, která nastane v okamžiku změny textu. Lze také použít událost OnKeyPress pro kontrolu zadávaných znaků s možností vynulování neplatných znaků.
Text je uložen ve vlastnosti Lines, kterou představuje proměnná typu StrArray. Uvedený typ proměnné má své vlastní metody pro práci s obsaženým textem.
Jednotlivé řádky textu jsou z programu přístupné svým indexem, to je pořadovým číslem
řádku. Řádky jsou číslovány od nuly. První řádek má proto index nula, pátý řádek má index 4.
Pokud potřebujete zjistit obsah řádku, musíte zadat jeho pořadový index. Obsah prvního řádku
proto zobrazíte:
Jazyk KLONDAIK:
ShowMessage(RichEdit.Lines[0]);
Jazyk BONANZA:
ShowMessage(RichEdit.Lines(0))
Podobným způsobem můžete z programu změnit obsah řádku, kdy opět zadáváte index
řádku a nový obsah. Pro druhý řádek v pořadí proto zadáte:
Jazyk KLONDAIK:
RichEdit.Lines[1]:='druhý řádek';
Jazyk BONANZA:
RichEdit.Lines(1) = "druhý řádek"
Nový řádek zadáte do textu z programu použitím metody Add následujícím způsobem:
Jazyk KLONDAIK:
RichEdit.Lines.Add('aaa');
Jazyk BONANZA:
RichEdit.Lines.Add("aaa")
Pokud potřebujete některý řádek textu zrušit, použijte volání metody Delete následujícím způsobem:
Jazyk KLONDAIK:
RichEdit.Lines.Delete(2);
Jazyk BONANZA:
RichEdit.Lines.Delete(2)
Potřebujete-li v textu vyhledat index řádku se známým obsahem, použijte funkci IndexOf:
Jazyk KLONDAIK:
ShowMessage(RichEdit.Lines.IndexOf('aaa'));
Jazyk BONANZA:
ShowMessage(RichEdit.Lines.IndexOf("aaa"))
Editovaný text můžete uložit na disk do textového souboru metodou SaveToFile, případně
načít textový soubor do seznamu metodou LoadFromFile:
Jazyk KLONDAIK:
RichEdit.Lines.SaveToFile('dokument.rtf');
RichEdit.Lines.LoadFromFile('dokument.rtf');
Jazyk BONANZA:
RichEdit.Lines.SaveToFile("dokument.rtf")
RichEdit.Lines.LoadFromFile("dokument.rtf")
Potřebujete-li projít celý text a provést s každým řádkem textu nějakou akci, použijte
vlastnosti Lines.Count. Musíte přitom počítat s tím, že se řádky číslují od nuly, počet položek
řádek textu je však uváděn od jedničky. Od celkového počtu řádků musíte proto v cyklu jedničku odečíst:
Jazyk KLONDAIK:
for x:= 0 to RichEdit.Lines.Count-1 do
RichEdit.Lines[x] := CsWinToLat(RichEdit.Lines[x]);
Jazyk BONANZA:
For x = 0 to RichEdit.Lines.Count-1
RichEdit.Lines(x) = CsWinToLat(RichEdit.Lines(x))
Next
Editovaný text je také přístupný jako celek ve vlastnosti Text. Vlastnost je přístupná pouze z programu a text je uveden bez formátovacích nezobrazovaných znaků. Délka editovaného textu se zadává ve vlastnosti MaxLength. Standardně je zadána nula, což znamená, že délka textu není omezena.