Extending the IDE/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 Расширение IDE | |
| 4 | + | * 1.1 Обзор | |
| 5 | + | * 1.2 Пакеты и зависимости Makefile | |
| 6 | + | * 2 Пункты меню | |
| 7 | + | * 2.1 Добавление пункта меню | |
| 8 | + | * 3 Сочетания клавиш | |
| 9 | + | * 4 Конфигурационные файлы | |
| 10 | + | * 4.1 Загрузка/Сохранение настроек | |
| 11 | + | * 5 Компоненты | |
| 12 | + | * 5.1 Расширение существующих компонентов | |
| 13 | + | * 5.2 Написание компонент | |
| 14 | + | * 5.2.1 Предоставление новому компоненту иконки для палитры компонентов | |
| 15 | + | * 5.2.2 Скрытие компонента в палитре компонентов | |
| 16 | + | * 5.3 Написание редактора компонента | |
| 17 | + | * 5.4 Написание редакторов свойств | |
| 18 | + | * 5.4.1 Сокрытие свойства в инспекторе объектов | |
| 19 | + | * 5.4.2 Поиск редактора свойств, используемого для свойства | |
| 20 | + | * 6 Формы | |
| 21 | + | * 7 Дизайнер | |
| 22 | + | * 7.1 Написание дизайнера-посредника | |
| 23 | + | * 7.2 Создание нового уникального имени компонента | |
| 24 | + | * 7.3 Выбор компонента в конструкторе/инспекторе объектов | |
| 25 | + | * 7.4 Получение файла модуля, дизайнера формы | |
| 26 | + | * 7.5 Сохранение модуля, дизайнера формы | |
| 27 | + | * 7.6 Сохранение формы дизайнера как кода Паскаль | |
| 28 | + | * 8 Обработчики событий | |
| 29 | + | * 8.1 События дизайнера | |
| 30 | + | * 8.1.1 Примеры для событий дизайнера | |
| 31 | + | * 8.1.1.1 Пример: когда [на родителя] помещается новый компонент, перемещать элемент управления в дочерний элемент | |
| 32 | + | * 8.1.2 Отключение обработчика мыши в [режиме] дизайнера | |
| 33 | + | * 8.2 Получение уведомлений при изменении дизайнера форм | |
| 34 | + | * 8.3 События проекта | |
| 35 | + | * 8.4 Другие события IDE | |
| 36 | + | * 9 Проект | |
| 37 | + | * 9.1 Текущий проект | |
| 38 | + | * 9.2 Все модули текущего проекта | |
| 39 | + | * 9.2.1 Все модули инспектора проекта | |
| 40 | + | * 9.2.2 Все используемые модули проекта | |
| 41 | + | * 9.3 Файлы .lpr, .lpi и .lps проекта | |
| 42 | + | * 9.4 Имя исполняемого / целевого файла проекта | |
| 43 | + | * 9.5 Добавление своего собственного типа проекта | |
| 44 | + | * 9.6 Добавление своих собственных типов файлов | |
| 45 | + | * 9.6.1 Добавление нового типа файла | |
| 46 | + | * 9.6.2 Добавление нового типа формы | |
| 47 | + | * 9.7 Сохранение пользовательских значений в [файлах] lpi/lps | |
| 48 | + | * 10 Пакеты | |
| 49 | + | * 10.1 Поиск во всех пакетах | |
| 50 | + | * 10.2 Поиск в пакетах с [определенным] именем | |
| 51 | + | * 10.3 Получение имени файла lpk установленного пакета | |
| 52 | + | * 10.4 Установка пакетов | |
| 53 | + | * 10.5 Открытие файла пакета (lpk) | |
| 54 | + | * 10.6 Поиск пакета(-ов) модуля | |
| 55 | + | * 11 Окна | |
| 56 | + | * 11.1 Добавление нового закрепляемого окна IDE | |
| 57 | + | * 11.1.1 Как зарегистрировать закрепляемое окно IDE | |
| 58 | + | * 11.1.2 Отображение окна IDE | |
| 59 | + | * 11.1.3 Заметки о IDEWindowCreators и SimpleLayoutStorage | |
| 60 | + | * 12 CodeTools | |
| 61 | + | * 12.1 Добавление директивы ресурса в файл | |
| 62 | + | * 12.2 Получение путей поиска для модулей и включаемых файлов | |
| 63 | + | * 13 Редактор исходного кода | |
| 64 | + | * 13.1 Активный редактор исходного кода | |
| 65 | + | * 14 SynEdit | |
| 66 | + | * 14.1 Получение настроек для TSynEdit | |
| 67 | + | * 14.2 Получение настроек для подсветки SynEdit | |
| 68 | + | * 15 Справка | |
| 69 | + | * 15.1 Добавление справки для исходников | |
| 70 | + | * 15.2 Добавление строк в окно сообщений | |
| 71 | + | * 16 Окно настроек IDE | |
| 72 | + | * 16.1 Открытие параметров в определенном кадре | |
| 73 | + | * 17 Прочее | |
| 74 | + | * 17.1 Добавление макроса | |
| 75 | + | * 17.2 Отладка IDE | |
| 76 | + | * 17.3 См. также | |
| 77 | + | ||
| 78 | + | ||
| 79 | + | ||
| 1 | 80 | # Расширение IDE | |
| 2 | 81 | ||
| 3 | 82 | ## Обзор | |
| 4 | 83 | ||
| 5 | - | ||
| 84 | + | Lazarus IDE поддерживает несколько типов плагинов: | |
| 6 | 85 | ||
| 7 | - | ||
| 8 | - | ||
| 86 | + | Компоненты | |
| 87 | + | это элементы, найденные в палитре компонентов. Например, TButton (находится на странице Standard) можно использовать для создания кнопок. | |
| 9 | 88 | ||
| 10 | - | ||
| 11 | - | ||
| 89 | + | Редакторы компонентов | |
| 90 | + | при двойном щелчке по компоненту в Дизайнере вызывается редактор компонентов. Редактор компонента также может добавить дополнительный элемент во всплывающее меню Дизайнера (доступ к нему осуществляется по щелчку правой кнопкой мыши на компоненте в конструкторе). | |
| 12 | 91 | ||
| 13 | - | ||
| 14 | - | ||
| 92 | + | Редакторы свойств | |
| 93 | + | Каждая строка в разделе сетки Инспектора объектов использует редактор свойств, чтобы разрешить установку или изменение значения этого свойства. | |
| 15 | 94 | ||
| 16 | - | ||
| 17 | - | ||
| 95 | + | Эксперты | |
| 96 | + | Эксперты охватывают все другие типы плагинов. Они могут регистрировать новые пункты меню, регистрировать ярлыки или расширять другие функции IDE. | |
| 18 | 97 | ||
| 19 | - | ||
| 98 | + | Есть два возможных способа добавить свои собственные плагины в IDE Lazarus: | |
| 20 | 99 | ||
| 21 | - | ||
| 22 | - | ||
| 100 | + | 1. Напишите пакет, установите его и зарегистрируйте ваши плагины в процедуре 'Register' модуля. | |
| 101 | + | 2. Расширьте код Lazarus и отправьте свой svn diff в список рассылки Lazarus. | |
| 23 | 102 | ||
| 24 | 103 | ## Пакеты и зависимости Makefile | |
| 25 | 104 | ||
| 26 | - | ||
| 105 | + | Следующие шаги необходимы, если добавляются новые зависимости пакета. | |
| 27 | 106 | ||
| 28 | - | ||
| 29 | - | ||
| 107 | + | * Создание/Обновление Makefile для пакета через Package editor / More ... / Create Makefile. | |
| 108 | + | * Исправление всех зависимостей. См. tools/updatemakefiles.lpi | |
| 30 | 109 | ||
| 31 | 110 | # Пункты меню | |
| 32 | 111 | ||
| 33 | - | ||
| 112 | + | Вы можете добавлять новые пункты меню, скрывать или перемещать существующие и добавлять подменю, разделы. Для ваших собственных форм вы можете зарегистрировать TMainMenu/TPopupMenu, чтобы другие пакеты могли расширять вашу форму дальше. Модуль **MenuIntf** пакета IDEIntf содержит всю регистрацию для меню и множество стандартных пунктов меню самой IDE. | |
| 34 | 113 | ||
| 35 | 114 | ## Добавление пункта меню | |
| 36 | 115 | ||
| 37 | - | ||
| 38 | - | ||
| 39 | - | ||
| 116 | + | Одиночный элемент меню, такой как [, например,] 'View Object Inspector', называется **TIDEMenuCommand**. Вы можете создать его с помощью **RegisterIDEMenuCommand** , который имеет две формы с большим количеством параметров: | |
| 117 | + | ``` | |
| 40 | 118 | function RegisterIDEMenuCommand(Parent: TIDEMenuSection; | |
| 41 | - | ||
| 42 | - | ||
| 43 | - | ||
| 44 | - | ||
| 45 | - | ||
| 46 | - | ||
| 47 | - | ||
| 48 | - | ||
| 49 | - | ||
| 50 | - | ||
| 51 | - | ||
| 52 | - | ||
| 119 | + | const Name, Caption: string; | |
| 120 | + | const OnClickMethod: TNotifyEvent = nil; | |
| 121 | + | const OnClickProc: TNotifyProcedure = nil; | |
| 122 | + | const Command: TIDECommand = nil; | |
| 123 | + | const ResourceName: String = '' | |
| 124 | + | ): TIDEMenuCommand; overload; | |
| 125 | + | function RegisterIDEMenuCommand(const Path, Name, Caption: string; | |
| 126 | + | const OnClickMethod: TNotifyEvent = nil; | |
| 127 | + | const OnClickProc: TNotifyProcedure = nil; | |
| 128 | + | const Command: TIDECommand = nil; | |
| 129 | + | const ResourceName: String = '' | |
| 130 | + | ): TIDEMenuCommand; overload; | |
| 53 | 131 | ``` | |
| 54 | 132 | ||
| 55 | - | ||
| 56 | - | ||
| 57 | - | ||
| 133 | + | Разница между этими двумя [функциями] только в том, как вы указываете родительский раздел меню. Вы можете указать раздел меню прямо или косвенно через путь. Многие стандартные разделы можно найти в модуле _MenuIntf_. Например, раздел **mnuTools** , который является [пунктом] меню _Tools_ главной панели IDE. Он содержит раздел **itmSecondaryTools** , рекомендуемый для сторонних инструментов. | |
| 58 | 134 | ||
| 59 | - | ||
| 135 | + | Следующий [код] регистрирует новую команду меню с именем 'MyTool', с заголовком 'Start my tool' и при нажатии выполняет процедуру _StartMyTool_ : | |
| 136 | + | ``` | |
| 60 | 137 | procedure StartMyTool; | |
| 61 | - | ||
| 62 | - | ||
| 63 | - | ||
| 64 | - | ||
| 65 | - | ||
| 66 | - | ||
| 67 | - | ||
| 68 | - | ||
| 138 | + | begin | |
| 139 | + | ... выполняется при нажатии на пункт меню ... | |
| 140 | + | end; | |
| 141 | + | ||
| 142 | + | procedure Register; | |
| 143 | + | begin | |
| 144 | + | RegisterIDEMenuCommand(itmSecondaryTools, 'MyTool','Start my tool',nil,@StartMyTool); | |
| 145 | + | end; | |
| 69 | 146 | ``` | |
| 70 | 147 | ||
| 71 | - | ||
| 72 | - | ||
| 73 | - | ||
| 148 | + | Если вы хотите вызвать метод вместо процедуры, используйте параметр **OnClickMethod**. | |
| 74 | 149 | ||
| 75 | - | ||
| 150 | + | Этот пункт меню не имеет сочетания клавиш. Если вы хотите [назначить ему] сочетание клавиш, вы должны создать **TIDECommand** и передать его в параметре **Command**. Например: | |
| 151 | + | ``` | |
| 76 | 152 | uses ... IDECommands, MenuIntf; | |
| 77 | - | ||
| 78 | - | ||
| 79 | - | ||
| 80 | - | ||
| 81 | - | ||
| 82 | - | ||
| 83 | - | ||
| 84 | - | ||
| 85 | - | ||
| 86 | - | ||
| 87 | - | ||
| 88 | - | ||
| 153 | + | ... | |
| 154 | + | var | |
| 155 | + | Key: TIDEShortCut; | |
| 156 | + | Cat: TIDECommandCategory; | |
| 157 | + | CmdMyTool: TIDECommand; | |
| 158 | + | begin | |
| 159 | + | // регистрация сочетаний клавиш IDE и пункта меню | |
| 160 | + | Key := IDEShortCut(VK_UNKNOWN,[],VK_UNKNOWN,[]); | |
| 161 | + | Cat:=IDECommandList.FindCategoryByName(CommandCategoryToolMenuName); | |
| 162 | + | CmdMyTool := RegisterIDECommand(Cat,'Start my tool', 'Starts my tool to do some stuff', Key, nil, @StartMyTool); | |
| 163 | + | RegisterIDEMenuCommand(itmSecondaryTools, 'MyTool', 'Start my tool', nil, nil, CmdMyTool); | |
| 164 | + | end; | |
| 89 | 165 | ``` | |
| 90 | 166 | ||
| 91 | 167 | # Сочетания клавиш | |
| 92 | 168 | ||
| 93 | - | ||
| 94 | - | ||
| 95 | - | ||
| 169 | + | Все сочетания клавиш (ключи, которые вызывают какое-либо действие) зарегистрированы в IDECommandList. Вот пример того, как найти все команды, которые реагируют на клавиши `Ctrl`+`D` или две комбинации клавиш, начинающиеся с `Ctrl`+`D`: | |
| 170 | + | ``` | |
| 96 | 171 | uses | |
| 97 | - | ||
| 98 | - | ||
| 99 | - | ||
| 100 | - | ||
| 101 | - | ||
| 102 | - | ||
| 103 | - | ||
| 104 | - | ||
| 105 | - | ||
| 106 | - | ||
| 107 | - | ||
| 108 | - | ||
| 109 | - | ||
| 110 | - | ||
| 111 | - | ||
| 112 | - | ||
| 113 | - | ||
| 114 | - | ||
| 115 | - | ||
| 172 | + | Classes, SysUtils, LCLProc, IDECommands; | |
| 173 | + | ||
| 174 | + | procedure ListCtrlD; | |
| 175 | + | // список всех команд IDE с комбинациями клавиш <Ctrl>+<D> | |
| 176 | + | var | |
| 177 | + | i: integer; | |
| 178 | + | Cmd: TIDECommand; | |
| 179 | + | Commands: TFPList; | |
| 180 | + | begin | |
| 181 | + | Commands:=IDECommandList.FindCommandsByShortCut(IDEShortCut(VK_D,[],VK_UNKNOWN,[])); | |
| 182 | + | try | |
| 183 | + | for i:=0 to Commands.Count-1 do begin | |
| 184 | + | Cmd:=TIDECommand(Commands[i]); | |
| 185 | + | writeln('Cmd: ',Cmd.Name, | |
| 186 | + | ' A=',dbgs(Cmd.ShortcutA.Shift1),'-',Cmd.ShortcutA.Key1, | |
| 187 | + | ',',dbgs(Cmd.ShortcutA.Shift2),'-',Cmd.ShortcutA.Key2, | |
| 188 | + | ' B=',dbgs(Cmd.ShortcutB.Shift1),'-',Cmd.ShortcutB.Key1, | |
| 189 | + | ',',dbgs(Cmd.ShortcutB.Shift2),'-',Cmd.ShortcutB.Key2 | |
| 190 | + | ); | |
| 191 | + | end; | |
| 192 | + | finally | |
| 193 | + | Commands.Free; | |
| 194 | + | end; | |
| 116 | 195 | end; | |
| 117 | - | ||
| 118 | - | ||
| 119 | - | ||
| 120 | - | ||
| 121 | 196 | ``` | |
| 122 | 197 | ||
| 123 | 198 | # Конфигурационные файлы | |
| 124 | 199 | ||
| 125 | 200 | ## Загрузка/Сохранение настроек | |
| 126 | 201 | ||
| 127 | - | ||
| 128 | - | ||
| 129 | - | ||
| 202 | + | Все конфигурационные файлы IDE хранятся в одном каталоге в виде XML-файлов. Пакеты также могут добавлять свои собственные файлы туда. Каталог [[pcp|primary config path]] можно прочитать с помощью: | |
| 203 | + | ``` | |
| 130 | 204 | uses LazIDEIntf; | |
| 131 | - | ||
| 132 | - | ||
| 205 | + | ... | |
| 206 | + | Directory := LazarusIDE.GetPrimaryConfigPath; | |
| 133 | 207 | ``` | |
| 134 | 208 | ||
| 135 | - | ||
| 136 | - | ||
| 137 | - | ||
| 209 | + | Пакеты могут создавать свои собственные файлы XML с помощью: | |
| 210 | + | ``` | |
| 138 | 211 | uses | |
| 139 | - | ||
| 140 | - | ||
| 141 | - | ||
| 142 | - | ||
| 143 | - | ||
| 144 | - | ||
| 145 | - | ||
| 146 | - | ||
| 147 | - | ||
| 148 | - | ||
| 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 | - | ||
| 212 | + | ..., LCLProc, BaseIDEIntf, LazConfigStorage; | |
| 213 | + | ||
| 214 | + | const | |
| 215 | + | Version = 1; | |
| 216 | + | var | |
| 217 | + | Config: TConfigStorage; | |
| 218 | + | SomeValue: String; | |
| 219 | + | SomeInteger: Integer; | |
| 220 | + | SomeBoolean: Boolean; | |
| 221 | + | FileVersion: LongInt; | |
| 222 | + | begin | |
| 223 | + | SomeValue:='Default'; | |
| 224 | + | SomeInteger:=3; | |
| 225 | + | SomeBoolean:=true; | |
| 226 | + | ||
| 227 | + | // сохранение настроек | |
| 228 | + | try | |
| 229 | + | Config:=GetIDEConfigStorage('mysettings.xml',false); | |
| 230 | + | try | |
| 231 | + | // сохраняем номер версии, чтобы будущие расширения могли обрабатывать старые файлы конфигурации | |
| 232 | + | Config.SetDeleteValue('Path/To/The/Version',Version,0); | |
| 233 | + | // сохраняем строковую переменную "SomeValue" | |
| 234 | + | // если SomeValue имеет значение по умолчанию, запись не сохраняется, | |
| 235 | + | // поэтому сохраняются только [значения,] отличающиеся от значения по умолчанию. | |
| 236 | + | // Таким образом, xml остается коротким, и значения по умолчанию могут измениться в будущем. | |
| 237 | + | Config.SetDeleteValue('Path/To/Some/Value',SomeValue,'Default'); | |
| 238 | + | Config.SetDeleteValue('Path/To/Some/Integer',SomeInteger,3); | |
| 239 | + | Config.SetDeleteValue('Path/To/Some/Boolean',SomeBoolean,true); | |
| 240 | + | // далее [по коду] еще overloads-инструкции для SetDeleteValue, | |
| 241 | + | // которые [всплывают в редакторе кода по нажатию] <Ctrl>+<Space> | |
| 242 | + | finally | |
| 243 | + | Config.Free; | |
| 244 | + | end; | |
| 245 | + | ||
| 246 | + | except | |
| 247 | + | on E: Exception do begin | |
| 248 | + | DebugLn(['Saving mysettings.xml failed: ',E.Message]); | |
| 249 | + | end; | |
| 250 | + | end; | |
| 251 | + | ||
| 252 | + | // загрузка настроек | |
| 253 | + | try | |
| 254 | + | Config:=GetIDEConfigStorage('mysettings.xml',true); | |
| 255 | + | try | |
| 256 | + | // чтение версии конфигурации | |
| 257 | + | FileVersion:=Config.GetValue('Path/To/The/Version',0); | |
| 258 | + | // чтение строковой переменной "SomeValue". Если запись не существует, используется | |
| 259 | + | // значение по умолчанию | |
| 260 | + | SomeValue:=Config.GetValue('Path/To/Some/Value','Default'); | |
| 261 | + | SomeInteger:=Config.GetValue('Path/To/Some/Integer',3); | |
| 262 | + | SomeBoolean:=Config.GetValue('Path/To/Some/Boolean',true); | |
| 263 | + | finally | |
| 264 | + | Config.Free; | |
| 265 | + | end; | |
| 266 | + | except | |
| 267 | + | on E: Exception do begin | |
| 268 | + | DebugLn(['Loading mysettings.xml failed: ',E.Message]); | |
| 269 | + | end; | |
| 270 | + | end; | |
| 196 | 271 | end; | |
| 197 | - | ||
| 198 | - | ||
| 199 | 272 | ``` | |
| 200 | 273 | ||
| 201 | - | ||
| 274 | + | На заметку: | |
| 202 | 275 | ||
| 203 | - | ||
| 204 | - | ||
| 205 | - | ||
| 276 | + | * Каждый плагин IDE должен использовать свой собственный файл конфигурации. Особенно вы не должны использовать стандартные файлы опций IDE, такие как [editoroptions.xml](</index.php?title=editoroptions.xml&action=edit&redlink=1> "editoroptions.xml \(page does not exist\)") или [environmentmentoptions.xml](</index.php?title=environmentmentoptions.xml&action=edit&redlink=1> "environmentmentoptions.xml \(page does not exist\)"). | |
| 277 | + | * GetIDEConfigStorage при загрузке проверяет, существует ли файл и, если нет, копирует шаблон из вторичного каталога конфигурации. | |
| 278 | + | * Начиная с версии 0.9.31 вы можете использовать эту функцию для загрузки файла вне основного каталога конфигурации. | |
| 206 | 279 | ||
| 207 | 280 | # Компоненты | |
| 208 | 281 | ||
| 209 | 282 | ## Расширение существующих компонентов | |
| 210 | 283 | ||
| 211 | - | ||
| 212 | - | ||
| 213 | - | ||
| 284 | + | Источник: [[1]](<http://lazarus.freepascal.org/index.php/topic,17733.msg98425.html#msg98425>) Это обычная настройка существующих компонентов LCL, например, если вы хотите добавить свойства. | |
| 214 | 285 | ||
| 215 | - | ||
| 286 | + | Добавьте необходимые свойства с соответствующими методами установки и получения и полями хранения. | |
| 216 | 287 | ||
| 217 | - | ||
| 288 | + | Затем создайте их экземпляр «вручную», предоставив компонент-владелец (для последующей обработки), и установите [свойство] Parent и, возможно, [свойства] Top и Left и любые другие значения по умолчанию, необходимые для вашего компонента при инициализации. | |
| 218 | 289 | ||
| 219 | - | ||
| 290 | + | Когда вы убедитесь, что ваш настроенный компонент отлажен, добавьте вызов `RegisterComponent()`, чтобы прикрепить его к палитре компонентов IDE и избавьте вас от необходимости выполнять код установки вручную (посмотрите на исходник любого компонента, чтобы узнать, как это сделать). | |
| 220 | 291 | ||
| 221 | - | ||
| 292 | + | Вот простой пример: | |
| 293 | + | ``` | |
| 222 | 294 | unit Unit1; | |
| 223 | - | ||
| 224 | - | ||
| 225 | - | ||
| 226 | - | ||
| 227 | - | ||
| 228 | - | ||
| 229 | - | ||
| 230 | - | ||
| 231 | - | ||
| 232 | - | ||
| 233 | - | ||
| 234 | - | ||
| 235 | - | ||
| 236 | - | ||
| 237 | - | ||
| 238 | - | ||
| 239 | - | ||
| 240 | - | ||
| 241 | - | ||
| 242 | - | ||
| 243 | - | ||
| 244 | - | ||
| 245 | - | ||
| 246 | - | ||
| 247 | - | ||
| 248 | - | ||
| 249 | - | ||
| 250 | - | ||
| 251 | - | ||
| 252 | - | ||
| 253 | - | ||
| 254 | - | ||
| 255 | - | ||
| 256 | - | ||
| 257 | - | ||
| 258 | - | ||
| 259 | - | ||
| 260 | - | ||
| 261 | - | ||
| 262 | - | ||
| 263 | - | ||
| 264 | - | ||
| 265 | - | ||
| 266 | - | ||
| 267 | - | ||
| 268 | - | ||
| 269 | - | ||
| 270 | - | ||
| 271 | - | ||
| 272 | - | ||
| 273 | - | ||
| 274 | - | ||
| 275 | - | ||
| 276 | - | ||
| 277 | - | ||
| 278 | - | ||
| 279 | - | ||
| 280 | - | ||
| 281 | - | ||
| 282 | - | ||
| 283 | - | ||
| 284 | - | ||
| 285 | - | ||
| 286 | - | ||
| 287 | - | ||
| 288 | - | ||
| 289 | - | ||
| 290 | - | ||
| 291 | - | ||
| 295 | + | ||
| 296 | + | {$mode objfpc}{$H+} | |
| 297 | + | ||
| 298 | + | interface | |
| 299 | + | ||
| 300 | + | uses | |
| 301 | + | Classes, SysUtils, Forms, StdCtrls; | |
| 302 | + | ||
| 303 | + | type | |
| 304 | + | TEdX = class(TEdit) | |
| 305 | + | private | |
| 306 | + | FNewIntProp: integer; | |
| 307 | + | FNewStrProp: string; | |
| 308 | + | procedure SetNewIntProp(AValue: integer); | |
| 309 | + | procedure SetNewStrProp(AValue: string); | |
| 310 | + | public | |
| 311 | + | constructor Create(theComponent: TComponent); override; | |
| 312 | + | property NewIntProp: integer read FNewIntProp write SetNewIntProp; | |
| 313 | + | property NewStrProp: string read FNewStrProp write SetNewStrProp; | |
| 314 | + | end; | |
| 315 | + | ||
| 316 | + | TForm1 = class(TForm) | |
| 317 | + | procedure FormCreate(Sender: TObject); | |
| 318 | + | private | |
| 319 | + | edX: TEdX; | |
| 320 | + | public | |
| 321 | + | end; | |
| 322 | + | ||
| 323 | + | var | |
| 324 | + | Form1: TForm1; | |
| 325 | + | ||
| 326 | + | implementation | |
| 327 | + | ||
| 328 | + | { TForm1 } | |
| 329 | + | ||
| 330 | + | procedure TForm1.FormCreate(Sender: TObject); | |
| 331 | + | begin | |
| 332 | + | edX:= TEdX.Create(Self); | |
| 333 | + | edX.Parent:= Self; | |
| 334 | + | edX.Caption:= IntToStr(edX.NewIntProp); | |
| 335 | + | Caption:= edX.NewStrProp; | |
| 336 | + | end; | |
| 337 | + | ||
| 338 | + | {$R *.lfm} | |
| 339 | + | ||
| 340 | + | { TEdX } | |
| 341 | + | ||
| 342 | + | procedure TEdX.SetNewIntProp(AValue: integer); | |
| 343 | + | begin | |
| 344 | + | if FNewIntProp=AValue then Exit; | |
| 345 | + | FNewIntProp:=AValue; | |
| 346 | + | // добавьте свой код здесь | |
| 347 | + | end; | |
| 348 | + | ||
| 349 | + | procedure TEdX.SetNewStrProp(AValue: string); | |
| 350 | + | begin | |
| 351 | + | if FNewStrProp=AValue then Exit; | |
| 352 | + | FNewStrProp:=AValue; | |
| 353 | + | // добавьте свой код здесь | |
| 354 | + | end; | |
| 355 | + | ||
| 356 | + | constructor TEdX.Create(theComponent: TComponent); | |
| 357 | + | begin | |
| 358 | + | inherited Create(theComponent); | |
| 359 | + | FNewStrProp:= 'new string property value'; | |
| 360 | + | FNewIntProp:= 99; | |
| 361 | + | end; | |
| 362 | + | ||
| 363 | + | end. | |
| 292 | 364 | ``` | |
| 293 | 365 | ||
| 294 | 366 | ## Написание компонент | |
| 295 | 367 | ||
| 296 | - | ||
| 368 | + | _Основная статья:[[How To Write Lazarus Component/ru|How To Write Lazarus Component]]_ | |
| 297 | 369 | ||
| 298 | - | ||
| 370 | + | Вы можете создавать новые компоненты через редактор пакетов. | |
| 299 | 371 | ||
| 300 | - | ||
| 372 | + | Создайте или откройте пакет, нажмите **add**(добавить), нажмите **New Component** (Новый компонент), заполните пункты: Ancestor Type(Тип предка) = TButton, New class name (Имя нового класса) = TMyButton, palette page (страница палитры) = Misc, Unit file name (имя файла модуля) = mybutton.pas (этот файл будет создан), имя модуля MyButton, и нажмите кнопку **ok**. | |
| 301 | 373 | ||
| 302 | 374 | ### Предоставление новому компоненту иконки для палитры компонентов | |
| 303 | 375 | ||
| 304 | - | ||
| 305 | - | ||
| 306 | - | ||
| 376 | + | Создайте файл изображения в формате .bmp, .xpm или .png с тем же именем, что и класс компонента. Например, _tmybutton.png_ и сохраните его в исходном каталоге пакета. Изображение может быть создано любой графической программой (например, GIMP [или IncScape]) и должно быть не больше 24x24 пикселей. Затем преобразуйте изображение в файл ресурсов с помощью инструмента lazres, который можно найти в каталоге lazarus/tools: | |
| 377 | + | ``` | |
| 307 | 378 | ~/lazarus/tools/lazres mybutton.lrs tmybutton.png | |
| 308 | 379 | ``` | |
| 309 | 380 | ||
| 310 | - | ||
| 311 | - | ||
| 312 | - | ||
| 381 | + |  **Примечание:** Лаззарус trunk/1.4+? использует файлы ресурсов .res взамен .lrs-файлов | |
| 382 | + | ``` | |
| 313 | 383 | ~/lazarus/tools/lazres mybutton.res tmybutton.png | |
| 314 | 384 | ``` | |
| 315 | 385 | ||
| 316 | - | ||
| 317 | - | ||
| 318 | - | ||
| 386 | + | Это создаст include-файл паскаля, который используется в разделе initialization mybutton.pas: | |
| 387 | + | ``` | |
| 319 | 388 | initialization | |
| 320 | - | ||
| 321 | - | ||
| 322 | - | ||
| 389 | + | {$I mybutton.lrs} | |
| 390 | + | // или в более новой версии Lazarus - синтаксис docheck | |
| 391 | + | {$R mybutton.res} | |
| 323 | 392 | ``` | |
| 324 | 393 | ||
| 325 | - | ||
| 394 | + | Установите пакет. | |
| 326 | 395 | ||
| 327 | 396 | ### Скрытие компонента в палитре компонентов | |
| 328 | 397 | ||
| 329 | - | ||
| 330 | - | ||
| 331 | - | ||
| 398 | + | Пакет IDEIntf, модуль componentreg: | |
| 399 | + | ``` | |
| 400 | + | IDEComponentPalette.FindComponent('TButton').Visible:=false; | |
| 401 | + | ``` | |
| 332 | 402 | ||
| 333 | 403 | ## Написание редактора компонента | |
| 334 | 404 | ||
| 335 | - | ||
| 405 | + | Редактор компонента обрабатывает такие вещи, как двойной щелчок по компоненту в конструкторе или добавление пунктов меню при щелчке правой кнопкой мыши по компоненту. Написать редактор компонентов легко. Посмотрите модуль componententeditors.pas пакета IDEIntf для [просмотра] кучи примеров. Например, чтобы показать редактор при двойном щелчке, см. TCheckListBoxComponentEditor. | |
| 336 | 406 | ||
| 337 | 407 | ## Написание редакторов свойств | |
| 338 | 408 | ||
| 339 | - | ||
| 409 | + | Каждый тип свойства (integer, string, TFont, ...) в Инспекторе объектов нуждается в редакторе свойств. Если у вашего компонента есть свойство _Password_ типа string, вы можете определить редактор свойств для вашего конкретного класса компонента со именем свойства _Password_ типа string. Модуль propedits.pp пакета IDEIntf содержит многие стандартные редакторы свойств, используемые самой IDE. Например, TStringPropertyEditor является редактором свойств по умолчанию для всех строк, в то время как TComponentNamePropertyEditor является более конкретным и обрабатывает только TComponent.Name. Смотрите [исходный код] модуля для [получения] множества примеров. | |
| 340 | 410 | ||
| 341 | 411 | ### Сокрытие свойства в инспекторе объектов | |
| 342 | 412 | ||
| 343 | - | ||
| 344 | - | ||
| 345 | - | ||
| 346 | - | ||
| 413 | + | Существует специальный редактор свойств для сокрытия [свойств]: | |
| 347 | 414 | ``` | |
| 415 | + | RegisterPropertyEditor(TypeInfo(TAnchorSide), TControl, 'AnchorSideLeft', THiddenPropertyEditor); | |
| 416 | + | ``` | |
| 348 | 417 | ||
| 349 | 418 | ### Поиск редактора свойств, используемого для свойства | |
| 350 | - | ||
| 351 | - | ||
| 419 | + | ``` | |
| 352 | 420 | uses Classes, TypInfo; | |
| 353 | - | ||
| 354 | - | ||
| 355 | - | ||
| 356 | - | ||
| 357 | - | ||
| 358 | - | ||
| 359 | - | ||
| 360 | - | ||
| 421 | + | var | |
| 422 | + | Instance: TPersistent; // ваш экземпляр | |
| 423 | + | PropInfo: PPropInfo; | |
| 424 | + | EdClass: TPropertyEditorClass; | |
| 425 | + | begin | |
| 426 | + | PropInfo:=GetPropInfo(Instance.ClassType,'Name'); // замените Name именем свойства, которое вы ищете | |
| 427 | + | GetEditorClass(PropInfo, Instance); | |
| 428 | + | end; | |
| 361 | 429 | ``` | |
| 362 | 430 | ||
| 363 | 431 | # Формы | |
| 364 | 432 | ||
| 365 | - | ||
| 366 | - | ||
| 367 | - | ||
| 368 | - | ||
| 369 | - | ||
| 370 | - | ||
| 371 | - | ||
| 372 | - | ||
| 373 | - | ||
| 374 | - | ||
| 375 | - | ||
| 376 | - | ||
| 377 | - | ||
| 378 | - | ||
| 379 | - | ||
| 380 | - | ||
| 381 | - | ||
| 382 | - | ||
| 383 | - | ||
| 384 | - | ||
| 433 | + | IDE позволяет легко создавать потомков форм и фреймов. Эти формы могут иметь новые published-компоненты и новые published-методы. Но, когда вы добавляете новые published-свойства, они не доступны через инспектор объектов. Они работают только во время выполнения [приложения]. Методы в IDE являются поддельными, они не могут быть выполнены. В среде IDE можно создавать компоненты, поскольку их классы зарегистрированы в палитре компонентов. Ваши новые свойства существуют только в вашем исходном коде. IDE пока не может их подделать. Вот почему вы должны зарегистрировать новый класс. Это означает [, что вы должны]: | |
| 385 | 434 | ||
| 386 | - | ||
| 435 | + | * Создать пакет времени разработки (или расширить существующий) | |
| 436 | + | * Ваша форма должна быть в модуле этого пакета | |
| 387 | 437 | ||
| 388 | - | ||
| 389 | - | ||
| 390 | - | ||
| 391 | - | ||
| 438 | + | ``` | |
| 392 | 439 | ... | |
| 440 | + | interface | |
| 441 | + | ||
| 442 | + | uses FormEditingIntf, Forms; | |
| 443 | + | ||
| 444 | + | type | |
| 445 | + | TYourForm = class(TForm) | |
| 446 | + | private | |
| 447 | + | FYourProperty: integer; | |
| 448 | + | published | |
| 449 | + | property YourProperty: integer read FYourProperty write FYourProperty; | |
| 450 | + | end; | |
| 451 | + | ||
| 452 | + | procedure Register; | |
| 453 | + | ||
| 454 | + | implementation | |
| 455 | + | ||
| 456 | + | procedure Register; | |
| 457 | + | begin | |
| 458 | + | FormEditingHook.RegisterDesignerBaseClass(TYourForm); | |
| 459 | + | end; | |
| 460 | + | ... | |
| 393 | 461 | ``` | |
| 394 | 462 | ||
| 395 | - | ||
| 396 | - | ||
| 463 | + | * Проверить [наличие процедуры] "Register" в редакторе пакетов для этого модуля. | |
| 464 | + | * Установить пакет в IDE | |
| 397 | 465 | ||
| 398 | 466 | # Дизайнер | |
| 399 | 467 | ||
| 400 | 468 | ## Написание дизайнера-посредника | |
| 401 | 469 | ||
| 402 | - | ||
| 470 | + | Стандартный конструктор позволяет визуально редактировать элементы управления LCL, тогда как все остальные отображаются в виде значков (например, TOpenDialog или TDataSource). Чтобы визуально редактировать элемент управления не [из библиотеки] LCL, вам нужно создать **designer mediator** (дизайнер-посредник). Он может быть использован для разработки веб-страниц, диаграмм UML или других наборов виджетов, таких как [[fpGUI]]. Полный пример приведен в examples/designnonlcl/. | |
| 403 | 471 | ||
| 404 | - | ||
| 405 | - | ||
| 406 | - | ||
| 472 | + | * Установите пакет с примерами examples/designnonlcl/notlcldesigner.lpk и перезапустите IDE. Это зарегистрирует дизайнер-посредник для компонентов TMyWidget и добавит новые компоненты TMyButton, TMyGroupBox в палитру компонентов. | |
| 473 | + | * Откройте проект с примерами examples/designnonlcl/project/NonLCL1.lpi. | |
| 474 | + | * Откройте unit1.pas и покажите дизайнер форм (F12). Вы должны увидеть компоненты в виде красных прямоугольников, которые можно выделять, перемещать и изменять их размер, как элементы управления LCL. | |
| 407 | 475 | ||
| 408 | 476 | ## Создание нового уникального имени компонента | |
| 409 | - | ||
| 410 | - | ||
| 477 | + | ``` | |
| 411 | 478 | uses FormEditingIntf; | |
| 412 | - | ||
| 413 | - | ||
| 414 | - | ||
| 415 | - | ||
| 416 | - | ||
| 417 | - | ||
| 418 | - | ||
| 419 | - | ||
| 420 | - | ||
| 421 | - | ||
| 479 | + | ||
| 480 | + | ... | |
| 481 | + | ||
| 482 | + | NewName:=FormEditingHook.CreateUniqueComponentName(AComponent); | |
| 483 | + | ||
| 484 | + | // Или, если вам нужно создать имя перед созданием компонента: | |
| 485 | + | ||
| 486 | + | NewName:=FormEditingHook.CreateUniqueComponentName(ComponentClassName,OwnerComponent); | |
| 487 | + | // ComponentClassName будет использоваться в качестве префикса без начального T. | |
| 488 | + | // OwnerComponent является новым владельцем нового компонента. | |
| 422 | 489 | ``` | |
| 423 | 490 | ||
| 424 | 491 | ## Выбор компонента в конструкторе/инспекторе объектов | |
| 425 | - | ||
| 426 | - | ||
| 492 | + | ``` | |
| 427 | 493 | uses propedits; | |
| 428 | - | ||
| 429 | - | ||
| 494 | + | .. | |
| 495 | + | GlobalDesignHook.SelectOnlyThis(AComponent); | |
| 430 | 496 | ``` | |
| 431 | 497 | ||
| 432 | 498 | ## Получение файла модуля, дизайнера формы | |
| 433 | - | ||
| 434 | - | ||
| 499 | + | ``` | |
| 435 | 500 | uses ProjectIntf, LazIDEIntf, ComponentEditors; | |
| 436 | - | ||
| 437 | - | ||
| 438 | - | ||
| 439 | - | ||
| 440 | - | ||
| 441 | - | ||
| 442 | - | ||
| 443 | - | ||
| 444 | - | ||
| 445 | - | ||
| 446 | - | ||
| 501 | + | ... | |
| 502 | + | // открываем файл | |
| 503 | + | if LazarusIDE.DoOpenEditorFile(Filename,-1,-1,[ofAddToRecent])<>mrOk then exit; | |
| 504 | + | // получаем интерфейс файла | |
| 505 | + | aFile:=LazarusIDE.ActiveProject.FindFile(Filename,[]); | |
| 506 | + | // получаем дизайнер | |
| 507 | + | aDesigner:=TComponentEditorDesigner(LazarusIDE.GetDesignerWithProjectFile(AFile,true)); | |
| 508 | + | if aDesigner=nil then | |
| 509 | + | exit; // этот модуль не имеет ресурса (форма, фрейм, модуль данных и т.д.) | |
| 510 | + | // получаем форму | |
| 511 | + | aForm:=aDesigner.Form; | |
| 447 | 512 | ``` | |
| 448 | 513 | ||
| 449 | 514 | ## Сохранение модуля, дизайнера формы | |
| 450 | - | ||
| 451 | - | ||
| 515 | + | ``` | |
| 452 | 516 | uses LazIDEIntf; | |
| 453 | - | ||
| 454 | - | ||
| 517 | + | ... | |
| 518 | + | if LazarusIDE.DoSaveEditorFile(Filename,[])<>mrOk then exit; | |
| 455 | 519 | ``` | |
| 456 | 520 | ||
| 457 | 521 | ## Сохранение формы дизайнера как кода Паскаль | |
| 458 | 522 | ||
| 459 | - | ||
| 523 | + | * Используйте функцию **FormEditingHook.SaveComponentAsPascal** модуля _FormEditingfIntf_. См. _examples/pascalstream/CopyAsPasPkg/copyaspasdemounit1.pas_. | |
| 460 | 524 | ||
| 461 | 525 | # Обработчики событий | |
| 462 | 526 | ||
| 463 | - | ||
| 527 | + | В IDE есть несколько событий, для которых плагины могут добавлять свои собственные обработчики. | |
| 464 | 528 | ||
| 465 | 529 | ## События дизайнера | |
| 466 | 530 | ||
| 467 | - | ||
| 531 | + | В propedits.pp есть объект "GlobalDesignHook", который поддерживает несколько событий для проектирования. Каждое событие вызывает список обработчиков. Обработчики по умолчанию добавляются в среду IDE. Вы можете добавить свои собственные обработчики с помощью методов AddHandlerXXX и RemoveHandlerXXX. Они будут вызваны перед обработчиками по умолчанию. | |
| 468 | 532 | ||
| 469 | - | ||
| 533 | + | Примеры: | |
| 470 | 534 | ||
| 471 | - | ||
| 535 | + | * Добавление вашего обработчика (это обычно делается в конструкторе вашего объекта): | |
| 472 | 536 | ||
| 473 | - | ||
| 537 | + | ``` | |
| 538 | + | GlobalDesignHook.AddHandlerPersistentAdded(@YourOnPersistentAdded); | |
| 539 | + | ``` | |
| 474 | 540 | ||
| 475 | - | ||
| 541 | + | * Удаление вашего обработчика: | |
| 476 | 542 | ||
| 477 | - | ||
| 543 | + | ``` | |
| 544 | + | GlobalDesignHook.RemoveHandlerPersistentAdded(@YourOnPersistentAdded); | |
| 545 | + | ``` | |
| 478 | 546 | ||
| 479 | - | ||
| 547 | + | * Вы можете удалить все обработчики одновременно. Например, это хорошая идея - добавить эту строку в деструктор вашего объекта: | |
| 480 | 548 | ||
| 481 | - | ||
| 549 | + | ``` | |
| 550 | + | GlobalDesignHook.RemoveAllHandlersForObject(Self); | |
| 551 | + | ``` | |
| 482 | 552 | ||
| 483 | - | ||
| 553 | + | Обработчики GlobalDesignHook: | |
| 484 | 554 | ||
| 485 | - | ||
| 486 | - | ||
| 487 | - | ||
| 488 | - | ||
| 489 | - | ||
| 490 | - | ||
| 491 | - | ||
| 492 | - | ||
| 493 | - | ||
| 494 | - | ||
| 495 | - | ||
| 496 | - | ||
| 497 | - | ||
| 498 | - | ||
| 499 | - | ||
| 500 | - | ||
| 501 | - | ||
| 502 | - | ||
| 503 | - | ||
| 504 | - | ||
| 505 | - | ||
| 506 | - | ||
| 507 | - | ||
| 508 | - | ||
| 509 | - | ||
| 510 | - | ||
| 511 | - | ||
| 512 | - | ||
| 513 | - | ||
| 514 | - | ||
| 515 | - | ||
| 516 | - | ||
| 517 | - | ||
| 518 | - | ||
| 555 | + | * Поиск корня | |
| 556 | + | * ChangeLookupRoot - Вызывается при изменении "LookupRoot". "LookupRoot" является объектом-владельцем выбранных компонентов. Обычно это TForm. | |
| 557 | + | * Методы | |
| 558 | + | * CreateMethod | |
| 559 | + | * GetMethodName | |
| 560 | + | * GetMethods | |
| 561 | + | * MethodExists | |
| 562 | + | * RenameMethod | |
| 563 | + | * ShowMethod | |
| 564 | + | * MethodFromAncestor | |
| 565 | + | * ChainCall | |
| 566 | + | * Компоненты | |
| 567 | + | * GetComponent | |
| 568 | + | * GetComponentName | |
| 569 | + | * GetComponentNames | |
| 570 | + | * GetRootClassName | |
| 571 | + | * AddClicked - Вызывается, когда пользователь выбирает класс компонента и щелкает дизайнер, чтобы добавить новый компонент. Вы можете изменить класс компонента и родительский элемент. | |
| 572 | + | * ComponentRenamed - Вызывается, когда компонент был переименован | |
| 573 | + | * Объекты TPersistent | |
| 574 | + | * PersistentAdded - Вызывается при добавлении нового TPersistent в LookupRoot | |
| 575 | + | * PersistentDeleting - Вызывается до освобождения TPersistent. | |
| 576 | + | * DeletePersistent - Вызывается IDE для удаления TPersistent. | |
| 577 | + | * GetSelectedPersistents - Вызывается при получении текущего выбора TPersistent. | |
| 578 | + | * SetSelectedPersistents - Вызывается при настройке текущего выбора TPersistent. | |
| 579 | + | * GetObject | |
| 580 | + | * GetObjectName | |
| 581 | + | * GetObjectNames | |
| 582 | + | * Изменение | |
| 583 | + | * Modified | |
| 584 | + | * Revert | |
| 585 | + | * RefreshPropertyValues | |
| 586 | + | * Выбор | |
| 587 | + | * SetSelection | |
| 588 | + | * GetSelection | |
| 519 | 589 | ||
| 520 | 590 | ### Примеры для событий дизайнера | |
| 521 | 591 | ||
| 522 | - | ||
| 523 | - | ||
| 524 | - | ||
| 525 | - | ||
| 526 | - | ||
| 527 | - | ||
| 528 | - | ||
| 529 | - | ||
| 530 | - | ||
| 531 | - | ||
| 532 | - | ||
| 533 | - | ||
| 534 | - | ||
| 535 | - | ||
| 536 | - | ||
| 537 | - | ||
| 538 | - | ||
| 592 | + | #### Пример: когда [на родителя] помещается новый компонент, перемещать элемент управления в дочерний элемент | |
| 593 | + | ``` | |
| 539 | 594 | ... | |
| 540 | - | ||
| 541 | - | ||
| 542 | - | ||
| 543 | - | ||
| 544 | - | ||
| 545 | - | ||
| 546 | - | ||
| 547 | - | ||
| 548 | - | ||
| 549 | - | ||
| 550 | - | ||
| 551 | - | ||
| 552 | - | ||
| 553 | - | ||
| 554 | - | ||
| 555 | - | ||
| 556 | - | ||
| 557 | - | ||
| 558 | - | ||
| 559 | - | ||
| 560 | - | ||
| 561 | - | ||
| 562 | - | ||
| 563 | - | ||
| 564 | - | ||
| 565 | - | ||
| 566 | - | ||
| 595 | + | type | |
| 596 | + | TYourDesignerExtension = class | |
| 597 | + | private | |
| 598 | + | function AddClicked(ADesigner: TIDesigner; | |
| 599 | + | MouseDownComponent: TComponent; Button: TMouseButton; | |
| 600 | + | Shift: TShiftState; X, Y: Integer; | |
| 601 | + | var AComponentClass: TComponentClass; | |
| 602 | + | var NewParent: TComponent): boolean of object; | |
| 603 | + | public | |
| 604 | + | constructor Create; | |
| 605 | + | destructor Destroy; override; | |
| 606 | + | end; | |
| 607 | + | ||
| 608 | + | ... | |
| 609 | + | constructor TYourDesignerExtension.Create; | |
| 610 | + | begin | |
| 611 | + | // регистрация вашего обработчика | |
| 612 | + | GlobalDesignHook.AddHandlerAddClicked(@AddClicked); | |
| 613 | + | end; | |
| 614 | + | ||
| 615 | + | destructor TYourDesignerExtension.Destroy; | |
| 616 | + | begin | |
| 617 | + | // удаление вашего обработчика | |
| 618 | + | GlobalDesignHook.RemoveHandlerAddClicked(@AddClicked); | |
| 619 | + | end; | |
| 620 | + | ||
| 621 | + | function TYourDesignerExtension.AddClicked(ADesigner: TIDesigner; | |
| 622 | + | MouseDownComponent: TComponent; Button: TMouseButton; | |
| 623 | + | Shift: TShiftState; X, Y: Integer; | |
| 624 | + | var AComponentClass: TComponentClass; | |
| 625 | + | var NewParent: TComponent): boolean of object; | |
| 626 | + | begin | |
| 627 | + | // в этом примере TYourControl - это пользовательский элемент управления с ChildControl. | |
| 628 | + | // Всякий раз, когда пользователь помещает элемент управления на TYourControl, вместо добавления | |
| 629 | + | // нового элемента управления на TYourControl, [этот] новый элемент управления добавляется как дочерний элемент | |
| 630 | + | // [имеющегося] ChildControl. | |
| 631 | + | // создание | |
| 632 | + | if MouseDownComponent is TYourControl then | |
| 633 | + | NewParent:=TYourControl(MouseDownComponent).ChildControl; | |
| 634 | + | Result:=true; | |
| 635 | + | end; | |
| 567 | 636 | ``` | |
| 568 | 637 | ||
| 569 | - | ||
| 570 | - | ||
| 571 | - | ||
| 638 | + | ### Отключение обработчика мыши в [режиме] дизайнера | |
| 572 | 639 | ||
| 573 | - | ||
| 640 | + | Обычно дизайнер ловит все события мыши компонента. Если ваш пользовательский элемент управления должен обрабатывать дескриптор событий мыши, вы можете либо установить **csDesignInteractive** **ControlStyle** , либо вы можете точно управлять им через сообщение _CM_DESIGNHITTEST_ в вашем элементе управления: | |
| 641 | + | ``` | |
| 574 | 642 | type | |
| 575 | - | ||
| 576 | - | ||
| 577 | - | ||
| 578 | - | ||
| 579 | - | ||
| 580 | - | ||
| 581 | - | ||
| 582 | - | ||
| 583 | - | ||
| 584 | - | ||
| 585 | - | ||
| 586 | - | ||
| 587 | - | ||
| 588 | - | ||
| 589 | - | ||
| 590 | - | ||
| 643 | + | TYourControl = class(TCustomControl) | |
| 644 | + | protected | |
| 645 | + | procedure CMDesignHitTest(var Message: TLMessage); message CM_DESIGNHITTEST; | |
| 646 | + | end; | |
| 647 | + | ... | |
| 648 | + | procedure TYourControl.CMDesignHitTest(var Message: TLMessage); | |
| 649 | + | var | |
| 650 | + | p: TSmallPoint; | |
| 651 | + | aShiftState: TShiftState; | |
| 652 | + | begin | |
| 653 | + | aShiftState:=KeysToShiftState(PtrUInt(Message.WParam)); | |
| 654 | + | p:=TSmallPoint(longint(Message.LParam)); | |
| 655 | + | debugln(['TForm1.CMDesignHitTest ShiftState=',dbgs(aShiftState),' x=',p.x,' y=',p.y]); | |
| 656 | + | if SkipDesignerMouseHandler then | |
| 657 | + | Message.Result:=1; // теперь дизайнер вызывает обычные методы MouseUp, MouseMove и MouseDown. | |
| 658 | + | end; | |
| 591 | 659 | ``` | |
| 592 | 660 | ||
| 593 | 661 | ## Получение уведомлений при изменении дизайнера форм | |
| 594 | 662 | ||
| 595 | - | ||
| 596 | - | ||
| 597 | - | ||
| 663 | + | Каждая разработанная форма LCL имеет конструктор типа TIDesigner. В среде IDE создаются конструкторы типа TComponentEditorDesigner, определенные в компонентных компонентах модуля IDEIntf. Например: | |
| 664 | + | ``` | |
| 598 | 665 | procedure TYourAddOn.OnDesignerModified(Sender: TObject); | |
| 599 | - | ||
| 600 | - | ||
| 601 | - | ||
| 602 | - | ||
| 603 | - | ||
| 604 | - | ||
| 605 | - | ||
| 606 | - | ||
| 607 | - | ||
| 608 | - | ||
| 609 | - | ||
| 610 | - | ||
| 611 | - | ||
| 612 | - | ||
| 666 | + | var | |
| 667 | + | IDEDesigner: TComponentEditorDesigner; | |
| 668 | + | begin | |
| 669 | + | IDEDesigner:=TComponentEditorDesigner(Sender); | |
| 670 | + | ... | |
| 671 | + | end; | |
| 672 | + | ||
| 673 | + | procedure TYourAddOn.ConnectDesignerForm(Form1: TCustomForm); | |
| 674 | + | var | |
| 675 | + | IDEDesigner: TComponentEditorDesigner; | |
| 676 | + | begin | |
| 677 | + | IDEDesigner:=TComponentEditorDesigner(Form1.Designer); | |
| 678 | + | IDEDesigner.AddHandlerModified(@OnDesignerModified); | |
| 679 | + | end; | |
| 613 | 680 | ``` | |
| 614 | 681 | ||
| 615 | 682 | ## События проекта | |
| 616 | 683 | ||
| 617 | - | ||
| 684 | + | Эти события определены в модуле LazIDEIntf. | |
| 618 | 685 | ||
| 619 | - | ||
| 620 | - | ||
| 621 | - | ||
| 622 | - | ||
| 623 | - | ||
| 624 | - | ||
| 625 | - | ||
| 626 | - | ||
| 686 | + | * **LazarusIDE.AddHandlerOnProjectClose** : вызывается перед закрытием проекта | |
| 687 | + | * **LazarusIDE.AddHandlerOnProjectOpened** : вызывается после полного открытия проекта (например, все необходимые пакеты были загружены, модули были открыты в редакторе исходного кода) | |
| 688 | + | * **LazarusIDE.AddHandlerOnSavingAll** : вызывается перед тем, как IDE сохраняет все | |
| 689 | + | * **LazarusIDE.AddHandlerOnSavedAll** : вызывается после того, как IDE сохранил все | |
| 690 | + | * **LazarusIDE.AddHandlerOnProjectBuilding** : вызывается перед тем, как IDE создаст проект | |
| 691 | + | * **LazarusIDE.AddHandlerOnProjectDependenciesCompiling** : вызывается перед тем, как IDE компилирует пакетные зависимости проекта | |
| 692 | + | * **LazarusIDE.AddHandlerOnProjectDependenciesCompiled** : вызывается после компиляции зависимостей пакета IDE проекта | |
| 693 | + | * **LazarusIDE.AddHandlerOnProjectBuildingFinished** : вызывается после того, как IDE собрал проект (успешно или нет) (начиная с 1.5) | |
| 627 | 694 | ||
| 628 | 695 | ## Другие события IDE | |
| 629 | 696 | ||
| 630 | - | ||
| 697 | + | **uses** _LazIDEIntf;_ | |
| 631 | 698 | ||
| 632 | - | ||
| 699 | + | Вызовите их в процедуре регистрации вашего пакета: | |
| 633 | 700 | ||
| 634 | - | ||
| 635 | - | ||
| 636 | - | ||
| 637 | - | ||
| 638 | - | ||
| 639 | - | ||
| 640 | - | ||
| 641 | - | ||
| 642 | - | ||
| 643 | - | ||
| 644 | - | ||
| 645 | - | ||
| 701 | + | * **LazarusIDE.AddHandlerOnIDERestoreWindows** : вызывается, когда IDE восстанавливает свои окна (перед открытием первого проекта) | |
| 702 | + | * **LazarusIDE.AddHandlerOnIDEClose** : вызывается, когда IDE закрывается (после запроса закрытия, поэтому больше нет интерактивности) | |
| 703 | + | * **LazarusIDE.AddHandlerOnQuickSyntaxCheck** : вызывается при выполнении пункта меню или ярлыка для быстрой проверки синтаксиса | |
| 704 | + | * **LazarusIDE.AddHandlerOnLazarusBuilding** : вызывается перед тем, как IDE собирает Lazarus IDE (начиная с 1.5) | |
| 705 | + | * **LazarusIDE.AddHandlerOnLazarusBuildingFinished** : вызывается после того, как IDE собирает Lazarus IDE (начиная с 1.5) | |
| 706 | + | * **LazarusIDE.AddHandlerGetFPCFrontEndParams** : вызывается, когда IDE получает параметры клиентского инструмента интерфейса 'fpc' (начиная с 1.5) | |
| 707 | + | * **LazarusIDE.AddHandlerGetFPCFrontEndPath** : вызывается, когда IDE получает параметры клиентского инструмента интерфейса 'fpc' (начиная с 1.5) | |
| 708 | + | * **LazarusIDE.AddHandlerOnUpdateIDEComponentPalette** : ? | |
| 709 | + | * **LazarusIDE.AddHandlerOnUpdateComponentPageControl** : ? | |
| 710 | + | * **LazarusIDE.AddHandlerOnShowDesignerFormOfSource** : вызывается после показа конструктора формы для редактора кода (AEditor может быть nil!) (начиная с 1.5) | |
| 711 | + | * **LazarusIDE.AddHandlerOnShowSourceOfActiveDesignerForm** : вызывается после показа кода формы дизайнера (начиная с 1.5) | |
| 712 | + | * **LazarusIDE.AddHandlerOnChangeToolStatus** : вызывается, когда IDEToolStatus изменяется (например, itNone-> itBuilder и т. д.) (начиная с 1.5) | |
| 646 | 713 | ||
| 647 | - | ||
| 714 | + | Вызовите их в разделе инициализации одного из модулей: | |
| 648 | 715 | ||
| 649 | - | ||
| 650 | - | ||
| 651 | - | ||
| 716 | + | * **AddBootHandler** | |
| 717 | + | * AddBootHandler(**libhTransferMacrosCreated** ,@YourProc): вызывается после создания IDEMacros (начиная с версии 1.3) | |
| 718 | + | * AddBootHandler(**libhEnvironmentOptionsLoaded** ,@YourProc): вызывается после загрузки параметров среды (начиная с версии 1.3) | |
| 652 | 719 | ||
| 653 | 720 | # Проект | |
| 654 | 721 | ||
| 655 | 722 | ## Текущий проект | |
| 656 | 723 | ||
| 657 | - | ||
| 724 | + | Текущий основной проект может быть получен [при помощи] LazarusIDE.ActiveProject. (модуль LazIDEIntf) | |
| 658 | 725 | ||
| 659 | 726 | ## Все модули текущего проекта | |
| 660 | 727 | ||
| 661 | - | ||
| 728 | + | Обратите внимание, что термин «юниты проекта» неоднозначен. | |
| 662 | 729 | ||
| 663 | - | ||
| 664 | - | ||
| 730 | + | * Инспектор проектов показывает список файлов .lpi. Проект может не использовать все эти модули на всех платформах, и, возможно, разработчик забыл добавить все используемые модули. | |
| 731 | + | * Модули из использованных пакетов не являются модулями проекта. | |
| 665 | 732 | ||
| 666 | 733 | ### Все модули инспектора проекта | |
| 667 | 734 | ||
| 668 | - | ||
| 669 | - | ||
| 670 | - | ||
| 735 | + | Чтобы перебрать все паскалевские модули, перечисленные в инспекторе проектов, вы можете использовать, например: | |
| 736 | + | ``` | |
| 671 | 737 | uses | |
| 672 | - | ||
| 673 | - | ||
| 674 | - | ||
| 675 | - | ||
| 676 | - | ||
| 677 | - | ||
| 678 | - | ||
| 679 | - | ||
| 680 | - | ||
| 681 | - | ||
| 682 | - | ||
| 738 | + | LCLProc, FileUtil, LazIDEIntf, ProjectIntf; | |
| 739 | + | ||
| 740 | + | procedure ListProjectUnits; | |
| 741 | + | var | |
| 742 | + | LazProject: TLazProject; | |
| 743 | + | i: Integer; | |
| 744 | + | LazFile: TLazProjectFile; | |
| 683 | 745 | begin | |
| 684 | - | ||
| 685 | - | ||
| 686 | - | ||
| 687 | - | ||
| 688 | - | ||
| 746 | + | LazProject:=LazarusIDE.ActiveProject; | |
| 747 | + | if LazProject<>nil then | |
| 748 | + | for i:=0 to LazProject.FileCount-1 do | |
| 749 | + | begin | |
| 750 | + | LazFile:=LazProject.Files[i]; | |
| 751 | + | if LazFile.IsPartOfProject | |
| 752 | + | and FilenameIsPascalUnit(LazFile.Filename) | |
| 753 | + | then | |
| 754 | + | debugln(LazFile.Filename); | |
| 755 | + | end; | |
| 689 | 756 | end; | |
| 690 | - | ||
| 691 | 757 | ``` | |
| 692 | 758 | ||
| 693 | 759 | ### Все используемые модули проекта | |
| 694 | 760 | ||
| 695 | - | ||
| 696 | - | ||
| 697 | - | ||
| 761 | + | Чтобы найти все используемые в настоящее время модули проекта/пакета, вы можете использовать следующее. Обратите внимание, что в среде IDE необходимо проанализировать все модули, поэтому это может занять некоторое время. | |
| 762 | + | ``` | |
| 698 | 763 | uses | |
| 699 | - | ||
| 700 | - | ||
| 701 | - | ||
| 702 | - | ||
| 703 | - | ||
| 704 | - | ||
| 705 | - | ||
| 706 | - | ||
| 707 | - | ||
| 708 | - | ||
| 709 | - | ||
| 710 | - | ||
| 711 | - | ||
| 712 | - | ||
| 713 | - | ||
| 714 | - | ||
| 764 | + | LazLoggerBase, LazIDEIntf, ProjectIntf; | |
| 765 | + | ||
| 766 | + | procedure ListProjectUnits; | |
| 767 | + | var | |
| 768 | + | LazProject: TLazProject; | |
| 769 | + | i: Integer; | |
| 770 | + | begin | |
| 771 | + | LazProject:=LazarusIDE.ActiveProject; | |
| 772 | + | if LazProject<>nil then | |
| 773 | + | begin | |
| 774 | + | Units:=LazarusIDE.FindUnitsOfOwner(LazProject,[fuooListed,fuooUsed]); // добавьте fuooPackages, чтобы включить модули из пакетов | |
| 775 | + | try | |
| 776 | + | for i:=0 to Units.Count-1 do | |
| 777 | + | debugln('Filename=',Units[i]); | |
| 778 | + | finally | |
| 779 | + | Units.Free; | |
| 780 | + | end; | |
| 781 | + | end; | |
| 715 | 782 | end; | |
| 716 | - | ||
| 717 | - | ||
| 718 | 783 | ``` | |
| 719 | 784 | ||
| 720 | 785 | ## Файлы .lpr, .lpi и .lps проекта | |
| 721 | - | ||
| 722 | - | ||
| 786 | + | ``` | |
| 723 | 787 | uses | |
| 724 | - | ||
| 725 | - | ||
| 726 | - | ||
| 727 | - | ||
| 728 | - | ||
| 729 | - | ||
| 730 | - | ||
| 731 | - | ||
| 732 | - | ||
| 733 | - | ||
| 734 | - | ||
| 735 | - | ||
| 736 | - | ||
| 737 | - | ||
| 738 | - | ||
| 739 | - | ||
| 740 | - | ||
| 788 | + | LCLProc, FileUtil, ProjectIntf, LazIDEIntf; | |
| 789 | + | var | |
| 790 | + | LazProject: TLazProject; | |
| 791 | + | begin | |
| 792 | + | LazProject:=LazarusIDE.ActiveProject; | |
| 793 | + | // у каждого проекта есть файл .lpi: | |
| 794 | + | DebugLn(['Файл проекта lpi: ',LazProject.ProjectInfoFile]); | |
| 795 | + | ||
| 796 | + | // если информация о сеансе проекта хранится в отдельном файле .lps: | |
| 797 | + | if LazProject.SessionStorage<>pssNone then | |
| 798 | + | DebugLn(['Файл проекта lps: ',LazProject.ProjectSessionFile]); | |
| 799 | + | ||
| 800 | + | // Если у проекта есть файл .lpr, то он является основным исходным файлом: | |
| 801 | + | if (LazProject.MainFile<>nil) | |
| 802 | + | and (CompareFileExt(LazProject.MainFile.Filename,'lpr')=0) then | |
| 803 | + | DebugLn(['Проект имеет файл lpr: ',LazProject.MainFile.Filename]); | |
| 804 | + | end; | |
| 741 | 805 | ``` | |
| 742 | 806 | ||
| 743 | 807 | ## Имя исполняемого / целевого файла проекта | |
| 744 | 808 | ||
| 745 | - | ||
| 746 | - | ||
| 747 | - | ||
| 809 | + | Существует макрос $(TargetFile), который можно использовать в путях и внешних инструментах. Вы можете запросить макрос в коде: | |
| 810 | + | ``` | |
| 748 | 811 | uses MacroIntf; | |
| 749 | - | ||
| 750 | - | ||
| 751 | - | ||
| 752 | - | ||
| 753 | - | ||
| 754 | - | ||
| 755 | - | ||
| 812 | + | ||
| 813 | + | function MyGetProjectTargetFile: string; | |
| 814 | + | begin | |
| 815 | + | Result:='$(TargetFile)'; | |
| 816 | + | if not IDEMacros.SubstituteMacros(Result) then | |
| 817 | + | raise Exception.Create('невозможно получить целевой файл проекта'); | |
| 818 | + | end; | |
| 756 | 819 | ``` | |
| 757 | 820 | ||
| 758 | - | ||
| 821 | + | См. здесь для более полной информации по макросам: [[IDE Macros in paths and filenames/ru|Макросы IDE в путях и именах файлов]]. | |
| 759 | 822 | ||
| 760 | 823 | ## Добавление своего собственного типа проекта | |
| 761 | 824 | ||
| 762 | - | ||
| 825 | + | Вы можете добавлять [свои] пункты в диалоговое окно 'New ...': | |
| 763 | 826 | ||
| 764 | - | ||
| 765 | - | ||
| 827 | + | * Смотрите модуль ProjectIntf пакета IDEIntf. | |
| 828 | + | * См. [[Project Templates/ru|Шаблоны проекта]] | |
| 766 | 829 | ||
| 767 | 830 | ## Добавление своих собственных типов файлов | |
| 768 | 831 | ||
| 769 | - | ||
| 832 | + | Вы можете добавлять [свои] пункты в диалоговое окно 'New ...': | |
| 770 | 833 | ||
| 771 | - | ||
| 772 | - | ||
| 834 | + | * Смотрите модуль ProjectIntf пакета IDEIntf. | |
| 835 | + | * Выбрав базовый класс TFileDescPascalUnit для обычных модулей или TFileDescPascalUnitWithResource для новой формы/модуля данных. | |
| 773 | 836 | ||
| 774 | 837 | ### Добавление нового типа файла | |
| 775 | - | ||
| 776 | - | ||
| 838 | + | ``` | |
| 777 | 839 | uses ProjectIntf; | |
| 778 | - | ||
| 779 | - | ||
| 780 | - | ||
| 781 | - | ||
| 782 | - | ||
| 783 | - | ||
| 784 | - | ||
| 785 | - | ||
| 786 | - | ||
| 787 | - | ||
| 788 | - | ||
| 789 | - | ||
| 790 | - | ||
| 791 | - | ||
| 792 | - | ||
| 793 | - | ||
| 794 | - | ||
| 795 | - | ||
| 796 | - | ||
| 797 | - | ||
| 798 | - | ||
| 799 | - | ||
| 800 | - | ||
| 801 | - | ||
| 802 | - | ||
| 803 | - | ||
| 804 | - | ||
| 805 | - | ||
| 806 | - | ||
| 807 | - | ||
| 808 | - | ||
| 809 | - | ||
| 810 | - | ||
| 811 | - | ||
| 812 | - | ||
| 813 | - | ||
| 814 | - | ||
| 815 | - | ||
| 816 | - | ||
| 840 | + | ... | |
| 841 | + | { TFileDescText } | |
| 842 | + | ||
| 843 | + | TFileDescMyText = class(TProjectFileDescriptor) | |
| 844 | + | public | |
| 845 | + | constructor Create; override; | |
| 846 | + | function GetLocalizedName: string; override; | |
| 847 | + | function GetLocalizedDescription: string; override; | |
| 848 | + | end; | |
| 849 | + | ... | |
| 850 | + | ||
| 851 | + | procedure Register; | |
| 852 | + | ||
| 853 | + | implementation | |
| 854 | + | ||
| 855 | + | procedure Register; | |
| 856 | + | begin | |
| 857 | + | RegisterProjectFileDescriptor(TFileDescMyText.Create,FileDescGroupName); | |
| 858 | + | end; | |
| 859 | + | ||
| 860 | + | { TFileDescMyText } | |
| 861 | + | ||
| 862 | + | constructor TFileDescMyText.Create; | |
| 863 | + | begin | |
| 864 | + | inherited Create; | |
| 865 | + | Name:='MyText'; // не переводите эту [строку] | |
| 866 | + | DefaultFilename:='text.txt'; | |
| 867 | + | AddToProject:=false; | |
| 868 | + | end; | |
| 869 | + | ||
| 870 | + | function TFileDescText.GetLocalizedName: string; | |
| 871 | + | begin | |
| 872 | + | Result:='My Text'; // замените это строкой из resourcestring | |
| 873 | + | end; | |
| 874 | + | ||
| 875 | + | function TFileDescText.GetLocalizedDescription: string; | |
| 876 | + | begin | |
| 877 | + | Result:='Пустой текстовый файл'; | |
| 878 | + | end; | |
| 817 | 879 | ``` | |
| 818 | 880 | ||
| 819 | 881 | ### Добавление нового типа формы | |
| 820 | - | ||
| 821 | - | ||
| 882 | + | ``` | |
| 822 | 883 | uses ProjectIntf; | |
| 823 | - | ||
| 824 | - | ||
| 825 | - | ||
| 826 | - | ||
| 827 | - | ||
| 828 | - | ||
| 829 | - | ||
| 830 | - | ||
| 831 | - | ||
| 832 | - | ||
| 833 | - | ||
| 834 | - | ||
| 835 | - | ||
| 836 | - | ||
| 837 | - | ||
| 838 | - | ||
| 839 | - | ||
| 840 | - | ||
| 841 | - | ||
| 842 | - | ||
| 843 | - | ||
| 844 | - | ||
| 845 | - | ||
| 846 | - | ||
| 847 | - | ||
| 848 | - | ||
| 849 | - | ||
| 850 | - | ||
| 851 | - | ||
| 852 | - | ||
| 853 | - | ||
| 854 | - | ||
| 855 | - | ||
| 856 | - | ||
| 857 | - | ||
| 858 | - | ||
| 859 | - | ||
| 860 | - | ||
| 861 | - | ||
| 862 | - | ||
| 863 | - | ||
| 864 | - | ||
| 865 | - | ||
| 866 | - | ||
| 884 | + | ||
| 885 | + | ... | |
| 886 | + | TFileDescPascalUnitWithMyForm = class(TFileDescPascalUnitWithResource) | |
| 887 | + | public | |
| 888 | + | constructor Create; override; | |
| 889 | + | function GetInterfaceUsesSection: string; override; | |
| 890 | + | function GetLocalizedName: string; override; | |
| 891 | + | function GetLocalizedDescription: string; override; | |
| 892 | + | end; | |
| 893 | + | ... | |
| 894 | + | ||
| 895 | + | procedure Register; | |
| 896 | + | ||
| 897 | + | implementation | |
| 898 | + | ||
| 899 | + | procedure Register; | |
| 900 | + | begin | |
| 901 | + | RegisterProjectFileDescriptor(TFileDescPascalUnitWithMyForm.Create,FileDescGroupName); | |
| 902 | + | end; | |
| 903 | + | ||
| 904 | + | { TFileDescPascalUnitWithMyForm } | |
| 905 | + | ||
| 906 | + | constructor TFileDescPascalUnitWithMyForm.Create; | |
| 907 | + | begin | |
| 908 | + | inherited Create; | |
| 909 | + | Name:='MyForm'; // не переводите эту [строку] | |
| 910 | + | ResourceClass:=TMyForm; | |
| 911 | + | UseCreateFormStatements:=true; | |
| 912 | + | end; | |
| 913 | + | ||
| 914 | + | function TFileDescPascalUnitWithMyForm.GetInterfaceUsesSection: string; | |
| 915 | + | begin | |
| 916 | + | Result:='Classes, SysUtils, MyWidgetSet'; | |
| 917 | + | end; | |
| 918 | + | ||
| 919 | + | function TFileDescPascalUnitWithForm.GetLocalizedName: string; | |
| 920 | + | begin | |
| 921 | + | Result:='MyForm'; // замените это строкой из resourcestring | |
| 922 | + | end; | |
| 923 | + | ||
| 924 | + | function TFileDescPascalUnitWithForm.GetLocalizedDescription: string; | |
| 925 | + | begin | |
| 926 | + | Result:='Создать новую MyForm из примера пакета NotLCLDesigner'; | |
| 927 | + | end; | |
| 867 | 928 | ``` | |
| 868 | 929 | ||
| 869 | - | ||
| 870 | - | ||
| 871 | - | ||
| 930 | + | ## Сохранение пользовательских значений в [файлах] lpi/lps | |
| 872 | 931 | ||
| 873 | - | ||
| 874 | - | ||
| 932 | + | Вы можете хранить свои собственные данные с помощью пар имя/значение в CustomData и CustomSessionData. | |
| 933 | + | ``` | |
| 934 | + | LazarusIDE.ActiveProject.CustomData['Name']:=Value; // хранится в lpi - x-platform, общие данные | |
| 935 | + | LazarusIDE.ActiveProject.CustomSessionData['Name']:=Value; // хранится в lpi - x-platform, общие данные | |
| 936 | + | ``` | |
| 875 | 937 | ||
| 876 | 938 | # Пакеты | |
| 877 | 939 | ||
| 878 | - | ||
| 940 | + | Вы можете выполнять различные действия с [[Lazarus Packages/ru|пакетами]]: | |
| 879 | 941 | ||
| 880 | 942 | ## Поиск во всех пакетах | |
| 881 | 943 | ||
| 882 | - | ||
| 883 | - | ||
| 884 | - | ||
| 944 | + | Переберите все пакеты, загруженные в IDE (начиная с 0.9.29). | |
| 945 | + | ``` | |
| 885 | 946 | uses PackageIntf; | |
| 886 | - | ||
| 887 | - | ||
| 888 | - | ||
| 947 | + | ... | |
| 948 | + | for i:=0 to PackageEditingInterface.GetPackageCount-1 do | |
| 949 | + | writeln(PackageEditingInterface.GetPackages(i).Name); | |
| 889 | 950 | ``` | |
| 890 | 951 | ||
| 891 | - | ||
| 892 | - | ||
| 893 | - | ||
| 952 | + | ## Поиск в пакетах с [определенным] именем | |
| 953 | + | ``` | |
| 894 | 954 | uses PackageIntf; | |
| 895 | - | ||
| 896 | - | ||
| 897 | - | ||
| 898 | - | ||
| 899 | - | ||
| 900 | - | ||
| 901 | 955 | ... | |
| 902 | - | ||
| 956 | + | var | |
| 957 | + | Pkg: TIDEPackage; | |
| 958 | + | begin | |
| 959 | + | Pkg:=PackageEditingInterface.FindPackageWithName('LCL'); | |
| 960 | + | if Pkg<>nil then | |
| 961 | + | ... | |
| 962 | + | end; | |
| 903 | 963 | ``` | |
| 904 | 964 | ||
| 905 | - | ||
| 965 | + |  **Примечание:** FindPackageWithName не открывает редактор пакетов. Для этого используйте DoOpenPackageWithName. | |
| 906 | 966 | ||
| 907 | 967 | ## Получение имени файла lpk установленного пакета | |
| 908 | - | ||
| 909 | - | ||
| 968 | + | ``` | |
| 910 | 969 | uses PackageIntf; | |
| 911 | - | ||
| 912 | - | ||
| 913 | - | ||
| 914 | - | ||
| 915 | - | ||
| 916 | - | ||
| 917 | - | ||
| 918 | - | ||
| 970 | + | ... | |
| 971 | + | var | |
| 972 | + | Pkg: TIDEPackage; | |
| 973 | + | begin | |
| 974 | + | Pkg:=PackageEditingInterface.FindPackageWithName('LCL'); | |
| 975 | + | if Pkg<>nil then | |
| 976 | + | LPKFilename:=Pkg.Filename; | |
| 977 | + | end; | |
| 919 | 978 | ``` | |
| 920 | 979 | ||
| 921 | 980 | ## Установка пакетов | |
| 922 | 981 | ||
| 923 | - | ||
| 924 | - | ||
| 925 | - | ||
| 982 | + |  **Примечание:** Устанавливайте только пакеты с плагинами IDE. Установка других пакетов может привести к нестабильной работе среды IDE. | |
| 983 | + | ``` | |
| 926 | 984 | uses PackageIntf, contnrs; | |
| 927 | - | ||
| 928 | - | ||
| 929 | - | ||
| 930 | - | ||
| 931 | - | ||
| 932 | - | ||
| 933 | - | ||
| 934 | - | ||
| 935 | - | ||
| 936 | - | ||
| 937 | - | ||
| 938 | - | ||
| 939 | - | ||
| 940 | - | ||
| 941 | - | ||
| 942 | - | ||
| 943 | - | ||
| 985 | + | ... | |
| 986 | + | PkgList:=TObjectList.create(true); | |
| 987 | + | try | |
| 988 | + | Pkg:=TLazPackageID.Create; | |
| 989 | + | Pkg.Name:='Cody'; | |
| 990 | + | PkgList.Add(Pkg); | |
| 991 | + | // проверьте, может ли IDE найти cody.lpk и все зависимости | |
| 992 | + | // Среда IDE покажет некоторые предупреждения/подтверждения, если что-то выглядит странно. | |
| 993 | + | if not PackageEditingInterface.CheckInstallPackageList(PkgList,[]) then | |
| 994 | + | exit; | |
| 995 | + | // в этом примере мы [это] уже проверили, поэтому пропустите предупреждения | |
| 996 | + | // и пересоберите IDE | |
| 997 | + | if PackageEditingInterface.InstallPackages(PkgList,[piiifSkipChecks,piiifRebuildIDE])<>mrOK then | |
| 998 | + | exit; | |
| 999 | + | finally | |
| 1000 | + | PkgList.Free; | |
| 1001 | + | end; | |
| 944 | 1002 | ``` | |
| 945 | 1003 | ||
| 946 | 1004 | ## Открытие файла пакета (lpk) | |
| 947 | - | ||
| 948 | - | ||
| 1005 | + | ``` | |
| 949 | 1006 | uses PackageIntf, FileUtil; | |
| 950 | - | ||
| 951 | - | ||
| 952 | - | ||
| 953 | - | ||
| 954 | - | ||
| 955 | - | ||
| 956 | - | ||
| 957 | - | ||
| 958 | - | ||
| 1007 | + | ... | |
| 1008 | + | var | |
| 1009 | + | pkg: TIDEPackage; | |
| 1010 | + | begin | |
| 1011 | + | if PackageEditingInterface.DoOpenPackageFile(LPKFilename,[pofAddToRecent],false)<>mrOk then | |
| 1012 | + | exit; | |
| 1013 | + | Pkg:=PackageEditingInterface.FindPackageWithName(ExtractFilenameOnly(LPKFilename)); | |
| 1014 | + | ... | |
| 1015 | + | end; | |
| 959 | 1016 | ``` | |
| 960 | 1017 | ||
| 961 | - | ||
| 1018 | + | [](</File:Warning-icon.png>) | |
| 962 | 1019 | ||
| 963 | - | ||
| 1020 | + | **Предупреждение:** Среда IDE автоматически закрывает неиспользуемые пакеты в режиме ожидания. Никогда не храните ссылку на TIDEPackage. | |
| 964 | 1021 | ||
| 965 | - | ||
| 1022 | + | ## Поиск пакета(-ов) модуля | |
| 966 | 1023 | ||
| 967 | - | ||
| 1024 | + | У вас есть имя файла модуля, например '/home/user/unit.pas', и [если] вы хотите знать, какому пакету(-ам) и проекту(-ам) он принадлежит, используйте это: | |
| 1025 | + | ``` | |
| 968 | 1026 | uses Classes, PackageIntf, ProjectIntf; | |
| 969 | - | ||
| 970 | - | ||
| 971 | - | ||
| 972 | - | ||
| 973 | - | ||
| 974 | - | ||
| 975 | - | ||
| 976 | - | ||
| 977 | - | ||
| 978 | - | ||
| 979 | - | ||
| 980 | - | ||
| 981 | - | ||
| 982 | - | ||
| 983 | - | ||
| 984 | - | ||
| 985 | - | ||
| 986 | - | ||
| 987 | - | ||
| 988 | - | ||
| 989 | - | ||
| 990 | - | ||
| 991 | - | ||
| 1027 | + | ... | |
| 1028 | + | var | |
| 1029 | + | Owners: TFPList; | |
| 1030 | + | i: Integer; | |
| 1031 | + | o: TObject; | |
| 1032 | + | begin | |
| 1033 | + | Owners:=PackageEditingInterface.GetPossibleOwnersOfUnit('/full/path/of/unit.pas',[]); | |
| 1034 | + | if Owners=nil then begin | |
| 1035 | + | // модуль не связан напрямую с проектом/пакетом | |
| 1036 | + | // возможно модуль был по какой-то причине не добавлен, но доступен | |
| 1037 | + | // поиск по всем путям модулей всех проектов/пакетов | |
| 1038 | + | // Осторожно: это может привести к ложным попаданиям | |
| 1039 | + | Owners:=PackageEditingInterface.GetPossibleOwnersOfUnit('/full/path/of/unit.pas', | |
| 1040 | + | [piosfExcludeOwned,piosfIncludeSourceDirectories]); | |
| 992 | 1041 | end; | |
| 993 | - | ||
| 994 | - | ||
| 995 | - | ||
| 996 | - | ||
| 1042 | + | if Owners=nil then exit; | |
| 1043 | + | try | |
| 1044 | + | for i:=0 to Owners.Count-1 do begin | |
| 1045 | + | o:=TObject(Owners[i]); | |
| 1046 | + | if o is TIDEPackage then begin | |
| 1047 | + | writeln('Owner is package ',TIDEPackage(o).Name); | |
| 1048 | + | end else if o is TLazProject then begin | |
| 1049 | + | writeln('Owner is project ',TLazProject(o).ProjectInfoFile); | |
| 1050 | + | end; | |
| 1051 | + | end; | |
| 1052 | + | finally | |
| 1053 | + | Owners.Free; | |
| 1054 | + | end; | |
| 997 | 1055 | ``` | |
| 998 | 1056 | ||
| 999 | 1057 | # Окна | |
| 1000 | 1058 | ||
| 1001 | - | ||
| 1059 | + | Есть четыре основных типа окон IDE. | |
| 1002 | 1060 | ||
| 1003 | - | ||
| 1004 | - | ||
| 1005 | - | ||
| 1006 | - | ||
| 1061 | + | * основная панель IDE - это Application.MainForm. Оно всегда присутствует. | |
| 1062 | + | * плавающие / закрепляемые окна, такие как Редактор исходного кода, Инспекторы объектов и Сообщения. | |
| 1063 | + | * модальные формы, такие как диалог поиска, диалоги настроек и вопросы. | |
| 1064 | + | * подсказки и заполнение форм | |
| 1007 | 1065 | ||
| 1008 | 1066 | ## Добавление нового закрепляемого окна IDE | |
| 1009 | 1067 | ||
| 1010 | - | ||
| 1068 | + | Что такое закрепляемое окно IDE: Окна, такие как Редактор исходного кода или Инспектор объектов, являются плавающими окнами, которые можно закрепить, если установлен пакет закрепления, а его состояние, положение и размер сохраняются и восстанавливаются при следующем запуске IDE. Для восстановления окна IDE нужен создатель, как определено в модуле **IDEWindowIntf** пакета IDEIntf. Каждое закрепляемое окно должно иметь уникальное имя. Не используйте общие имена, такие как 'FileBrowser', потому что это будет легко конфликтовать с другими пакетами. И не используйте короткие имена, такие как 'XYZ', потому что создатель отвечает за все формы, начинающиеся с этого имени. | |
| 1011 | 1069 | ||
| 1012 | 1070 | ### Как зарегистрировать закрепляемое окно IDE | |
| 1013 | 1071 | ||
| 1014 | - | ||
| 1015 | - | ||
| 1016 | - | ||
| 1072 | + | Не забудьте выбрать длинное уникальное имя, которое является действительным идентификатором Паскаля. Ваше окно может иметь любой заголовок, который вы хотите. | |
| 1073 | + | ``` | |
| 1017 | 1074 | uses SysUtils, IDEWindowIntf; | |
| 1018 | - | ||
| 1019 | - | ||
| 1020 | - | ||
| 1021 | - | ||
| 1022 | - | ||
| 1023 | - | ||
| 1024 | - | ||
| 1025 | - | ||
| 1026 | - | ||
| 1027 | - | ||
| 1028 | - | ||
| 1029 | - | ||
| 1030 | - | ||
| 1031 | - | ||
| 1032 | - | ||
| 1033 | - | ||
| 1034 | - | ||
| 1035 | - | ||
| 1036 | - | ||
| 1037 | - | ||
| 1075 | + | ... | |
| 1076 | + | var MyIDEWindow: TMyIDEWindow = nil; | |
| 1077 | + | ||
| 1078 | + | procedure CreateMyIDEWindow(Sender: TObject; aFormName: string; var AForm: TCustomForm; DoDisableAutoSizing: boolean); | |
| 1079 | + | begin | |
| 1080 | + | // проверяем имя | |
| 1081 | + | if CompareText(aFormName,MyIDEWindowName)<>0 then exit; | |
| 1082 | + | // создаем форму, если это еще не сделано, и отключаем автомасштабирование | |
| 1083 | + | IDEWindowCreators.CreateForm(MyIDEWindow,TMyIDEWindowm,DoDisableAutosizing,Application); | |
| 1084 | + | ... инициируем окно ... | |
| 1085 | + | AForm:=MyIDEWindow; | |
| 1086 | + | end; | |
| 1087 | + | ||
| 1088 | + | procedure Register; | |
| 1089 | + | begin | |
| 1090 | + | IDEWindowCreators.Add('MyIDEWindow',@CreateMyIDEWindow,nil,'100','50%','+300','+20%'); | |
| 1091 | + | // стандартная граница формы - это: | |
| 1092 | + | // Left=100, Top=50% от [величины] Screen.Height, Width=300, Height=20% от [величины] Screen.Height | |
| 1093 | + | // когда IDE требуется экземпляр этого окна, она вызывает процедуру CreateMyIDEWindow. | |
| 1094 | + | end; | |
| 1038 | 1095 | ``` | |
| 1039 | 1096 | ||
| 1040 | 1097 | ### Отображение окна IDE | |
| 1041 | 1098 | ||
| 1042 | - | ||
| 1099 | + | [](</File:Warning-icon.png>) | |
| 1043 | 1100 | ||
| 1044 | - | ||
| 1101 | + | **Предупреждение:** Не используйте [процедуру] Show. | |
| 1045 | 1102 | ||
| 1046 | - | ||
| 1103 | + | Используйте: | |
| 1104 | + | ``` | |
| 1047 | 1105 | IDEWindowCreators.ShowForm(MyIDEWindow,false); | |
| 1048 | 1106 | ``` | |
| 1049 | 1107 | ||
| 1050 | - | ||
| 1108 | + | Это будет работать с [механизмом] пристыковки. Система пристыковки может обернуть форму в стыковочный узел. Параметр BringToFront указывает системе закрепления сделать форму и все ее родительские сайты видимыми и вывести сайт верхнего уровня вперед. | |
| 1051 | 1109 | ||
| 1052 | 1110 | ### Заметки о IDEWindowCreators и SimpleLayoutStorage | |
| 1053 | 1111 | ||
| 1054 | - | ||
| 1112 | + | IDEWindowCreators.SimpleLayoutStorage просто хранит BoundsRect и WindowState всех форм, которые когда-то были открыты. Он используется как запасной вариант, если не установлен док-мастер. Он сохраняет состояние, даже если установлен DockMaster, поэтому, когда dockmaster удален, границы форм восстанавливаются. | |
| 1055 | 1113 | ||
| 1056 | - | ||
| 1114 | + | IDEWindowCreators используется всеми присоединяемыми формами для регистрации и отображения форм. При показе формы Создатель проверяет, установлен ли IDEDockMaster, и передает ему отображение. Если IDEDockMaster не установлен, он просто показывает форму. IDEDockMaster может использовать информацию в IDEWindowCreators для создания форм по именам и получить представление о том, где разместить форму при ее первом отображении. Для более подробной информации смотрите пакеты AnchorDockingDsgn и EasyDockMgDsgn. | |
| 1057 | 1115 | ||
| 1058 | 1116 | # CodeTools | |
| 1059 | 1117 | ||
| 1060 | - | ||
| 1061 | - | ||
| 1062 | - | ||
| 1118 | + | CodeTools - это пакет, предоставляющий огромное количество функций для анализа, поиска и изменения исходных текстов, а также некоторые основные функции для других языков. Вы можете использовать их также и без IDE. Рекомендуется сначала прочитать о CodeTools в целом, прежде чем использовать их в IDE: [[Codetools]]. | |
| 1063 | 1119 | ||
| 1064 | - | ||
| 1120 | + | Перед вызовом любой из функций CodeTools в IDE вы должны зафиксировать текущие изменения редактора исходного кода в буферах CodeTools: | |
| 1121 | + | ``` | |
| 1065 | 1122 | uses LazIDEIntf; | |
| 1066 | - | ||
| 1067 | - | ||
| 1068 | - | ||
| 1123 | + | ... | |
| 1124 | + | // сохраняем изменения в редакторе исходного кода в codetools | |
| 1125 | + | LazarusIDE.SaveSourceEditorChangesToCodeCache(-1); // -1: фиксируем все редакторы исходного кода | |
| 1069 | 1126 | ``` | |
| 1070 | 1127 | ||
| 1071 | 1128 | ## Добавление директивы ресурса в файл | |
| 1072 | 1129 | ||
| 1073 | - | ||
| 1074 | - | ||
| 1075 | - | ||
| 1130 | + | Это добавляет {$R example.res} к модулю паскаля: | |
| 1131 | + | ``` | |
| 1076 | 1132 | procedure AddResourceDirectiveToPascalSource(const Filename: string); | |
| 1077 | - | ||
| 1078 | - | ||
| 1079 | - | ||
| 1080 | - | ||
| 1081 | - | ||
| 1082 | - | ||
| 1083 | - | ||
| 1084 | - | ||
| 1085 | - | ||
| 1086 | - | ||
| 1087 | - | ||
| 1088 | - | ||
| 1089 | - | ||
| 1090 | - | ||
| 1091 | - | ||
| 1092 | - | ||
| 1093 | - | ||
| 1133 | + | var | |
| 1134 | + | ExpandedFilename: String; | |
| 1135 | + | CodeBuf: TCodeBuffer; | |
| 1136 | + | begin | |
| 1137 | + | // убеждаемся, что имя файла обрезано [от концевых пробелов] и содержит полный путь | |
| 1138 | + | ExpandedFilename:=CleanAndExpandFilename(Filename); | |
| 1139 | + | ||
| 1140 | + | // сохраняем изменения в редакторе исходного кода в codetools | |
| 1141 | + | LazarusIDE.SaveSourceEditorChangesToCodeCache(-1); | |
| 1142 | + | ||
| 1143 | + | // загружаем файл | |
| 1144 | + | CodeBuf:=CodeToolBoss.LoadFile(ExpandedFilename,true,false); | |
| 1145 | + | ||
| 1146 | + | // добавляем директиву ресурса | |
| 1147 | + | if not CodeToolBoss.AddResourceDirective(CodeBuf,'example.res') then | |
| 1148 | + | LazarusIDE.DoJumpToCodeToolBossError; | |
| 1149 | + | end; | |
| 1094 | 1150 | ``` | |
| 1095 | 1151 | ||
| 1096 | - | ||
| 1152 | + | Codetools также предоставляет такие функции, как FindResourceDirective и RemoveDirective. | |
| 1097 | 1153 | ||
| 1098 | 1154 | ## Получение путей поиска для модулей и включаемых файлов | |
| 1099 | 1155 | ||
| 1100 | - | ||
| 1101 | - | ||
| 1102 | - | ||
| 1156 | + | В среде IDE существует множество различных путей поиска из проектов, пакетов, каталога fpc и lazarus, и существует множество типов путей: до или после разрешения макросов, с унаследованными путями поиска или без них, как относительными или абсолютными путями. Все файлы в каталоге имеют одинаковый набор путей поиска. Вы можете получить пути поиска для каждого каталога, полностью решенного путем запроса codetools: | |
| 1157 | + | ``` | |
| 1103 | 1158 | uses CodeToolManager; | |
| 1104 | - | ||
| 1105 | - | ||
| 1106 | - | ||
| 1107 | - | ||
| 1108 | - | ||
| 1109 | - | ||
| 1110 | - | ||
| 1111 | - | ||
| 1112 | - | ||
| 1113 | - | ||
| 1114 | - | ||
| 1115 | - | ||
| 1116 | - | ||
| 1117 | - | ||
| 1118 | - | ||
| 1119 | - | ||
| 1120 | - | ||
| 1159 | + | ... | |
| 1160 | + | ||
| 1161 | + | Dir:=''; // пустой каталог для новых файлов и имеет те же настройки, что и каталог проекта | |
| 1162 | + | ||
| 1163 | + | // Получение путей поиска для включаемых файлов: | |
| 1164 | + | Path:=CodeToolBoss.GetIncludePathForDirectory(Dir); | |
| 1165 | + | ||
| 1166 | + | // Получение путей поиска для модулей: | |
| 1167 | + | // Этот путь поиска передается компилятору. | |
| 1168 | + | // Он содержит выходные каталоги пакетов, но не каталоги с исходниками пакетов. | |
| 1169 | + | Path:=CodeToolBoss.GetUnitPathForDirectory(Dir); | |
| 1170 | + | ||
| 1171 | + | // Могут быть дополнительные пути поиска модулей только для IDE (не передаются компилятору) | |
| 1172 | + | Path:=CodeToolBoss.GetSrcPathForDirectory(Dir); | |
| 1173 | + | ||
| 1174 | + | // Полный путь поиска содержит также все исходные пути пакета для модулей: | |
| 1175 | + | Path:=CodeToolBoss.GetCompleteSrcPathForDirectory(Dir); | |
| 1121 | 1176 | ``` | |
| 1122 | 1177 | ||
| 1123 | 1178 | # Редактор исходного кода | |
| 1124 | 1179 | ||
| 1125 | 1180 | ## Активный редактор исходного кода | |
| 1126 | - | ||
| 1127 | - | ||
| 1181 | + | ``` | |
| 1128 | 1182 | uses SrcEditorIntf; | |
| 1129 | - | ||
| 1130 | - | ||
| 1131 | - | ||
| 1132 | - | ||
| 1133 | - | ||
| 1134 | - | ||
| 1183 | + | ... | |
| 1184 | + | Editor:=SourceEditorManagerIntf.ActiveEditor; | |
| 1185 | + | if Editor=nil then exit; | |
| 1186 | + | Filename:=Editor.FileName; | |
| 1187 | + | ScreenPos:=Editor.CursorScreenXY; | |
| 1188 | + | TextPos:=Editor.CursorTextXY; | |
| 1135 | 1189 | ``` | |
| 1136 | 1190 | ||
| 1137 | 1191 | # SynEdit | |
| 1138 | 1192 | ||
| 1139 | 1193 | ## Получение настроек для TSynEdit | |
| 1140 | 1194 | ||
| 1141 | - | ||
| 1142 | - | ||
| 1143 | - | ||
| 1195 | + | Если у вас есть диалог с использованием TSynEdit, и вы хотите использовать тот же шрифт и настройки, которые использует редактор исходного кода: | |
| 1196 | + | ``` | |
| 1144 | 1197 | uses SrcEditorIntf; | |
| 1145 | - | ||
| 1146 | - | ||
| 1198 | + | ... | |
| 1199 | + | SourceEditorManagerIntf.GetEditorControlSettings(ASynEdit); | |
| 1147 | 1200 | ``` | |
| 1148 | 1201 | ||
| 1149 | 1202 | ## Получение настроек для подсветки SynEdit | |
| 1150 | 1203 | ||
| 1151 | - | ||
| 1152 | - | ||
| 1153 | - | ||
| 1204 | + | Если у вас есть диалог, использующий TSynEdit с подсветкой, и вы хотите использовать те же цвета, что и для подсветки редактора исходного кода для этого языка, используйте: | |
| 1205 | + | ``` | |
| 1154 | 1206 | uses SrcEditorIntf; | |
| 1155 | - | ||
| 1156 | - | ||
| 1207 | + | ... | |
| 1208 | + | SourceEditorManagerIntf.GetHighlighterSettings(ASynHighlighter); | |
| 1157 | 1209 | ``` | |
| 1158 | 1210 | ||
| 1159 | - | ||
| 1211 | + | См. пример: TSQLStringsPropertyEditorDlg.Create in the unit [SQLStringsPropertyEditorDlg](<http://svn.freepascal.org/svn/lazarus/trunk/components/sqldb/sqlstringspropertyeditordlg.pas>). | |
| 1160 | 1212 | ||
| 1161 | 1213 | # Справка | |
| 1162 | 1214 | ||
| 1163 | 1215 | ## Добавление справки для исходников | |
| 1164 | 1216 | ||
| 1165 | - | ||
| 1166 | - | ||
| 1167 | - | ||
| 1217 | + | Сначала создаем THelpDatabase: | |
| 1218 | + | ``` | |
| 1168 | 1219 | HelpDB := TFPDocHTMLHelpDatabase( | |
| 1169 | - | ||
| 1170 | - | ||
| 1171 | - | ||
| 1172 | - | ||
| 1173 | - | ||
| 1174 | - | ||
| 1175 | - | ||
| 1176 | - | ||
| 1177 | - | ||
| 1178 | - | ||
| 1179 | - | ||
| 1220 | + | HelpDatabases.CreateHelpDatabase('ANameOfYourChoiceForTheDatabase', | |
| 1221 | + | TFPDocHTMLHelpDatabase,true)); | |
| 1222 | + | HelpDB.DefaultBaseURL := 'http://your.help.org/'; | |
| 1223 | + | ||
| 1224 | + | FPDocNode := THelpNode.CreateURL(HelpDB, | |
| 1225 | + | 'Package1 - A new package', | |
| 1226 | + | 'file://index.html'); | |
| 1227 | + | HelpDB.TOCNode := THelpNode.Create(HelpDB,FPDocNode);// один раз как оглавление TOC | |
| 1228 | + | DirectoryItem := THelpDBISourceDirectory.Create(FPDocNode,'$(PkgDir)/lcl', | |
| 1229 | + | '*.pp;*.pas',false);// и один раз как обычная страница | |
| 1230 | + | HelpDB.RegisterItem(DirectoryItem); | |
| 1180 | 1231 | ``` | |
| 1181 | 1232 | ||
| 1182 | 1233 | ## Добавление строк в окно сообщений | |
| 1183 | - | ||
| 1184 | - | ||
| 1234 | + | ``` | |
| 1185 | 1235 | unit IDEMsgIntf; | |
| 1186 | - | ||
| 1187 | - | ||
| 1188 | - | ||
| 1189 | - | ||
| 1190 | - | ||
| 1191 | - | ||
| 1192 | - | ||
| 1193 | - | ||
| 1236 | + | ... | |
| 1237 | + | var Dir: String; | |
| 1238 | + | begin | |
| 1239 | + | Dir:=GetCurrentDir; | |
| 1240 | + | IDEMessagesWindow.BeginBlock; | |
| 1241 | + | IDEMessagesWindow.AddMsg('unit1.pas(30,4) Error: Identifier not found "a"',Dir,0); | |
| 1242 | + | IDEMessagesWindow.EndBlock; | |
| 1243 | + | end; | |
| 1194 | 1244 | ``` | |
| 1195 | 1245 | ||
| 1196 | 1246 | # Окно настроек IDE | |
| 1197 | 1247 | ||
| 1198 | 1248 | ## Открытие параметров в определенном кадре | |
| 1199 | - | ||
| 1200 | - | ||
| 1249 | + | ``` | |
| 1201 | 1250 | uses LazIDEIntf; | |
| 1202 | - | ||
| 1203 | - | ||
| 1251 | + | ... | |
| 1252 | + | LazarusIDE.DoOpenIDEOptions(TYourIDEOptionsFrame); | |
| 1204 | 1253 | ``` | |
| 1205 | 1254 | ||
| 1206 | 1255 | # Прочее | |
| 1207 | 1256 | ||
| 1208 | 1257 | ## Добавление макроса | |
| 1209 | 1258 | ||
| 1210 | - | ||
| 1211 | - | ||
| 1212 | - | ||
| 1259 | + | Вы можете добавить свои собственные макросы IDE: | |
| 1260 | + | ``` | |
| 1213 | 1261 | uses MacroIntf, MacroDefIntf; | |
| 1214 | - | ||
| 1215 | - | ||
| 1216 | - | ||
| 1217 | - | ||
| 1218 | - | ||
| 1219 | - | ||
| 1220 | - | ||
| 1221 | - | ||
| 1222 | - | ||
| 1223 | - | ||
| 1224 | - | ||
| 1225 | - | ||
| 1226 | - | ||
| 1227 | - | ||
| 1228 | - | ||
| 1229 | - | ||
| 1230 | - | ||
| 1231 | - | ||
| 1232 | - | ||
| 1233 | - | ||
| 1234 | - | ||
| 1235 | - | ||
| 1262 | + | ||
| 1263 | + | procedure Register; | |
| 1264 | + | begin | |
| 1265 | + | // регистрация макроса с фиксированным значением: | |
| 1266 | + | IDEMacros.Add(TTransferMacro.Create('MyMacro1','Value','Description',nil,[])); | |
| 1267 | + | end; | |
| 1268 | + | ||
| 1269 | + | // регистрация макроса с динамическим значением требует метода объекта | |
| 1270 | + | procedure TForm1.Init; | |
| 1271 | + | begin | |
| 1272 | + | IDEMacros.Add(TTransferMacro.Create('MyMacro','Value','Description',@OnResolveMyMacro,[])); | |
| 1273 | + | end; | |
| 1274 | + | ||
| 1275 | + | function TForm1.OnResolveMyMacro(const s: string; const Data: PtrInt; | |
| 1276 | + | var Abort: boolean): string; | |
| 1277 | + | // s - это параметр. Например, $MyMacro(parameter) | |
| 1278 | + | // Data - это экземпляр запроса. Может быть nil. | |
| 1279 | + | // Если есть ошибка, установите Abort в true. | |
| 1280 | + | // Результирующая строка может содержать макросы. Например, Result:='$(FPCVer)/$(TargetOS)'; | |
| 1281 | + | begin | |
| 1282 | + | Result:='MyValue'; | |
| 1283 | + | end; | |
| 1236 | 1284 | ``` | |
| 1237 | 1285 | ||
| 1238 | 1286 | ## Отладка IDE | |
| 1239 | 1287 | ||
| 1240 | - | ||
| 1241 | - | ||
| 1242 | - | ||
| 1288 | + | * Скомпилируйте IDE как обычно, например, с помощью Tools/Build Lazarus. Убедитесь, что вы установили отладочные флаги, такие как -g или -gw2. Лучше всего использовать профиль "Debug IDE", который содержит много флагов, полезных для отладки. | |
| 1289 | + | * Откройте проект ide\lazarus.lpi. Вы не можете напрямую скомпилировать этот проект. | |
| 1290 | + | * Установите точки останова и пр. И запустите проект. | |
| 1243 | 1291 | ||
| 1244 | 1292 | ## См. также | |
| 1245 | 1293 | ||
| 1246 | - | ||
| 1247 | - | ||
| 1248 | - | ||
| 1294 | + | * [[Creating IDE Help]] | |
| 1295 | + | * [[Help protocol]] | |
| 1296 | + | * [[How To Write Lazarus Component]] | |
| 1249 | 1297 | ||
| 1250 | 1298 | --- | |
| 1251 | - | ||
| 1299 | + | *From the Free Pascal wiki, page "Extending the IDE/ru", as the Internet Archive kept it on 2023-12-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).* |