Editor Macros PascalScript/ru: what changed
Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | + | ## Contents | |
| 2 | + | ||
| 3 | + | * 1 Общее | |
| 4 | + | * 2 Доступность | |
| 5 | + | * 3 Простые действия | |
| 6 | + | * 4 Функции | |
| 7 | + | * 5 Представление объектов | |
| 8 | + | * 5.1 Caller: TSynEdit | |
| 9 | + | * 5.2 ClipBoard: TClipBoard | |
| 10 | + | * 6 Пример | |
| 11 | + | ||
| 1 | 12 | # Общее | |
| 2 | 13 | ||
| 3 | - | ||
| 14 | + | Макросы [[PascalScript]] доступны в Lazarus 1.1 и более поздних версиях. Чтобы использовать эту функцию, вам необходимо установить пакет EditorMacroScript, который включает пакет [[Pascal Script/ru|Pascal Script]]. Pascal Script предоставляется объектами REM. Минимальный пакет предоставляется дистрибутивом Lazarus 1.1. | |
| 4 | 15 | ||
| 5 | 16 | См. также [[IDE Window: Editor Macros/ru|IDE_Window:_Editor_Macros]] | |
| 6 | 17 | ||
| 7 | 18 | # Доступность | |
| 8 | 19 | ||
| 9 | - | ||
| 20 | + | Эта функциональность доступна только на определенных платформах/архитектурах: | |
| 10 | 21 | ||
| 11 | - | ||
| 12 | - | ||
| 13 | - | ||
| 14 | - | ||
| 15 | - | ||
| 16 | - | ||
| 17 | - | ||
| 22 | + | * Windows | |
| 23 | + | * 32/64bit Intel/AMD | |
| 24 | + | * Linux | |
| 25 | + | * 32/64bit Intel/AMD | |
| 26 | + | * Mac | |
| 27 | + | * 32(/maybe 64)bit Intel/AMD | |
| 28 | + | * 32bit PPC | |
| 18 | 29 | ||
| 19 | 30 | # Простые действия | |
| 20 | 31 | ||
| 21 | - | ||
| 22 | - | ||
| 23 | - | ||
| 24 | - | ||
| 32 | + | Все простые действия с клавиатурой представлены следующим образом: | |
| 25 | 33 | ||
| 26 | - | ||
| 27 | - | ||
| 34 | + | ecLeft; | |
| 35 | + | Перемещает каретку [на один символ] влево (в редакторе, который вызвал макрос) | |
| 36 | + | ecChar('a'); | |
| 37 | + | Вставляет [символ] 'a' | |
| 28 | 38 | ||
| 29 | - | ||
| 39 | + | См. модуль SynEditKeyCmds в пакете [[SynEdit/ru|SynEdit]] и IDECommands в IDEIntf для [получения] полного списка. Или используйте Recorder для получения имен действий. | |
| 30 | 40 | ||
| 31 | 41 | # Функции | |
| 32 | - | ||
| 33 | - | ||
| 34 | - | ||
| 35 | - | ||
| 36 | - | ||
| 37 | - | ||
| 38 | - | ||
| 39 | - | ||
| 42 | + | ``` | |
| 43 | + | Function MessageDlg( const Msg : string; DlgType : TMsgDlgType; Buttons : TMsgDlgButtons; HelpCtx : Longint) : Integer'); | |
| 44 | + | Function MessageDlgPos( const Msg : string; DlgType : TMsgDlgType; Buttons : TMsgDlgButtons; HelpCtx : Longint; X, Y : Integer) : Integer'); | |
| 45 | + | Function MessageDlgPosHelp( const Msg : string; DlgType : TMsgDlgType; Buttons : TMsgDlgButtons; HelpCtx : Longint; X, Y : Integer; const HelpFileName : string) : Integer'); | |
| 46 | + | Procedure ShowMessage( const Msg : string); | |
| 47 | + | Procedure ShowMessagePos( const Msg : string; X, Y : Integer)'); | |
| 48 | + | Function InputBox( const ACaption, APrompt, ADefault : string) : string'); | |
| 49 | + | Function InputQuery( const ACaption, APrompt : string; var Value : string) : Boolean'); | |
| 50 | + | ``` | |
| 40 | 51 | ||
| 41 | 52 | # Представление объектов | |
| 42 | 53 | ||
| 43 | - | ||
| 54 | + | Сценарии могут ссылаться на вызывающий SynEdit через идентификатор "Caller". | |
| 44 | 55 | ||
| 45 | 56 | ## Caller: TSynEdit | |
| 46 | 57 | ||
| 47 | - | ||
| 48 | - | ||
| 49 | - | ||
| 50 | - | ||
| 51 | - | ||
| 52 | - | ||
| 53 | - | ||
| 54 | - | ||
| 55 | - | ||
| 56 | - | ||
| 57 | - | ||
| 58 | - | ||
| 59 | - | ||
| 60 | - | ||
| 61 | - | ||
| 62 | - | ||
| 63 | - | ||
| 64 | - | ||
| 65 | - | ||
| 66 | - | ||
| 67 | - | ||
| 68 | - | ||
| 69 | - | ||
| 70 | - | ||
| 71 | - | ||
| 72 | - | ||
| 73 | - | ||
| 74 | - | ||
| 75 | - | ||
| 76 | - | ||
| 77 | - | ||
| 78 | - | ||
| 79 | - | ||
| 80 | - | ||
| 81 | - | ||
| 82 | - | ||
| 83 | - | ||
| 84 | - | ||
| 85 | - | ||
| 86 | - | ||
| 87 | - | ||
| 88 | - | ||
| 89 | - | ||
| 90 | - | ||
| 58 | + | Доступны следующие методы и свойства: | |
| 91 | 59 | ||
| 92 | - | ||
| 60 | + | Caret (Каретка) | |
| 61 | + | ||
| 62 | + | ``` | |
| 63 | + | property CaretX: Integer; | |
| 64 | + | property CaretY: Integer; | |
| 65 | + | property CaretXY: TPoint; | |
| 66 | + | property LogicalCaretXY: TPoint; | |
| 67 | + | property LogicalCaretX: Integer; | |
| 68 | + | procedure MoveCaretIgnoreEOL(const NewCaret: TPoint); | |
| 69 | + | procedure MoveLogicalCaretIgnoreEOL(const NewLogCaret: TPoint); | |
| 70 | + | ``` | |
| 93 | 71 | ||
| 94 | - | ||
| 95 | - | ||
| 96 | - | ||
| 72 | + | Selection (Выделение) | |
| 73 | + | ||
| 74 | + | ``` | |
| 75 | + | property BlockBegin: TPoint; | |
| 76 | + | property BlockEnd: TPoint; | |
| 77 | + | property SelAvail: Boolean; // только для чтения | |
| 78 | + | property SelText: string; | |
| 79 | + | property SelectionMode: TSynSelectionMode; | |
| 80 | + | procedure ClearSelection; | |
| 81 | + | procedure SelectAll; | |
| 82 | + | procedure SelectToBrace; | |
| 83 | + | procedure SelectWord; | |
| 84 | + | procedure SelectLine(WithLeadSpaces: Boolean); | |
| 85 | + | procedure SelectParagraph; | |
| 86 | + | ``` | |
| 97 | 87 | ||
| 98 | - | ||
| 88 | + | ||
| 99 | 89 | ||
| 100 | - | ||
| 101 | - | ||
| 102 | - | ||
| 103 | - | ||
| 104 | - | ||
| 105 | - | ||
| 106 | - | ||
| 107 | - | ||
| 108 | - | ||
| 109 | - | ||
| 110 | - | ||
| 90 | + | Search/Replace (Поиск/Замена) | |
| 91 | + | ||
| 92 | + | ``` | |
| 93 | + | function SearchReplace(const ASearch, AReplace: string; AOptions: TSynSearchOptions): integer; | |
| 94 | + | function SearchReplaceEx(const ASearch, AReplace: string; AOptions: TSynSearchOptions; AStart: TPoint): integer; | |
| 95 | + | ``` | |
| 96 | + | ``` | |
| 97 | + | TSynSearchOptions = set of | |
| 98 | + | ( ssoMatchCase, ssoWholeWord, | |
| 99 | + | ssoBackwards, | |
| 100 | + | ssoEntireScope, ssoSelectedOnly, // По умолчанию от [текущего положения] каретки до конца | |
| 101 | + | // текста (или к началу текста, если наоборот) | |
| 102 | + | ssoReplace, ssoReplaceAll, // В противном случае функция выполняет только поиск | |
| 103 | + | ssoPrompt, // Показывать приглашение перед заменой | |
| 104 | + | ssoSearchInReplacement, // продолжить поиск-замену в замещенном (с помощью ssoReplaceAll)/рекурсивная замена | |
| 105 | + | ssoRegExpr, ssoRegExprMultiLine, | |
| 106 | + | ssoFindContinue // Предположим, что текущее выделение является последним совпадением и | |
| 107 | + | // начинается поиск позади выделения (впереди [выделения], если ssoBackward) | |
| 108 | + | // По умолчанию [поиск] начинается с [текущего положения] каретки (только | |
| 109 | + | // для SearchReplace/SearchReplaceEx, [который] имеет параметр start/end); | |
| 110 | + | ``` | |
| 111 | 111 | ||
| 112 | - | ||
| 112 | + | Возвращает количество выполненных замен. При поиске, возвращает 1, если [совпадение] найдено, 0, если [совпадение] не найдено. Если найдено совпадение, [оно] будет выделено (используйте BlockBegin/End). | |
| 113 | + | ``` | |
| 114 | + | if Caller.SearchReplace('FindMe', ' ', []) > 0 then begin | |
| 115 | + | // Выделение устанавливается на первое появление FindMe (поиск с позиции каретки) | |
| 116 | + | end; | |
| 117 | + | ``` | |
| 113 | 118 | ||
| 114 | - | ||
| 115 | - | ||
| 116 | - | ||
| 117 | - | ||
| 119 | + | Text (Текст) | |
| 120 | + | ||
| 121 | + | ``` | |
| 122 | + | property Lines[Index: Integer]: string; // read only | |
| 123 | + | property LineAtCaret: string; // read only | |
| 124 | + | procedure InsertTextAtCaret(aText: String; aCaretMode : TSynCaretAdjustMode); | |
| 125 | + | property TextBetweenPoints[aStartPoint, aEndPoint: TPoint]: String // Логическая точка | |
| 126 | + | procedure SetTextBetweenPoints(aStartPoint, aEndPoint: TPoint; | |
| 127 | + | const AValue: String; | |
| 128 | + | aFlags: TSynEditTextFlags = []; | |
| 129 | + | aCaretMode: TSynCaretAdjustMode; | |
| 130 | + | aMarksMode: TSynMarksAdjustMode; | |
| 131 | + | aSelectionMode: TSynSelectionMode | |
| 132 | + | ); | |
| 133 | + | ``` | |
| 118 | 134 | ||
| 119 | - | ||
| 135 | + | Clipboard (Буфер обмена) | |
| 136 | + | ||
| 137 | + | ``` | |
| 138 | + | procedure CopyToClipboard; | |
| 139 | + | procedure CutToClipboard; | |
| 140 | + | procedure PasteFromClipboard; | |
| 141 | + | property CanPaste: Boolean // только для чтения | |
| 142 | + | ``` | |
| 120 | 143 | ||
| 121 | - | ||
| 122 | - | ||
| 123 | - | ||
| 124 | - | ||
| 125 | - | ||
| 126 | - | ||
| 127 | - | ||
| 144 | + | Logical / Physical (Логический / Физический) | |
| 145 | + | ||
| 146 | + | ``` | |
| 147 | + | function LogicalToPhysicalPos(const p: TPoint): TPoint; | |
| 148 | + | function LogicalToPhysicalCol(const Line: String; Index, LogicalPos | |
| 149 | + | : integer): integer; | |
| 150 | + | function PhysicalToLogicalPos(const p: TPoint): TPoint; | |
| 151 | + | function PhysicalToLogicalCol(const Line: string; | |
| 152 | + | Index, PhysicalPos: integer): integer; | |
| 153 | + | function PhysicalLineLength(Line: String; Index: integer): integer; | |
| 154 | + | ``` | |
| 128 | 155 | ||
| 129 | 156 | ## ClipBoard: TClipBoard | |
| 130 | - | ||
| 131 | - | ||
| 157 | + | ``` | |
| 158 | + | property AsText: String; | |
| 159 | + | ``` | |
| 132 | 160 | ||
| 133 | 161 | # Пример | |
| 134 | 162 | ||
| 135 | - | ||
| 136 | - | ||
| 137 | - | ||
| 163 | + | Макрос, показанный ниже, выравнивает выбранный код к определенному токену. Он ищет определенный токен в каждой выбранной строке и выравнивает каждое его появление. | |
| 138 | 164 | ||
| 139 | - | ||
| 140 | - | ||
| 141 | - | ||
| 142 | - | ||
| 165 | + | Выберите 3 строки. Если выделение начинается прямо перед ":", тогда символ ":" будет обнаружен. В подсказке будет предложено подтвердить ":". Затем все ":" будут выровнены. (Если вы используете слово для выравнивания, обратите внимание, что [выравнивание] будет подогнано независимо от границ слова) | |
| 143 | 166 | ``` | |
| 144 | - | ||
| 145 | - | ||
| 167 | + | text: string; | |
| 168 | + | a: Integer; | |
| 169 | + | foo: boolean | |
| 170 | + | ``` | |
| 146 | 171 | ||
| 147 | - | ||
| 172 | + | Макрос: | |
| 173 | + | ``` | |
| 148 | 174 | function IsIdent(c: Char): Boolean; | |
| 149 | - | ||
| 150 | - | ||
| 151 | - | ||
| 152 | - | ||
| 153 | - | ||
| 154 | - | ||
| 155 | - | ||
| 156 | - | ||
| 157 | - | ||
| 158 | - | ||
| 159 | - | ||
| 160 | - | ||
| 161 | - | ||
| 162 | - | ||
| 163 | - | ||
| 164 | - | ||
| 165 | - | ||
| 166 | - | ||
| 167 | - | ||
| 168 | - | ||
| 169 | - | ||
| 170 | - | ||
| 171 | - | ||
| 172 | - | ||
| 173 | - | ||
| 174 | - | ||
| 175 | - | ||
| 176 | - | ||
| 177 | - | ||
| 178 | - | ||
| 179 | - | ||
| 180 | - | ||
| 181 | - | ||
| 182 | - | ||
| 183 | - | ||
| 184 | - | ||
| 185 | - | ||
| 186 | - | ||
| 187 | - | ||
| 188 | - | ||
| 189 | - | ||
| 190 | - | ||
| 191 | - | ||
| 192 | - | ||
| 193 | - | ||
| 194 | - | ||
| 195 | - | ||
| 196 | - | ||
| 197 | - | ||
| 198 | - | ||
| 199 | - | ||
| 175 | + | begin | |
| 176 | + | Result := ((c >= 'a') and (c <= 'z')) or | |
| 177 | + | ((c >= 'A') and (c <= 'Z')) or | |
| 178 | + | ((c >= '0') and (c <= '9')) or | |
| 179 | + | (c = '_'); | |
| 200 | 180 | end; | |
| 201 | - | ||
| 202 | - | ||
| 203 | - | ||
| 181 | + | ||
| 182 | + | var | |
| 183 | + | p1, p2: TPoint; | |
| 184 | + | s1, s2: string; | |
| 185 | + | i, j, k: Integer; | |
| 186 | + | begin | |
| 187 | + | if not Caller.SelAvail then exit; | |
| 188 | + | p1 := Caller.BlockBegin; | |
| 189 | + | p2 := Caller.BlockEnd; | |
| 190 | + | if (p1.y > p2.y) or ((p1.y = p2.y) and (p1.x > p2.x)) then begin | |
| 191 | + | p1 := Caller.BlockEnd; | |
| 192 | + | p2 := Caller.BlockBegin; | |
| 193 | + | end; | |
| 194 | + | s1 := Caller.Lines[p1.y - 1]; | |
| 195 | + | s2 := ''; | |
| 196 | + | i := p1.x | |
| 197 | + | while (i <= length(s1)) and (s1[i] in [#9, ' ']) do inc(i); | |
| 198 | + | j := i; | |
| 199 | + | if i <= length(s1) then begin | |
| 200 | + | if IsIdent(s1[i]) then // pascal identifier | |
| 201 | + | while (i <= length(s1)) and IsIdent(s1[i]) do inc(i) | |
| 202 | + | else | |
| 203 | + | while (i <= length(s1)) and not(IsIdent(s1[i]) or (s1[i] in [#9, ' '])) do inc(i); | |
| 204 | + | end; | |
| 205 | + | if i > j then s2 := copy(s1, j, i-j); | |
| 206 | + | ||
| 207 | + | if not InputQuery( 'Align', 'Token', s2) then exit; | |
| 208 | + | ||
| 209 | + | j := 0; | |
| 210 | + | for i := p1.y to p2.y do begin | |
| 211 | + | s1 := Caller.Lines[i - 1]; | |
| 212 | + | k := pos(s2, s1); | |
| 213 | + | if (k > j) then j := k; | |
| 214 | + | end; | |
| 215 | + | if j < 1 then exit; | |
| 216 | + | ||
| 217 | + | for i := p1.y to p2.y do begin | |
| 218 | + | s1 := Caller.Lines[i - 1]; | |
| 219 | + | k := pos(s2, s1); | |
| 220 | + | if (k > 0) and (k < j) then begin | |
| 221 | + | Caller.LogicalCaretXY := Point(k, i); | |
| 222 | + | while k < j do begin | |
| 223 | + | ecChar(' '); | |
| 224 | + | inc(k); | |
| 225 | + | end; | |
| 226 | + | end; | |
| 227 | + | end; | |
| 228 | + | ||
| 229 | + | end. | |
| 204 | 230 | ``` | |
| 205 | 231 | ||
| 232 | + | ||
| 206 | 233 | См. <http://forum.lazarus.freepascal.org/index.php/topic,27186.msg167883.html#msg167883> для подсчета элементов массива. | |
| 207 | 234 | ||
| 208 | 235 | --- | |
| 209 | - | ||
| 236 | + | *From the Free Pascal wiki, page "Editor Macros PascalScript/ru", as the Internet Archive kept it on 2022-10-03. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* |
