SynEdit Markup/pl

From Free Pascal wiki
Jump to navigationJump to search

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)

Zobacz także