SynEdit Markup/pl
│ English (en) │ polski (pl) │
Aby uzyskać więcej informacji na temat SynEdit, przejdź do: SynEdit
Ta strona jest wersją roboczą....
Terminologia
- Coloring (Kolorowanie)
- Stosowanie atrybutów do tekstu. Kolor tekstu i tła, pogrubienie, kursywa, podkreślenie, kolorowa ramka lub częściowa ramka (w tym linia zygzakowata). Nazywane także podświetlaniem, chociaż termin ten jest niejednoznaczny, ponieważ może odnosić się albo do całego kolorowania, albo tylko do kolorowania za pomocą podświetlacza.
- Highligher (Podświetlacz)
- Podświetlacz SynEdit
- Markup (Znacznik)
- TSynEditMarkup
- token (token)
- Fragment tekstu. Zwykle część linii. Może to dotyczyć granic słów, ale także sięgać do poszczególnych liter.
O TSynEditMarkup
TSynEditMarkup pozwala na zmianę kolorystyki zapewnianej przez Podświetlacz.
Używany jest głównie do:
- kolorowania zaznaczenia
- kolorowania bieżącej linii
- kolorowania specjalnych linii (błąd, punkt przerwania...)
- kolorowania pasujących nawiasów „()”
- kolorowania „ctrl links” => kiedy możesz kliknąć identyfikator, aby przejść do jego deklaracji
- kolorowania bieżącego słowa (słowo w karetce)
- dopasowania kolorystyki początku/końca bloku
- kolorowania „lowlight” nieaktywne ifdef (przy użyciu codetools)
i więcej
Skąd pobierany jest kolor
Metoda malowania SynEdits pobiera tekst w postaci „tokenu”.
Głównym źródłem tych tokenów jest Podświetlacz. Np. w wierszu:
a := 1; // komentarz
Tokeny reprezentują
- "a " normalny tekst
- ":=" symbol (pomalowany na inny kolor)
- " " normalny tekst
- "1" numer (pomalowany w innym kolorze)
- ";" symbol (pomalowany na inny kolor)
- " " normalny tekst
- "// komentarz" komentarz (pomalowany na inny kolor)
Zobacz także Podświetlacz SynEdit.
Te tokeny są pobierane za pośrednictwem listy TLazSynDisplayView (w połączeniu z opakowaniami TSynEditStrings bufora TextBuffer). Nie ma to znaczenia przy kolorowaniu. Chociaż TLazSynDisplayView może zmienić kolor.
Każdy token jest następnie wprowadzany na listę TSynEditMarkup. Każdy TSynEditMarkup może zdefiniować dodatkowe kolorowanie. Jeśli tak się stanie, tokeny zostaną podzielone na mniejsze części, a kolory zostaną połączone/wymieszane/wymienione w razie potrzeby.
TSynEditMarkup
TODO
Podczas malowania wywoływane są następujące metody
Procedure PrepareMarkupForRow(aRow : Integer); virtual; Procedure FinishMarkupForRow(aRow : Integer); virtual;
Procedure BeginMarkup; virtual; Procedure EndMarkup; virtual;
Procedure GetNextMarkupColAfterRowCol(const aRow: Integer; const aStartCol: TLazSynDisplayTokenBound; const AnRtlInfo: TLazSynDisplayRtlInfo; out ANextPhys, ANextLog: Integer); virtual; abstract;
Biorąc pod uwagę bieżącą pozycję (numer linii malowania ARow, X jest określony w AStartCol), to znacznik musi ustawić ANextPhys lub ANextLog na następną pozycję X, w której chce zmienić kolorowanie.
Jeśli znacznik chce zmienić tekst na pogrubiony z X=5 na X=10 i X=15 na X=20, to
- dla dowolnego AStartCol w zakresie od 1 do 4 => ANext... = 5 (przełącz na pogrubienie w punkcie 5)
- dla dowolnego AStartCol w zakresie od 5 do 9 => ANext... = 10 (przełącz na brak modyfikacji przy 10)
- dla dowolnego AStartCol w zakresie od 10 do 14 => ANext... = 15 (przełącz na pogrubienie przy 15)
- dla dowolnego AStartCol w zakresie od 15 do 19 => ANext... = 20 (przełącz na brak modyfikacji przy 20)
Function GetMarkupAttributeAtRowCol(const aRow: Integer; const aStartCol: TLazSynDisplayTokenBound; const AnRtlInfo: TLazSynDisplayRtlInfo) : TSynSelectedColor; virtual; abstract;
Jeśli AStartCol mieści się w jakimkolwiek zakresie, w którym znacznik chce zmienić kolor, musi zwrócić poprawną * dla dowolnego AStartCol w zakresie od 5 do 9 => ANext... = 10 (przełącz na brak modyfikacji przy 10)
