Difference between revisions of "Turbopower Visual PlanIt/ru"

From Lazarus wiki
Jump to navigationJump to search
m (Fixed syntax highlighting; deleted category included in page template)
 
(23 intermediate revisions by one other user not shown)
Line 94: Line 94:
 
* Поиграйте со свойствами, чтобы настроить все эти визуальные элементы управления в соответствии с вашими предпочтениями. Например, <tt>TVpWeekView</tt> имеет свойство, определяющее, начинается ли неделя в понедельник или воскресенье (<tt>WeekStartsOn</tt>).
 
* Поиграйте со свойствами, чтобы настроить все эти визуальные элементы управления в соответствии с вашими предпочтениями. Например, <tt>TVpWeekView</tt> имеет свойство, определяющее, начинается ли неделя в понедельник или воскресенье (<tt>WeekStartsOn</tt>).
  
−
* Два компонента отсутствуют: '''DataStore''' и '''ControlLink'''.
+
* Не хватает двух компонентов: '''DataStore''' и '''ControlLink'''.
 
** '''Datastore''' - это компонент, в котором хранятся данные, отображаемые в визуальных элементах управления. Пакет Visual PlanIt содержит ряд предопределенных хранилищ данных - см.ниже. Мы выбираем здесь TVpIniDatastore или TVpXmlDatastore, которые хранят данные в INI или XML-файле - эти хранилища не требуют базы данных, как другие хранилища данных.
 
** '''Datastore''' - это компонент, в котором хранятся данные, отображаемые в визуальных элементах управления. Пакет Visual PlanIt содержит ряд предопределенных хранилищ данных - см.ниже. Мы выбираем здесь TVpIniDatastore или TVpXmlDatastore, которые хранят данные в INI или XML-файле - эти хранилища не требуют базы данных, как другие хранилища данных.
 
** В свойстве <tt>Filename</tt> введите имя для файла хранилища данных, например, ''data.ini'' или ''data.xml'', соответственно. Использование относительного имени файла здесь означает, что путь будет относительно местоположения exe-файла программы, что удобно для этого урока. Однако в «реальном» приложении абсолютный путь может быть предпочтительным. И также может быть полезно ввести имя файла во время выполнения, например, в обработчике событий FormCreate.
 
** В свойстве <tt>Filename</tt> введите имя для файла хранилища данных, например, ''data.ini'' или ''data.xml'', соответственно. Использование относительного имени файла здесь означает, что путь будет относительно местоположения exe-файла программы, что удобно для этого урока. Однако в «реальном» приложении абсолютный путь может быть предпочтительным. И также может быть полезно ввести имя файла во время выполнения, например, в обработчике событий FormCreate.
Line 103: Line 103:
 
* Как '''добавить данные'''? Это делается двойным щелчком по любому из добавленных нами элементов управления, чтобы открыть специальный встроенный редактор для удобного ввода необходимых данных.
 
* Как '''добавить данные'''? Это делается двойным щелчком по любому из добавленных нами элементов управления, чтобы открыть специальный встроенный редактор для удобного ввода необходимых данных.
 
* Однако в первый раз появляется диалоговое окно, в котором говорится, что "no resources have been defined"(ресурсы не определены). '''Resource''' - это все, что может администрироваться инструментами VisualPlanIt, например, сотрудник, зал заседаний, книжная библиотека  и т.д. Введите имя ресурса. Если ваша программа будет работать с различными ресурсами, вы можете добавить [их список в виде] TVpResourceCombobox, чтобы выбрать ресурс, необходимый для запуска программы. Убедитесь, что вы используете уникальные имена ресурсов, потому что VisualPlanIt будет выдавать исключение дубликата ресурса в противном случае.
 
* Однако в первый раз появляется диалоговое окно, в котором говорится, что "no resources have been defined"(ресурсы не определены). '''Resource''' - это все, что может администрироваться инструментами VisualPlanIt, например, сотрудник, зал заседаний, книжная библиотека  и т.д. Введите имя ресурса. Если ваша программа будет работать с различными ресурсами, вы можете добавить [их список в виде] TVpResourceCombobox, чтобы выбрать ресурс, необходимый для запуска программы. Убедитесь, что вы используете уникальные имена ресурсов, потому что VisualPlanIt будет выдавать исключение дубликата ресурса в противном случае.
−
* When you restart the program the next time you will notice that the data are no longer visible. No reason to be alarmed - the data are still there, but the program just does not know which resource to open. Enter this code in the FormCreate event, after connecting to the datastore:
+
* При повторном запуске программы в следующий раз вы заметите, что данные больше не видны. Нет причин для беспокойства - данные все еще там, но программа просто не знает, какой ресурс открыть. Введите этот код в событие FormCreate после подключения к хранилищу данных:
−
<syntaxhighlight>
+
<syntaxhighlight lang=pascal>
 
procedure TForm1.FormCreate(Sender: TObject);
 
procedure TForm1.FormCreate(Sender: TObject);
 
begin
 
begin
−
   // Use this code if the filename is not set in the Object Inspector...
+
   // Используйте этот код, если имя файла не задано в Object Inspector...
 
   VpXmlDatastore1.FileName := name_of_the_datastore_file;
 
   VpXmlDatastore1.FileName := name_of_the_datastore_file;
−
   // ... and the datastore is not autoconnected.
+
   // ... и хранилище данных не подключено автоматически
 
   VpXmlDatastore1.Connected := true;
 
   VpXmlDatastore1.Connected := true;
−
   // This code selects the first resource (index 0) found in the datastore.
+
   // Этот код выбирает первый ресурс (index 0), найденный в хранилище данных
 
   if VpXmlDatastore1.Resources.Count > 0 then
 
   if VpXmlDatastore1.Resources.Count > 0 then
 
     VpXmlDatastore1.Resource := VpXmlDatastore1.Resources.Items[0];   
 
     VpXmlDatastore1.Resource := VpXmlDatastore1.Resources.Items[0];   
 
end;</syntaxhighlight>
 
end;</syntaxhighlight>
  
−
==== Event categories ====
+
==== Категории событий ====
 
[[image:tvplanit_eventeditor.png|right]]
 
[[image:tvplanit_eventeditor.png|right]]
−
The event editor is used to enter or edit event details. You'll find here a combobox labeled "Category". The combobox items can be used to classify the events, like "Business", "Private", "Birthday" etc. The items, however, only have generic names, such as "Category 1", "Category 2", etc. You can select more descriptive names by visiting the datastore property <tt>CategoryColorMap</tt>. The field "Descriptions" defines the text to be displayed in the combobox. In order to be able to distinguish the categories in the DayView control you can also set up a background color and a bitmap here.
+
Редактор событий используется для ввода или редактирования деталей события. Вы найдете здесь комбинированный список с надписью "Category"(Категория). Элементы комбинированного списка можно использовать для классификации событий, например "Business"(Деловые), "Private"(Личное), "Birthday"(День рождения) и т.д. Однако эти элементы имеют только обобщенные имена, такие как "Category 1", "Category 2" и т.д. Вы можно выбрать более описательные имена, посетив свойство хранилища данных <tt>CategoryColorMap</tt>. Поле "Descriptions"(Описания) определяет текст, который будет отображаться в выпадающем списке. Чтобы иметь возможность различать категории в элементе управления DayView, вы также можете установить здесь цвет фона и растровое изображение.
  
−
==== Playing an event sound ====
+
==== Воспроизведение звука события ====
−
The planner components are prepared to play a sound some pre-defined time ahead of the occurence of an event. For this to happen the "Reminder" checkbox must be checked in the event editor.  
+
Компоненты планировщика готовы воспроизводить звук в заранее определенное время до наступления события. Для этого необходимо установить флажок "Reminder"(Напоминание) в редакторе событий.  
  
−
There are several ways to set up the sound:
+
Есть несколько способов настроить звук:
−
* The datastore exposes a property <tt>DefaultSound</tt>. The sound file specified here will be played whenever an event with checked "Reminder" box happens.
+
* Хранилище данных предоставляет свойство <tt>DefaultSound</tt>. Указанный здесь звуковой файл будет воспроизводиться всякий раз, когда происходит событие с установленным флажком "Reminder".
−
* Additionally, an individual sound file can be selected for each particular event by clicking at the loudspeaker icon next to the reminder interval.
+
* Кроме того, для каждого конкретного события можно выбрать отдельный звуковой файл, щелкнув значок громкоговорителя рядом с интервалом напоминания.
−
In Windows, the sounds are played automatically without further code because there universal sound utilities are embedded. In Linux, however, this is less standardized. But the datastore provides an event <tt>OnPlaySound</tt> where the correct sound playing command can be executed. The ''fulldemo'' project in the ''examples'' folder contains a unit which checks for the sound engines typically available in various systems; this unit is an adapted version of the '''playsound component''' by Gordon Bamber in the ''Lazarus components and code repository'' (https://sourceforge.net/p/lazarus-ccr/svn/HEAD/tree/components/playsoundpackage/).
+
В Windows звуки воспроизводятся автоматически без дополнительного кода, потому что там встроены универсальные звуковые утилиты. В Linux, однако, это менее стандартизировано. Но хранилище данных предоставляет событие <tt>OnPlaySound</tt>, где может быть выполнена правильная команда воспроизведения звука. Проект ''fulldemo'' в папке ''examples'' содержит модуль, который проверяет звуковые движки, обычно доступные в различных системах; этот модуль представляет собой адаптированную версию '''playsound component''' от Gordon Bamber в ''Lazarus components and code repository'' (https://sourceforge.net/p/lazarus-ccr/svn/HEAD/tree/components/playsoundpackage/).
  
−
=== Datastores ===
+
=== Хранилища данных ===
  
−
Datastores are responsible for persistent storage of event, task and contact data records.  
+
Хранилища данных отвечают за постоянное хранение записей о событиях, задачах и контактах.
  
−
The ancestor of this hierachy of classes is <tt>TVpCustomDatastore</tt>. It implements the basic functionality and provides fundamental abstract methods, such as <tt>LoadEvents</tt>, <tt>LoadTasks</tt>, <tt>LoadContacts</tt>, <tt>PostResources</tt>, <tt>PostEvents</tt>, <tt>PostTasks</tt>, <tt>PostContacts</tt>. Its member class <tt>Resources</tt> (type: <tt>TVpResources</tt>) stores all resources in a list as <tt>TVpResource</tt> items. Such a resource item, in turn, contains other lists: <tt>Schedule</tt>, <tt>Tasks</tt>, and <tt>Contacts</tt> for all event, task and contact records. The currently selected resource can be accessed by the datastore's <tt>Resource</tt> or <tt>ResourceID</tt> properties (the latter is a unique numerical ID to identify the resource).
+
Предком этой иерархии классов является <tt>TVpCustomDatastore</tt>. Он реализует базовую функциональность и предоставляет фундаментальные абстрактные методы, такие как <tt>LoadEvents</tt>, <tt>LoadTasks</tt>, <tt> LoadContacts</tt>, <tt>PostResources</tt>, <tt>PostEvents</tt>, <tt>PostTasks</tt>, <tt>PostContacts</tt>. Его класс-член <tt>Resources</tt> (type: <tt>TVpResources</tt>) хранит все ресурсы в списке как элементы <tt>TVpResource</tt>. Такой элемент ресурса, в свою очередь, содержит другие списки: <tt>Расписание</tt>, <tt>Задачи</tt> и <tt>Контакты</tt> для всех записей событий, задач и контактов. Доступ к выбранному в данный момент ресурсу можно получить из свойств <tt>Resource</tt> или <tt>ResourceID</tt> хранилища данных (последний представляет собой уникальный числовой идентификатор для идентификации ресурса).
  
−
<tt>TVpCustomDBDatastore</tt> inherited directly from <tt>TVpCustomDatastore</tt>. It is another (pseudo-) abstract class which provides the basic database functionality by means of four datasets, <tt>ResourceTable</tt>, <tt>EventsTable</tt>, <tt>TasksTable</tt>, and <tt>ContactsTable</tt>. Since datebases have very efficient methods of searching and filterung these datastores provide a property <tt>DayBuffer</tt> which defines a date range before and after the currently selected date for which records are loaded.
+
<tt>TVpCustomDBDatastore</tt>, унаследованный непосредственно от <tt>TVpCustomDatastore</tt>. Это еще один (псевдо-) абстрактный класс, который обеспечивает базовую функциональность базы данных посредством четырех наборов данных: <tt>ResourceTable</tt>, <tt>EventsTable</tt>, <tt>TasksTable</tt> и <tt>ContactsTable</tt>. Поскольку базы данных имеют очень эффективные методы поиска и фильтрации, эти хранилища данных предоставляют свойство <tt>DayBuffer</tt>, которое определяет диапазон дат до и после текущей выбранной даты, для которой загружаются записи.
  
 
==== TVpIniDatastore ====
 
==== TVpIniDatastore ====
−
This is a simple file datastore which inherits from <tt>TVpCustomDatastore</tt>. It stores the data records in a simple ini file structure. The name of the ini file must be specified in the corresponding property. The file is loaded after the datastore has been created if the design-time property <tt>AutoConnect</tt> is true, or when the run-tim property <tt>Connected</tt> is switched to true. The file is saved automatically when <tt>Connected</tt> goes back to <tt>false</tt> - this happens before the datstore is destroyed.
 
  
−
The demo project ''examples/datastores/ini'' is an example how the ini datastore can be used.
+
Это простое хранилище файловых данных, которое наследуется от <tt>TVpCustomDatastore</tt>. Он хранит записи данных в простой файловой структуре ini. Имя ini-файла должно быть указано в соответствующем свойстве. Файл загружается после того, как хранилище данных было создано, если свойство времени разработки <tt>AutoConnect</tt> имеет значение <tt>true</tt> или когда свойство среды выполнения <tt>Connected</tt> переключено на значение <tt>true</tt>. Файл сохраняется автоматически, когда <tt>Connected</tt> возвращается к <tt>false</tt> - это происходит до уничтожения хранилища данных.
 +
 
 +
Демонстрационный проект ''examples/datastores/ini'' является примером того, как можно использовать хранилище данных ini.
  
 
==== TVpXmlDatastore ====
 
==== TVpXmlDatastore ====
−
This is another simple file datastore. It works similarly as the ini datastore except that the file is an xml file now. The datastore's tree of xml nodes can be inserted into any existing xml file, e.g. files written by <tt>TXMLDataStorage</tt>. For this purpose, the node must be specified to which the datastore's nodes will be attached (property <tt>ParentNode</tt>).
 
  
−
Have a look at the demo project in ''examples/datastores/xml'' to see the xml datastore at work.
+
Это еще один простой файл хранилища данных. Он работает так же, как хранилище данных ini, за исключением того, что этот файл теперь является XML-файлом. Дерево XML-узлов хранилища данных может быть вставлено в любой существующий XML-файл, например, файлы, записанные <tt>TXMLDataStorage</tt>. Для этого необходимо указать узел, к которому будут присоединены узлы хранилища данных (свойство <tt>ParentNode</tt>).
 +
 
 +
Посмотрите демонстрационный проект в ''examples/datastores/xml'', чтобы увидеть, как работает хранилище данных xml.
  
 
==== TVpBufDSDatastore ====
 
==== TVpBufDSDatastore ====
−
The following datastores inherit from <tt>TVpCustomDBDatastore</tt>. The first one, <tt>TBufDSDataset</tt>, uses simple <tt>TBufDataset</tt> tables for storage of the planner data. The four required files are named "Resources.db", "Events.db", "Contacts.db" and "Tasks.db", and are stored in the folder specified by the property <tt>Directory</tt>. If <tt>AutoCreate</tt> is true then the tables are created automatically when the program runs for the first time; otherwise the datastore method <tt>CreateTables</tt> must be called.
 
  
−
Application of this datastore is demonstrated in ''examples/datastores/bufdataset'' and in ''examples/fulldemo''.
+
Следующие хранилища данных наследуются от <tt>TVpCustomDBDatastore</tt>. Первая, <tt>TBufDSDataset</tt>, использует простые таблицы <tt>TBufDataset</tt> для хранения данных планировщика. Четыре обязательных файла называются "Resources.db", "Events.db", "Contacts.db" и "Tasks.db" и хранятся в папке, указанной свойством <tt>Directory</tt>. Если <tt>AutoCreate</tt> имеет значение <tt>true</tt>, тогда таблицы создаются автоматически при первом запуске программы; в противном случае должен быть вызван метод хранилища данных <tt>CreateTables</tt>.
 +
 
 +
Применение этого хранилища данных продемонстрировано в ''examples/datastores/bufdataset'' и в ''examples/fulldemo''.
  
 
==== TVpSqlite3Datastore ====
 
==== TVpSqlite3Datastore ====
−
This datastore is a specialized storage for SQLite3 tables. It uses SQLDB components for this purpose. You must add a TSQLite3Connection and a TSQLTransaction to the form, link them together using the corresponding properties. Link the SQLite3Connection to the <tt>Connection</tt> of the datastore. The SQLQueries required are created automatically if the datastore's <tt>AutoCreate</tt> is true or after <tt>CreateTables</tt> is called. The database is stored in the file specified by the connection's <tt>DatabaseName</tt>.
 
  
−
The project in ''examples/datastores/sqlite3'' demonstrates how the sqlite3 datastore can be used.
+
Это хранилище данных является специализированным хранилищем для таблиц SQLite3. Для этого используются компоненты SQLDB. Вы должны добавить TSQLite3Connection и TSQLTransaction в форму, связать их вместе, используя соответствующие свойства. Свяжите SQLite3Connection с <tt>Connection</tt> хранилища данных. Требуемые SQLQueries создаются автоматически, если <tt>AutoCreate</tt> хранилища данных имеет значение <tt>true</tt> или после вызова <tt>CreateTables</tt>. База данных хранится в файле, указанном <tt>DatabaseName</tt> соединения.
 +
 
 +
Проект в ''examples/datastores/sqlite3'' демонстрирует, как можно использовать хранилище данных sqlite3.
  
 
==== TVpFirebirdDatastore ====
 
==== TVpFirebirdDatastore ====
−
A Firebird database provides the storage for <tt>TVpFirebirdDatastore</tt>. Again, SQLDB components are used here. To establish a connection to the database, a <tt>TIBConnection</tt> must be linked to the datastore's <tt>Connection</tt>. It must provide all information to connect to the database, such as database name, user name and password. In addition, a <tt>TSQlTransaction</tt> component is needed. The database should be created by the tools provided by Firebird or by third-party database administration tools. It is possible to do this also from the datastore, but this results in an exception. If the datastore's <tt>AutoCreate</tt> the required tables are created automatically when not found; alternatively call <tt>CreateTables</tt> for the datastore.
 
  
−
Usage of the datastore is demonstrated in ''examples/datastores/fb''.
+
База данных Firebird предоставляет хранилище для <tt>TVpFirebirdDatastore</tt>. Опять же, здесь используются компоненты SQLDB. Чтобы установить соединение с базой данных, <tt>TIBConnection</tt> должен быть связан с <tt>Connection</tt> хранилища данных. Он должен предоставить всю информацию для подключения к базе данных, такую как имя базы данных, имя пользователя и пароль. Кроме того, необходим компонент <tt>TSQlTransaction</tt>. База данных должна создаваться средствами, предоставляемыми Firebird, или сторонними инструментами администрирования базы данных. Это можно сделать и из хранилища данных, но это приводит к исключению. Если в хранилище данных <tt>AutoCreate</tt> необходимые таблицы создаются автоматически, когда они не найдены; В качестве альтернативы вызовите <tt>CreateTables</tt> для хранилища данных.
 +
 
 +
Использование хранилища данных показано в ''examples/datastores/fb''.
  
 
==== TVpZeosDatastore ====
 
==== TVpZeosDatastore ====
 
[[image:TvPlanit_FieldMapping.png|right]]
 
[[image:TvPlanit_FieldMapping.png|right]]
−
The <tt>TVpZeosDatastore</tt> works with the [[Zeos_tutorial|ZEOS database components]]. Since they are not contained in the standard Lazarus distribution it is contained in a separate package, ''laz_visualplanit_zeos'', which is found in the ''source/addons/zeos'' folder and must be installed after ''laz_visualplanit''.
 
  
−
A <tt>TZConnection</tt> is required to establishe a connection to the database. The tables are created internally, either automatically if <tt>AutoCreate</tt> is true, or manually by calling <tt>CreateTable</tt>.
+
<tt>TVpZeosDatastore</tt> работает с [[Zeos_tutorial|Компонентами базы данных ZEOS]]. Поскольку они отсутствуют в стандартном дистрибутиве Lazarus, [компонент] содержится в отдельном пакете ''laz_visualplanit_zeos'', который находится в папке ''source/addons/zeos'' и должен быть установлен после [установки самого] ''laz_visualplanit''.
  
−
The demo project can be found in ''examples/datastores/zeos''.
+
<tt>TZConnection</tt> требуется для установления соединения с базой данных. Таблицы создаются внутри, либо автоматически, если <tt>AutoCreate</tt> имеет значение <tt>true</tt>, либо вручную, вызывая <tt>CreateTable</tt>.
 +
 
 +
Демонстрационный проект можно найти в ''examples/datastores/zeos''.
  
 
==== TVpFlexDatastore ====
 
==== TVpFlexDatastore ====
−
In the database-aware datastores mentioned so far, the tables are created by the datastore. This makes sure that the fields are named in the way as expected by the datastore. If, on the other hand, tables are already existing or are provided by other applications it is very likely that field names will not be reckognized. <tt>TVpFlexDatastore</tt> can be a solution. Its name indicates that this is a very ''flexible'' datastore. In particular, it is possible to link to any database system if a TDataset-descendent is available.
 
  
−
You must add four TDataset components to the form, each one corresponding to one of the Resources, Events, Contacts, and Tasks data, and link them to the <tt>DataSsource</tt> of the datastore via TDataSource components. Then double-click on the <tt>TvVpFlexDatastore</tt> to open the FieldMapper. This is a tool to assign the database fields to the internal fields of the datastore. For each database field that you want to include in the planner select the corresponding datastore field in the right list box. After clicking "Add" the pair of fields is shown in the "Field Mappings" listbox.
+
В упомянутых выше хранилищах данных, связанных с базой данных, таблицы создаются хранилищем данных. Это гарантирует, что поля [будут] названы так, как ожидается хранилищем данных. С другой стороны, если таблицы уже существуют или предоставляются другими приложениями, весьма вероятно, что имена полей не будут повторно распознаны. <tt>TVpFlexDatastore</tt> может быть решением [этой проблемы]. Его название указывает на то, что это очень «гибкое» хранилище данных. В частности, можно связываться с любой системой базы данных, если доступен TDataset-потомок.
 +
 
 +
Вы должны добавить в форму четыре компонента TDataset, каждый из которых соответствует одному из данных Resources, Events, Contacts и Tasks, и связать их с <tt>DataSource</tt> хранилища данных через компоненты TDataSource. Затем дважды щелкните <tt>TvVpFlexDatastore</tt>, чтобы открыть FieldMapper. Это инструмент для назначения полей базы данных внутренним полям хранилища данных. Для каждого поля базы данных, которое вы хотите включить в планировщик, выберите соответствующее поле хранилища данных в правом списке. После нажатия кнопки "Add"(Добавить) пара полей отображается в списке "Field Mappings"(Сопоставление полей).
 +
 
 +
Есть два примера проектов
 +
* ''examples/datastores/flex/access'' демонстрирует, как база данных MS Access может служить для хранения с использованием ODBCConnection и других компонентов SQLDB (есть также readme.txt с пошаговыми инструкциями).
 +
* ''examples/datastores/flex/sqlite3'' повторяет то же самое для базы данных SQLite3.
  
−
There are two sample projects
+
==== Другие хранилища данных ====
−
* ''examples/datastores/flex/access'' demonstrates how an MS Access database can serve for storage using an ODBCConnection and other SQLDB components (there is also a ''readme.txt'' with step-by-step instructions).
 
−
* ''examples/datastores/flex/sqlite3'' repeats the same with a SQLite3 database.
 
  
−
==== Other datastores ====
+
Следующие хранилища данных из исходного дистрибутива Delphi включены в папку с исходниками, но не добавлены в пакет, поскольку для них требуется BDE, который недоступен для Lazarus:
−
The following datastores from the original Delphi distribution are included in the source folder, but not added to the package because they require the BDE which is not available for Lazarus:
+
* '''TVpBDEDatastore''' для доступа к базе данных с помощью Borland Database Engine (BDE) (модуль ''vpbdeds'')
−
* '''TVpBDEDatastore''' for database access by means of the Borland Database Engine (BDE) (unit ''vpbdeds'')
+
* '''TVpAdvDatastore''' для базы данных Advantage (модуль ''vpadvds'')
−
* '''TVpAdvDatastore''' for Advantage Database (unit ''vpadvds'')
+
* '''TVpFF2Datastore''' для баз данных FlashFiler 2 (модуль ''vpff2ds'')
−
* '''TVpFF2Datastore''' for FlashFiler 2 databases (unit ''vpff2ds'')
+
* '''TVpDBISAMDatastore''' для доступа к базе данных DBISAM (модуль ''vpdbisamds'')
−
* '''TVpDBISAMDatastore''' for DBISAM database access (unit ''vpdbisamds'')
+
* '''TVpSQLDatastore''' (модуль ''vpsqlds''): Это очень общее хранилище данных для любой базы данных sql. Должен быть предоставлен сопряженный класс с потомком TDataset, и должен быть класс, определяющий конкретный SQL-диалект. Для применения в Lazarus потребуется некоторая перестройка свойств, связанных с BDE. Пакет содержит пример доступа к BDE.
−
* '''TVpSQLDatastore''' (unit ''vpsqlds''): This is a very general datastore for any sql database. An interfaced class to the TDataset-descendent must be provided, and there must be a class specifying the particular sql dialect. For application in Lazarus, some restructuring of BDE-related properties will be required. The package contains an example for BDE access.
 
  
−
=== Overlaying events ===
+
=== Наложение событий ===
−
The DayView and WeekView components primarily display events of a single resource. It is possible, however, to switch into an '''overlay mode''' where other resources can be displayed within the same controls. This can be achieved by assigning a <tt>TVResourceGroup</tt> to the resource (property <tt>Group</tt>):
+
Компоненты DayView и WeekView в основном отображают события одного ресурса. Однако возможно переключиться в '''overlay mode'''(режим наложения), где другие ресурсы могут отображаться в тех же элементах управления. Это может быть достигнуто путем назначения ресурса <tt>TVResourceGroup</tt> (свойство <tt>Group</tt>):
−
<syntaxhighlight>
+
<syntaxhighlight lang=pascal>
 
type
 
type
 
   TVpOverlayPattern = (opSolid, opClear, opHorizontal, opVertical, opFDiagonal, opBDiagonal, opCross, opDiagCross);
 
   TVpOverlayPattern = (opSolid, opClear, opHorizontal, opVertical, opFDiagonal, opBDiagonal, opCross, opDiagCross);
Line 208: Line 216:
 
procedure TMainForm.CreateResourceGroup;
 
procedure TMainForm.CreateResourceGroup;
 
const
 
const
−
   NAME_OF_GROUP = '';  // empty --> use resource descriptions instead
+
   NAME_OF_GROUP = '';  // пусто -> используйте взамен описания ресурсов
 
   PARENT_ID = 1;
 
   PARENT_ID = 1;
 
   OVERLAYED_ID = 2;
 
   OVERLAYED_ID = 2;
Line 222: Line 230:
 
     datastore.Resource.Group := grp else
 
     datastore.Resource.Group := grp else
 
     datastore.Resource.Group := nil;
 
     datastore.Resource.Group := nil;
−
   datastore.RefreshEvents;  // or: datastore.UpdateGroupEvents;
+
   datastore.RefreshEvents;  // или: datastore.UpdateGroupEvents;
 
end;
 
end;
 
</syntaxhighlight>
 
</syntaxhighlight>
−
The IDs of the overlayed resources are specified as an array in the first parameter of the call to <tt>AddResourceGroup</tt>. The first id plays a special role: it refers to the resource to which the group is attached. If this resource is displayed in a Dayview or WeekView component then the events of the other specified ID(s) are overlayed within the same control.  
+
Идентификаторы наложенных ресурсов указываются в виде массива в первом параметре вызова <tt>AddResourceGroup</tt>. Первый идентификатор играет особую роль: он относится к ресурсу, к которому присоединена группа. Если этот ресурс отображается в компоненте DayView или WeekView, то события другого указанного идентификатора(ов) накладываются на один и тот же элемент управления.
  
−
The level of detail visible to the user seeing overlayed events is controlled by the property <tt>ShowDetails</tt> of the resource group. By default, only the name of the overlayed resource is visible. If more details are to be exposed you can add the other elements of <tt>TVpOverlayDetails</tt>. The background of overlayed events in the dayview is hatched as specified by the <tt>Pattern</tt> property of the resource group if the event category is not excluded from the visible details; otherwise the event is drawn as specified by the property <tt>HiddenCategories</tt> of the Datastore.
+
Уровень детализации, видимый пользователю, просматривающему наложенные события, контролируется свойством <tt>ShowDetails</tt> группы ресурсов. По умолчанию отображается только имя наложенного ресурса. Если необходимо предоставить больше деталей, вы можете добавить другие элементы <tt>TVpOverlayDetails</tt>. Фон наложенных событий в дневном обзоре заштриховывается, как указано в свойстве <tt>Pattern</tt> группы ресурсов, если категория событий не исключена из видимых деталей; в противном случае событие рисуется, как указано в свойстве <tt>HiddenCategories</tt> хранилища данных.
  
−
Editing, deleting, drag-and-drop of overlayed events is off by default, but can be allowed by setting the <tt>ReadOnly</tt> property of their resource group to false.  
+
Редактирование, удаление, перетаскивание наложенных событий по умолчанию отключено, но это можно разрешить, установив для свойства <tt>ReadOnly</tt> их группы ресурсов значение <tt>false</tt>.
  
−
In order to turn resource groups on and off the context menu of DayView and WeekView components is extended by a corresponding submenu. The submenu contains an item "none" meaning "no overlayed events" as well as an item for each resource group in which the currently selected resource is the parent. The caption of the menu items is defined by the (optional) second parameter of the <tt>AddResourceGroup</tt> call (<tt>NAME_OF_GROUP</tt>); if empty the group name is derived from the descriptions of the overlayed resources.
+
Чтобы включить или отключить группы ресурсов, контекстное меню компонентов DayView и WeekView расширено соответствующим подменю. Подменю содержит элемент «none», означающий «нет наложенных событий», а также элемент для каждой группы ресурсов, в которой текущий выбранный ресурс является родительским. Заголовок пунктов меню определяется вторым (необязательным) параметром вызова <tt>AddResourceGroup</tt> (<tt>NAME_OF_GROUP</tt>); если поле пустое, имя группы выводится из описаний наложенных ресурсов.
  
−
=== Printing and print preview ===
+
=== Печать и предварительный просмотр ===
 
[[image:tvplanit_printformatdesigner.png|right]]
 
[[image:tvplanit_printformatdesigner.png|right]]
−
The VisualPlanIt package contains routines for printing the planner controls. Even a print preview is implemented. The printing process is defined by means of templates which are called "print formats" here. They can be created at designtime or by means of an xml file loaded at runtime, contain a list of the components to be printed.
+
Пакет VisualPlanIt содержит процедуры для печати элементов управления планировщика. Реализован даже предварительный просмотр печати. Процесс печати определяется с помощью шаблонов, которые здесь называются "print formats"(форматы печати). Они могут быть созданы во время разработки или с помощью XML-файла, загруженного во время выполнения, содержать список компонентов, которые будут напечатаны.
  
−
The heart of printing support is the TVpPrinter class - it is accessible by the <tt>Printer</tt> property of the <tt>TVpControlLink</tt>. It contains extra information needed for the printing process and contains a list of the available <tt>PrintFormats</tt>.  
+
Основой поддержки печати является класс <tt>TVpPrinter</tt> - он доступен через свойство <tt>Printer</tt> в <tt>TVpControlLink</tt>. Он содержит дополнительную информацию, необходимую для процесса печати, и содержит список доступных <tt>PrintFormats</tt>.
  
−
In order to quickly access the print format designer double-click on the <tt>TVpControlLink</tt> component. Click on the upper "New" button to open the basic format editor. Here you can assign a reasonable name to the print format. Clicking on the lower "Edit" opens the "Element" editor - this is the tool to define the contents on the print print format, similar to a report designer, however less comfortable. In addition to the planner controls, DayView, WeekView, MonthView, TaskList and ContactGrid, the editor allows also to add additional text and shape objects to the format. Multiple elements can be contained within the same format. Position the elements by using the Top/Left/Width/Height specifications at the right. In addition, the entire format page can be rotated in 90° steps.
+
Для быстрого доступа к дизайнеру формата печати дважды щелкните компонент <tt>TVpControlLink</tt>. Нажмите на верхнюю кнопку "New"(Новый), чтобы открыть редактор основного формата. Здесь вы можете назначить осмысленное имя для формата печати. При нажатии на нижнюю кнопку "Edit"(Редактировать) открывается редактор "Element"(Элемент) - это инструмент для определения содержимого в формате печатной печати, аналогичный дизайнеру отчетов, но менее удобный. В дополнение к элементам управления планировщика, DayView, WeekView, MonthView, TaskList и ContactGrid, редактор также позволяет добавлять в формат дополнительные объекты текста и формы. Несколько элементов могут содержаться в одном формате. Расположите элементы, используя спецификации Top/Left/Width/Height справа. Кроме того, всю страницу формата можно поворачивать с шагом 90°.
  
−
A '''print preview''' can be generated by means of a <tt>TVpPrintPreview</tt> component. Assign the ControlLink of the form to the <tt>ControlLink</tt> and the <tt>Printer</tt> of the ''Printers'' units to the <tt>Printer</tt> property of the preview component. For printing to work correctly, you must have the package ''Printer4Lazarus'' in the requirements of the project; this can be done most easily by adding a standard <tt>TPrintDialog</tt> to the form which you will probably need anyway. Open the print preview by calling its <tt>Execute</tt> method. It should be mentioned that the print preview itself does not issue any printing commands. Therefore, extra printing code must be written if the user decides to initiate a print-out from the preview, something like this:
+
«Предварительный просмотр» может быть создан с помощью компонента <tt>TVpPrintPreview</tt>. Назначьте ControlLink формы для <tt>ControlLink</tt> и <tt>Printer</tt> модуля ''Printers'' для свойства <tt>Printer</tt> компонента предварительного просмотра. Для правильной работы печати у вас должен быть [предварительно установлен] пакет ''Printer4Lazarus'' в соответствии с требованиями проекта; это проще всего сделать, добавив в форму стандартный <tt>TPrintDialog</tt>, который вам, возможно, понадобится в любом случае. Откройте предварительный просмотр печати, вызвав его метод <tt>Execute</tt>. Следует отметить, что сам предварительный просмотр печати не выдает никаких команд печати. Поэтому должен быть написан дополнительный код печати, если пользователь решит начать распечатку из предварительного просмотра, что-то вроде этого:
  
−
<syntaxhighlight>
+
<syntaxhighlight lang=pascal>
 
if VpPrintPreviewDialog1.Execute then
 
if VpPrintPreviewDialog1.Execute then
 
   if PrintDialog1.Execute then begin
 
   if PrintDialog1.Execute then begin
Line 259: Line 267:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
−
See the ''fulldemo'' project in the ''examples'' folder for a worked-out example.
+
См. проработанный пример в проекте ''fulldemo'' в папке ''examples''.
  
−
=== Localization ===
+
=== Локализация ===
−
All internal strings used by the VisualPlanIt package can be localized by means of the translation utilities available within Lazarus. The '''translated po files''' can be found in the folder ''languages'' of the distribution. Copy them to the language folder of your application, and translate them by calling
+
Все внутренние строки, используемые пакетом VisualPlanIt, могут быть локализованы с помощью утилит перевода, доступных в Lazarus. '''Переведенные po-файлы''' можно найти в папке ''languages'' дистрибутива. Скопируйте их в языковую папку вашего приложения и переведите [его], вызвав
−
<syntaxhighlight>uses
+
<syntaxhighlight lang=pascal>uses
 
   translations;
 
   translations;
 
var
 
var
−
   langdir: String;  // language folder of your application
+
   langdir: String;  // языковая папка вашего приложения
−
   lang: String;    // language abbreviation, e.g. "de" for German
+
   lang: String;    // аббревиатура языка, например "de" для немецкого
 
//...
 
//...
 
   TranslateUnitResourceStrings('vpsr', langdir + 'vpsr.' + lang + 'po');
 
   TranslateUnitResourceStrings('vpsr', langdir + 'vpsr.' + lang + 'po');
 
</syntaxhighlight>
 
</syntaxhighlight>
−
{{Note|Users are cordially invited to submit translations of the resource strings to their native language}}
+
{{Note|Пользователям предлагается отправлять [разработчику] переводы ресурсов для своего родного языка.}}
  
−
In addition to providing translated strings a variety of '''date/time related properties''' of the planner controls should be adapted:
+
Помимо предоставления переведенных строк, должны быть адаптированы различные «свойства, относящиеся к дате/времени» элементов управления планировщика:
−
* Set <tt>VpDateView.DateLabelFormat</tt> to <tt>DefaultFormatSettings.LongDateFormat</tt>, dto. with <tt>VpWeekView.DayHeadAttributes.DateFormat</tt> and <tt>VpWeekView.DateLabelFormat</tt>.
+
* Установите для <tt>VpDateView.DateLabelFormat</tt> значение <tt>DefaultFormatSettings.LongDateFormat</tt>, dto. с <tt>VpWeekView.DayHeadAttributes.DateFormat</tt> и <tt>VpWeekView.DateLabelFormat</tt>.
−
* Set <tt>VpMonthView.DatelabelFormat</tt> to the string <tt>'mmmm yyyy'</tt> which means "month in words + year".
+
* Установите <tt>VpMonthView.DatelabelFormat</tt> в строку <tt>'mmmm yyyy'</tt>, что означает «месяц названием + год».
−
* Set <tt>VpTaskView.DisplayOptions.DueDateFormat</tt> to <tt>DefaultFormatSettings.ShortDateformat</tt>.
+
* Установите для <tt>VpTaskView.DisplayOptions.DueDateFormat</tt> значение <tt>DefaultFormatSettings.ShortDateformat</tt>.
−
* Determine the <tt>TVpTimeFormat</tt> of your system by calling <tt>GetTimeFormat</tt> (in Unit ''vpmisc''). The result is either <tt>tf12Hour</tt> or <tt>tf24Hour</tt> and should be assigned to the <tt>TimeFormat</tt> properties of VpDayView, VpWeekView and VpMonthView.
+
* Определите <tt>TVpTimeFormat</tt> вашей системы, вызвав <tt>GetTimeFormat</tt> (в модуле ''vpmisc''). Результат может быть <tt>tf12Hour</tt> или <tt>tf24Hour</tt> и должен быть назначен свойствам <tt>TimeFormat</tt> VpDayView, VpWeekView и VpMonthView.
−
* Set the properties <tt>WeekStartsOn</tt> of VpMonthView and VpWeekView to the day code of the first day of a week (1 = Sunday, ..., 7 = Saturday).
+
* Установите свойства <tt>WeekStartsOn</tt> для VpMonthView и VpWeekView в код дня начала недели (1 = воскресенье, ..., 7 = суббота).
  
−
Finally, the <tt>TVpControlLink</tt> implements procedures for localizing '''addresses''' in the Contact Editor Dialog. For this purpose, the file ''vplocalize.xml'' accompanies the VisualPlanIt package. It contains rules for construction of addresses in the correct format varying from country to country. If this filename is assigned to the property <tt>LocalizationFile</tt> of the ControlLink then these rule are effective when the Contact Editor Dialog is created. Please note that this file is not translated by the po files.
+
Наконец, <tt>TVpControlLink</tt> реализует процедуры локализации '''адресов''' в диалоге редактора контактов. Для этого к пакету VisualPlanIt прилагается файл vplocalize.xml. Он содержит правила для построения адресов в правильном формате, варьирующемся от страны к стране. Если это имя файла назначено свойству <tt>LocalizationFile</tt> элемента ControlLink, то эти правила вступают в силу при создании диалога редактора контактов. Обратите внимание, что этот файл не переводится с помощью файлов po.
  
−
== Using the navigation bar ==
+
== Использование панели навигации ==
 
[[Image:vpnavbar.png|right]]
 
[[Image:vpnavbar.png|right]]
  
−
<tt>TVpNavBar</tt>, seen in the left of this screenshot of the ''navbar'' demo, is a navigation tool smiliar to the one known from Outlook. It consists of several '''folders''' represented by button-like controls and several '''items''' - these are the labelled icons in the large space between two buttons. The folder button - which can be drawn in several button- or tab-like styles - is always shown above the associated item area. Clicking on a folder divides the stack of folders in an upper and lower part, and displays the items assigned to this folder between the corresponding folder at the top and the next folder at the bottom. The index of the currently expanded folder is given by the property <tt>ActiveFolder</tt>, and the index of the clicked items within this folder is given by property <tt>ActiveItem</tt>. An event <tt>OnItemClick</tt> fires when an item is clicked, it has the index of the clicked item as a parameter.
+
<tt>TVpNavBar</tt>, показанный справа на этом скриншоте демо ''navbar'', представляет собой инструмент навигации, похожий на тот, который известен в Outlook. Он состоит из нескольких '''папок''', представленных кнопочными элементами управления, и нескольких '''элементов''' - это помеченные значки в большом пространстве между двумя кнопками. Кнопка папки, которую можно нарисовать в нескольких стилях, похожих на кнопки или вкладки, всегда отображается над соответствующей областью элемента. Щелчок по папке делит стопку папок на верхнюю и нижнюю части и отображает элементы, назначенные этой папке, между соответствующей папкой вверху и следующей папкой внизу. Индекс развернутой в данный момент папки задается свойством <tt>ActiveFolder</tt>, а индекс выбранных элементов в этой папке задается свойством <tt>ActiveItem</tt>. Событие <tt>OnItemClick</tt> запускается при щелчке элемента, в качестве параметра он имеет индекс выбранного элемента.
  
−
An '''icon''' can be assigned to each item. These images are collected in the image list assigned to the property <tt>Images</tt> of the navigation bar. The images normally should be 32x32 pixels. The property <tt>IconSize</tt> of each folder determines whether these images are displayed directly as "large images" or reduced by a factor 2 (16x16 pixels) as "small images". The down-scaling is done by the component.
+
'''Значок''' может быть назначен каждому элементу. Эти изображения собраны в списке изображений, назначенном свойству <tt>Images</tt> панели навигации. Изображения обычно должны быть 32x32 пикселей. Свойство <tt>IconSize</tt> каждой папки определяет, будут ли эти изображения отображаться непосредственно как «большие изображения» или уменьшены в 2 раза (16x16 пикселей) как «маленькие изображения». Уменьшение масштаба выполняется компонентом.<br clear="all"/>
−
<br clear="all" />
 
  
 
[[Image:vpnavbareditor.png|right]]
 
[[Image:vpnavbareditor.png|right]]
−
'''Populating a TVpNavBar at designtime''' is easy if the version of VisualPlanIt is at least 1.0.10 in which the component editor of the NavBar is functional. Just double-click on the component, or select "Layout Tool..." from the context menu of the component. This opens the component editor displayed here as a screenshot. It contains three listboxes:
+
'''Заполнить TVpNavBar во время разработки''' легко, если версия VisualPlanIt по крайней мере 1.0.10, в которой работает редактор компонентов NavBar. Просто дважды щелкните по компоненту или выберите «Layout Tool ...» в контекстном меню компонента. Откроется редактор компонентов, отображаемый здесь в виде скриншота. Он содержит три списка:
−
* The '''left listbox''' shows the '''folders''' found in the navigation bar. Click on the "+" button to add a new folder, "-" to delete the selected folder, or the "up"/"down" arrows to rearrange the folders. The properties of the selected folder are displayed in the object inspector:
+
* '''Левый список''' (Folders) показывает '''папки''', найденные на панели навигации. Нажмите кнопку «+», чтобы добавить новую папку, «-», чтобы удалить выбранную папку, или стрелки «вверх»/«вниз», чтобы изменить порядок папок. Свойства выбранной папки отображаются в инспекторе объектов:
−
** Specify the <tt>Caption</tt> of the folder - this is the text to appear on the button/tab of the folder.
+
** Укажите <tt>Caption</tt> папки - это текст, который будет отображаться на кнопке/вкладке папки.
−
** Leave <tt>IconSize</tt> at <tt>isLarge</tt> if you want to use large icons for this folder's items. In this case, icons and their captions will be centered, the caption will be below the icon and word-wrapped if the text is longer than the width of the NavBar. If you select <tt>isSmall</tt>, on the other hand, icons and captions are left aligned, and the (non-wrapped) captions are drawn at the right of the icons. <tt>IconSize</tt> can change from folder to folder.  
+
** Оставьте <tt>IconSize</tt> в [значении] <tt>isLarge</tt>, если вы хотите использовать большие значки для элементов этой папки. В этом случае значки и подписи к ним будут отцентрированы, подпись будет находиться под значком и переноситься по словам, если текст длиннее, чем ширина панели навигации. Если же вы выберете <tt>isSmall</tt>, значки и подписи будут выровнены по левому краю, и (непереносимые по словам) заголовки будут нарисованы справа от значков. <tt>IconSize</tt> может меняться от папки к папке.
−
** Do not set the <tt>FolderType</tt> to <tt>ftContainer</tt> - this feature for adding arbitrary controls to the folder is not working in Lazarus at the time of this writing.
+
** Не устанавливайте <tt>FolderType</tt> равным <tt>ftContainer</tt> - эта функция для добавления произвольных элементов управления в папку не работает в Lazarus на момент написания этой статьи.
−
* The '''center listbox''' shows the '''items''' assigned to the folder highlighted in the left list. Caption and icon of this item are displayed in each line. Again click on the "+", "-", or "up"/"down" buttons to add, delete or rearrange the items. And again, the properties of the selected item can be changed in the object inspector. Besides the <tt>Caption</tt> already mentioned for the folders, there is also a property <tt>ImageIndex</tt> which specifies the icon displayed for the item. The image index refers to the ImageList assigned to the property <tt>Images</tt> of the NavBar.
+
* В '''центральном списке''' (Items/Icons) отображаются '''элементы''', назначенные папке, выделенной в левом списке. Заголовок и значок этого элемента отображаются в каждой строке. Снова нажмите кнопки «+», «-» или стрелки «вверх»/«вниз», чтобы добавить, удалить или изменить порядок элементов. И снова свойства выбранного элемента можно изменить в инспекторе объектов. Помимо <tt>Caption</tt>, уже упомянутого для папок, есть также свойство <tt>ImageIndex</tt>, которое указывает значок, отображаемый для элемента. Индекс изображения относится к списку изображений, назначенному свойству <tt>Images</tt> панели NavBar.
−
* The '''right listbox''' contains all the '''images''' found in the ImageList. It is intended to simplify the assignment of icons to items: Select the item for which an icon is to be selected. pick the icon in the right image list and click on the arrow between the item and images listboxes.
+
* '''Правый список''' (Availabel images) содержит все '''изображения''', найденные в ImageList. Он предназначен для упрощения назначения значков элементам: выберите элемент, для которого должен быть выбран значок. Выберите значок в правом списке изображений и нажмите на стрелку между списком элементов и изображений.
  
−
If the VisualPlanIt version is older than version 1.0.10, then getting folders and items into the NavBar is a bit more complicated because the component editor had not yet been ported/adapted to Lazarus. In this case, it is best to learn this task by means of the object inspector:
+
Если версия VisualPlanIt древнее, чем версия 1.0.10, получение папок и элементов в NavBar будет немного сложнее, поскольку редактор компонентов еще не был перенесен/адаптирован для Lazarus. В этом случае лучше всего изучить эту задачу с помощью инспектора объектов:
  
−
* Add a TVpNavBar component to the form.
+
* Добавьте компонент TVpNavBar в форму.
−
* Add an imagelist with, ideally 32x32 images, and assign it to the <tt>Images</tt> property of the NavBar.
+
* Добавьте список изображений, в идеале с размерами 32x32, и назначьте его свойству <tt>Images</tt> панели NavBar.
−
* Click on the "..." button next to <tt>FolderCollection</tt> to open the collection editor for the folders.
+
* Нажмите кнопку «...» рядом с <tt>FolderCollection</tt>, чтобы открыть редактор коллекций для папок.
−
* Click "Add" to add a new folder.
+
* Нажмите "Add"(Добавить), чтобы добавить новую папку.
−
* Select the new folder in the collection editor, its properties appear in the object inspector and can be changed there.
+
* Выберите новую папку в редакторе коллекции, ее свойства появятся в инспекторе объектов и могут быть изменены там.
−
* In order to add items to the folder click on <tt>ItemCollection</tt>. This opens the collection editor for the items belonging to the current folder.
+
* Чтобы добавить элементы в папку, нажмите <tt>ItemCollection</tt>. Откроется редактор коллекции для элементов, принадлежащих текущей папке.
−
* Again click "Add" to create a new item, and select it in the collection editor to enter its properties in the object inspector.
+
* Снова нажмите "Add"(Добавить), чтобы создать новый элемент, и выберите его в редакторе коллекции, чтобы ввести его свойства в инспекторе объектов.
  
−
== Gadgets ==
+
== Гаджеты ==
 
[[Image:vpgadgets.png|right]]
 
[[Image:vpgadgets.png|right]]
  
−
In addition to the planner components the Visual PlanIt package contains also two stand-alone gadgets:  
+
В дополнение к компонентам планировщика пакет Visual PlanIt содержит также два автономных гаджета:  
  
 
=== TVpLEDLabel ===
 
=== TVpLEDLabel ===
−
This is a 14-segment LED display which can display any ASCII string. The string is defined by means of the property <tt>Caption</tt>, but the count of LED characters must be defined explicitly using the property <tt>Columns</tt>
+
Это 14-сегментный светодиодный дисплей, который может отображать любую строку ASCII. Строка определяется с помощью свойства <tt>Caption</tt>, но количество светодиодных символов должно быть определено явно с помощью свойства <tt>Columns</tt>
  
 
=== TVpClock ===
 
=== TVpClock ===
−
This is a digital or analog clock - depending on the property <tt>DisplayMode</tt>. A variety of settings can be adjusted for each mode separately by using the properties in <tt>AnalogOptions</tt> and <tt>DigitalOptions</tt>. The properties are pretty much self-explanatory, except maybe the <tt>DigitalOptions.MilitaryTime</tt> which activates the 24-hour display if <tt>true</tt>, or the 12-hour am/pm mode if <tt>false</tt>. The <tt>AnalogOptions.ClockFace</tt> replaces the default-drawn clock face by a bitmap - see screenshot above.
+
Это цифровые или аналоговые часы - в зависимости от свойства <tt>DisplayMode</tt>. Разнообразие настроек можно применять для каждого режима отдельно, используя свойства в <tt>AnalogOptions</tt> и <tt>DigitalOptions</tt>. Свойства в значительной степени говорят сами за себя, за исключением, возможно, <tt>DigitalOptions.MilitaryTime</tt>, который активирует 24-часовое отображение, если <tt>true</tt>, или 12-часовой режим am/pm, если <tt>false</tt>. <tt>AnalogOptions.ClockFace</tt> заменяет нарисованный по умолчанию циферблат часов растровым изображением - см. Скриншот выше.
−
 
 
−
With the property <tt>ClockMode</tt> the operation of the clock can be changed from standard clock (count-up or count-down timer, <tt>cmClock</tt>, <tt>cmTimer</tt>, <tt>cmCountdownTimer</tt>, respectively).
 
  
−
[[Category:Components]]
+
С помощью свойства <tt>ClockMode</tt> работа часов может быть изменена со стандартных часов (<tt>cmClock</tt>) [на другие] (секундомер или таймер обратного отсчета, <tt>cmTimer</tt> и <tt>cmCountdownTimer</tt> соответственно).
−
[[Category:Lazarus-CCR]]
 
−
[[Category:Tutorials]]
 

Latest revision as of 03:03, 2 March 2020

│ English (en) │ português (pt) │ русский (ru) │

О компоненте

Visual PlanIt - это набор синхронизированных, привязанных к данным, компонентов для добавления в приложения возможностей управления временем, задачами и контактами. Получите Outlook-подобный интерфейс без хлопот.

Этот компонент был разработан для кроссплатформенных приложений.

Скриншоты

Tvplanit.PNG

Авторы

Авторы: Turbo Power Software
Порт на LCL: Christian Ulrich и Werner Pamler

Лицензия

Mozilla Public Licence 1.1

Загрузка

SVN

Вы можете проверить последний исходный код из https://lazarus-ccr.svn.sourceforge.net/svnroot/lazarus-ccr/components/tvplanit

Командная строка для этого 

svn co https://lazarus-ccr.svn.sourceforge.net/svnroot/lazarus-ccr/components/tvplanit

Сообщения об ошибках / запросы на новые функции

Отчеты об ошибках и запросы функций должны быть отправлены в Lazarus/Free Pascal Bug Tracker; уточняйте, пожалуйста, что для проекта "Lazarus-CCR": http://bugs.freepascal.org/

Журнал изменений: новые функции

  • 02.02.2008 - Начальный порт (version 1.03)
  • 01.08.2016 - (Почти) полный порт (version 1.04)
  • 28.11.2016 - Перетаскивание, хранилище данных mORMot, новые поля, поддержка праздников, designtime и runtime пакеты (version 1.06)
  • Май, 2018 - Адаптация к Laz1.8 + поддержка high DPI, хранилища данных json.
  • 04.05.2018 - Редактор компонентов NavBar (version 1.10)
  • 21.06.2018 - Новые свойства для VpDayView и VpContactButtons, импорт из файлов vCard и iCal (version 1.2.0)
  • текущий момент
    • (ничего на данный момент)

Несовместимые изменения

  • Версия 1.0.4 больше не компилируется с Delphi.
  • Начиная с v1.0.11, события VpDayView OnDVBeforeDrawEvent и OnDVAfterDrawEvent имеют дополнительный параметр GutterRect. Это было сделано для возможности пользовательской отрисовки фона события/канавки.
  • Начиная с версии 1.0.11, события OnOwnerEditEvent из TVpDayView/TVpWeekView/TVpMonthView, OnOwnerEditContact из TVpContactGrid и OnOwnerEditTask из TVpTaskList имеют новый параметр IsNewEvent, IsNewContact и IsNewTask, чтобы указать пользовательскому редактору, нужно ли редактировать новое событие/контакт/задачу.

Зависимости / Системные требования

  • FPC 2.6.4 или новее
  • Lazarus 1.4.4 или новее
  • Эти версии были доступны на момент написания этого обновления. Не исключено, что пакет можно использовать и с более старыми версиями.

Установка

  • Создайте каталог для компонентов, например, lazarus\components\tvplanit
  • В этом каталоге разархивируйте файлы из zip-файла или выполните командную строку svn, описанную ранее.
  • Откройтеlazarus
  • В версии 1.04 библиотеки пакеты времени разработки и [пакеты] времени выполнения находится сведены в один. Откройте пакет laz_visualplanit.lpk из папки source с помощью Package/Open file (-lpk) и нажмите Compile. Нажмите Use(Использовать) > Install(Установить), если вы хотите установить компоненты в IDE.
  • Начиная с версии 1.06 библиотека будет разделена на пакеты времени разработки и времени выполнения
    • Откройте пакет времени выполнения laz_visualplanit.lpk из корневой папки библиотеки с помощью Package/Open file file (.lpk) и нажмите Compile, чтобы скомпилировать его.
    • Откройте пакет времени разработки laz_visualplanit_design.lpk из той же папки, нажмите Use(Использовать) > Install(Установить).
  • Если вам нужно хранилище данных Zeos, повторите [манипуляции] с пакетом laz_visualplanit_zeos.lpk (и laz_visualplanit_zeos_design.lpk) из папки source/addons/zeos . Убедитесь, что Zeos компоненты установлены.

Прим.перев.: не помню, с какой точно версии, но в Lazarus 1.8.4 уже была доступна установка этого компонента посредством Online Package Manager c установкой пакета Zeos при необходимости.

Документация

Если вам нужна полная документация пакета VisualPlanIt, получите оригинальный 300-страничный PDF-файл TurboPower с официального сайта SourceForge версии под Delphi (https://sourceforge.net/projects/tpvplanit/files/tpvplanit_docs/).

Использование компонентов планировщика

С чего начать

tvplanit tutorial.png

Простой проект

Вот краткое руководство для ваших первых шагов с компонентами VisualPlanIt.

  • Создайте новое приложение. Сохраните его в своей папке.
  • Добавьте TPageControl с тремя вкладками. Назовите их "Events"(События), "Tasks"(Задачи), и "Contacts"(Контакты).
  • В палитре компонентов найдите вкладку Visual PlanIt.
  • Выберите TVpDayView и добавьте его на вкладку "Events" PageControl. Это календарь на день, который отображает события (приемы, встречи и т.д.) на весь день с разрешением, определяемым так называемой Granularity(зернистостью).
    • Если вы привыкли к [отображению] времени в 24-часовом формате, переключите TimeFormat на tf24Hours.
    • Если календарь достаточно широкий, вы можете изменить NumDays на, скажем, 2, чтобы увидеть два дня одновременно.
    • Придайте компонентам более современный вид, установив для DrawingStyle значение dsFlat.
    • Точно так же вы можете добавить TVpWeekView (календарь на неделю) и/или TVpMonthView (календарь на месяц) на вкладку "Events". Они дают обзор тех же событий, но с меньшим разрешением. Текстовое многоточие ("...") отображается, если текст события не может быть отображен полностью.
  • Теперь добавьте TVpTaskList на вкладку "Tasks" в PageControl. Это список дел с указанием сроков. Просроченные задания выделяются красным. Завершенные задачи зачеркиваются. Обратите внимание, что DisplayOptions.ShowCompleted или .ShowAll необходимо пометить, чтобы видеть выполненные задачи.
  • Наконец, добавьте TVpContactGrid на вкладку "Contacts" PageControl.
  • Опять же, вы можете использовать DrawingStyle dsFlat для более современного вида.
  • Поиграйте со свойствами, чтобы настроить все эти визуальные элементы управления в соответствии с вашими предпочтениями. Например, TVpWeekView имеет свойство, определяющее, начинается ли неделя в понедельник или воскресенье (WeekStartsOn).
  • Не хватает двух компонентов: DataStore и ControlLink.
    • Datastore - это компонент, в котором хранятся данные, отображаемые в визуальных элементах управления. Пакет Visual PlanIt содержит ряд предопределенных хранилищ данных - см.ниже. Мы выбираем здесь TVpIniDatastore или TVpXmlDatastore, которые хранят данные в INI или XML-файле - эти хранилища не требуют базы данных, как другие хранилища данных.
    • В свойстве Filename введите имя для файла хранилища данных, например, data.ini или data.xml, соответственно. Использование относительного имени файла здесь означает, что путь будет относительно местоположения exe-файла программы, что удобно для этого урока. Однако в «реальном» приложении абсолютный путь может быть предпочтительным. И также может быть полезно ввести имя файла во время выполнения, например, в обработчике событий FormCreate.
    • Если имя файла известно во время разработки, вы можете установить для AutoConnect значение true, чтобы автоматически открывать хранилище данных при запуске программы. Если имя файла указано во время выполнения, оставьте AutoConnect в false и установите для свойства Connected хранилища данных значение true.
    • ControlLink автоматически устанавливает связь между хранилищем данных и визуальными элементами управления и гарантирует, что элементы управления получают свои данные, если это необходимо, и синхронизируются.
  • Теперь пришло время запустить программу
  • Как добавить данные? Это делается двойным щелчком по любому из добавленных нами элементов управления, чтобы открыть специальный встроенный редактор для удобного ввода необходимых данных.
  • Однако в первый раз появляется диалоговое окно, в котором говорится, что "no resources have been defined"(ресурсы не определены). Resource - это все, что может администрироваться инструментами VisualPlanIt, например, сотрудник, зал заседаний, книжная библиотека и т.д. Введите имя ресурса. Если ваша программа будет работать с различными ресурсами, вы можете добавить [их список в виде] TVpResourceCombobox, чтобы выбрать ресурс, необходимый для запуска программы. Убедитесь, что вы используете уникальные имена ресурсов, потому что VisualPlanIt будет выдавать исключение дубликата ресурса в противном случае.
  • При повторном запуске программы в следующий раз вы заметите, что данные больше не видны. Нет причин для беспокойства - данные все еще там, но программа просто не знает, какой ресурс открыть. Введите этот код в событие FormCreate после подключения к хранилищу данных:
procedure TForm1.FormCreate(Sender: TObject);
begin
  // Используйте этот код, если имя файла не задано в Object Inspector...
  VpXmlDatastore1.FileName := name_of_the_datastore_file;
  // ... и хранилище данных не подключено автоматически
  VpXmlDatastore1.Connected := true;
  // Этот код выбирает первый ресурс (index 0), найденный в хранилище данных 
  if VpXmlDatastore1.Resources.Count > 0 then
    VpXmlDatastore1.Resource := VpXmlDatastore1.Resources.Items[0];  
end;

Категории событий

tvplanit eventeditor.png

Редактор событий используется для ввода или редактирования деталей события. Вы найдете здесь комбинированный список с надписью "Category"(Категория). Элементы комбинированного списка можно использовать для классификации событий, например "Business"(Деловые), "Private"(Личное), "Birthday"(День рождения) и т.д. Однако эти элементы имеют только обобщенные имена, такие как "Category 1", "Category 2" и т.д. Вы можно выбрать более описательные имена, посетив свойство хранилища данных CategoryColorMap. Поле "Descriptions"(Описания) определяет текст, который будет отображаться в выпадающем списке. Чтобы иметь возможность различать категории в элементе управления DayView, вы также можете установить здесь цвет фона и растровое изображение.

Воспроизведение звука события

Компоненты планировщика готовы воспроизводить звук в заранее определенное время до наступления события. Для этого необходимо установить флажок "Reminder"(Напоминание) в редакторе событий.

Есть несколько способов настроить звук:

  • Хранилище данных предоставляет свойство DefaultSound. Указанный здесь звуковой файл будет воспроизводиться всякий раз, когда происходит событие с установленным флажком "Reminder".
  • Кроме того, для каждого конкретного события можно выбрать отдельный звуковой файл, щелкнув значок громкоговорителя рядом с интервалом напоминания.

В Windows звуки воспроизводятся автоматически без дополнительного кода, потому что там встроены универсальные звуковые утилиты. В Linux, однако, это менее стандартизировано. Но хранилище данных предоставляет событие OnPlaySound, где может быть выполнена правильная команда воспроизведения звука. Проект fulldemo в папке examples содержит модуль, который проверяет звуковые движки, обычно доступные в различных системах; этот модуль представляет собой адаптированную версию playsound component от Gordon Bamber в Lazarus components and code repository (https://sourceforge.net/p/lazarus-ccr/svn/HEAD/tree/components/playsoundpackage/).

Хранилища данных

Хранилища данных отвечают за постоянное хранение записей о событиях, задачах и контактах.

Предком этой иерархии классов является TVpCustomDatastore. Он реализует базовую функциональность и предоставляет фундаментальные абстрактные методы, такие как LoadEvents, LoadTasks, LoadContacts, PostResources, PostEvents, PostTasks, PostContacts. Его класс-член Resources (type: TVpResources) хранит все ресурсы в списке как элементы TVpResource. Такой элемент ресурса, в свою очередь, содержит другие списки: Расписание, Задачи и Контакты для всех записей событий, задач и контактов. Доступ к выбранному в данный момент ресурсу можно получить из свойств Resource или ResourceID хранилища данных (последний представляет собой уникальный числовой идентификатор для идентификации ресурса).

TVpCustomDBDatastore, унаследованный непосредственно от TVpCustomDatastore. Это еще один (псевдо-) абстрактный класс, который обеспечивает базовую функциональность базы данных посредством четырех наборов данных: ResourceTable, EventsTable, TasksTable и ContactsTable. Поскольку базы данных имеют очень эффективные методы поиска и фильтрации, эти хранилища данных предоставляют свойство DayBuffer, которое определяет диапазон дат до и после текущей выбранной даты, для которой загружаются записи.

TVpIniDatastore

Это простое хранилище файловых данных, которое наследуется от TVpCustomDatastore. Он хранит записи данных в простой файловой структуре ini. Имя ini-файла должно быть указано в соответствующем свойстве. Файл загружается после того, как хранилище данных было создано, если свойство времени разработки AutoConnect имеет значение true или когда свойство среды выполнения Connected переключено на значение true. Файл сохраняется автоматически, когда Connected возвращается к false - это происходит до уничтожения хранилища данных.

Демонстрационный проект examples/datastores/ini является примером того, как можно использовать хранилище данных ini.

TVpXmlDatastore

Это еще один простой файл хранилища данных. Он работает так же, как хранилище данных ini, за исключением того, что этот файл теперь является XML-файлом. Дерево XML-узлов хранилища данных может быть вставлено в любой существующий XML-файл, например, файлы, записанные TXMLDataStorage. Для этого необходимо указать узел, к которому будут присоединены узлы хранилища данных (свойство ParentNode).

Посмотрите демонстрационный проект в examples/datastores/xml, чтобы увидеть, как работает хранилище данных xml.

TVpBufDSDatastore

Следующие хранилища данных наследуются от TVpCustomDBDatastore. Первая, TBufDSDataset, использует простые таблицы TBufDataset для хранения данных планировщика. Четыре обязательных файла называются "Resources.db", "Events.db", "Contacts.db" и "Tasks.db" и хранятся в папке, указанной свойством Directory. Если AutoCreate имеет значение true, тогда таблицы создаются автоматически при первом запуске программы; в противном случае должен быть вызван метод хранилища данных CreateTables.

Применение этого хранилища данных продемонстрировано в examples/datastores/bufdataset и в examples/fulldemo.

TVpSqlite3Datastore

Это хранилище данных является специализированным хранилищем для таблиц SQLite3. Для этого используются компоненты SQLDB. Вы должны добавить TSQLite3Connection и TSQLTransaction в форму, связать их вместе, используя соответствующие свойства. Свяжите SQLite3Connection с Connection хранилища данных. Требуемые SQLQueries создаются автоматически, если AutoCreate хранилища данных имеет значение true или после вызова CreateTables. База данных хранится в файле, указанном DatabaseName соединения.

Проект в examples/datastores/sqlite3 демонстрирует, как можно использовать хранилище данных sqlite3.

TVpFirebirdDatastore

База данных Firebird предоставляет хранилище для TVpFirebirdDatastore. Опять же, здесь используются компоненты SQLDB. Чтобы установить соединение с базой данных, TIBConnection должен быть связан с Connection хранилища данных. Он должен предоставить всю информацию для подключения к базе данных, такую как имя базы данных, имя пользователя и пароль. Кроме того, необходим компонент TSQlTransaction. База данных должна создаваться средствами, предоставляемыми Firebird, или сторонними инструментами администрирования базы данных. Это можно сделать и из хранилища данных, но это приводит к исключению. Если в хранилище данных AutoCreate необходимые таблицы создаются автоматически, когда они не найдены; В качестве альтернативы вызовите CreateTables для хранилища данных.

Использование хранилища данных показано в examples/datastores/fb.

TVpZeosDatastore

TvPlanit FieldMapping.png

TVpZeosDatastore работает с Компонентами базы данных ZEOS. Поскольку они отсутствуют в стандартном дистрибутиве Lazarus, [компонент] содержится в отдельном пакете laz_visualplanit_zeos, который находится в папке source/addons/zeos и должен быть установлен после [установки самого] laz_visualplanit.

TZConnection требуется для установления соединения с базой данных. Таблицы создаются внутри, либо автоматически, если AutoCreate имеет значение true, либо вручную, вызывая CreateTable.

Демонстрационный проект можно найти в examples/datastores/zeos.

TVpFlexDatastore

В упомянутых выше хранилищах данных, связанных с базой данных, таблицы создаются хранилищем данных. Это гарантирует, что поля [будут] названы так, как ожидается хранилищем данных. С другой стороны, если таблицы уже существуют или предоставляются другими приложениями, весьма вероятно, что имена полей не будут повторно распознаны. TVpFlexDatastore может быть решением [этой проблемы]. Его название указывает на то, что это очень «гибкое» хранилище данных. В частности, можно связываться с любой системой базы данных, если доступен TDataset-потомок.

Вы должны добавить в форму четыре компонента TDataset, каждый из которых соответствует одному из данных Resources, Events, Contacts и Tasks, и связать их с DataSource хранилища данных через компоненты TDataSource. Затем дважды щелкните TvVpFlexDatastore, чтобы открыть FieldMapper. Это инструмент для назначения полей базы данных внутренним полям хранилища данных. Для каждого поля базы данных, которое вы хотите включить в планировщик, выберите соответствующее поле хранилища данных в правом списке. После нажатия кнопки "Add"(Добавить) пара полей отображается в списке "Field Mappings"(Сопоставление полей).

Есть два примера проектов

  • examples/datastores/flex/access демонстрирует, как база данных MS Access может служить для хранения с использованием ODBCConnection и других компонентов SQLDB (есть также readme.txt с пошаговыми инструкциями).
  • examples/datastores/flex/sqlite3 повторяет то же самое для базы данных SQLite3.

Другие хранилища данных

Следующие хранилища данных из исходного дистрибутива Delphi включены в папку с исходниками, но не добавлены в пакет, поскольку для них требуется BDE, который недоступен для Lazarus:

  • TVpBDEDatastore для доступа к базе данных с помощью Borland Database Engine (BDE) (модуль vpbdeds)
  • TVpAdvDatastore для базы данных Advantage (модуль vpadvds)
  • TVpFF2Datastore для баз данных FlashFiler 2 (модуль vpff2ds)
  • TVpDBISAMDatastore для доступа к базе данных DBISAM (модуль vpdbisamds)
  • TVpSQLDatastore (модуль vpsqlds): Это очень общее хранилище данных для любой базы данных sql. Должен быть предоставлен сопряженный класс с потомком TDataset, и должен быть класс, определяющий конкретный SQL-диалект. Для применения в Lazarus потребуется некоторая перестройка свойств, связанных с BDE. Пакет содержит пример доступа к BDE.

Наложение событий

Компоненты DayView и WeekView в основном отображают события одного ресурса. Однако возможно переключиться в overlay mode(режим наложения), где другие ресурсы могут отображаться в тех же элементах управления. Это может быть достигнуто путем назначения ресурса TVResourceGroup (свойство Group): 

type
  TVpOverlayPattern = (opSolid, opClear, opHorizontal, opVertical, opFDiagonal, opBDiagonal, opCross, opDiagCross);

  TVpOverlayDetail = (odResource, odEventDescription, odEventCategory);
  TVpOverlayDetails = set of TVpOverlayDetail;  

  TVpResourceGroup = class
    //...
    property Caption: String;
    property Count: Integer;
    property Items[AIndex: Integer]: TVpResource;
    property Pattern: TVpOverlayPattern;
    property ResourceID: Integer;
    property ReadOnly: boolean read FReadOnly;
    property ShowDetails: TVpOverlayDetails;
  end;

procedure TMainForm.CreateResourceGroup;
const
  NAME_OF_GROUP = '';  // пусто -> используйте взамен описания ресурсов
  PARENT_ID = 1;
  OVERLAYED_ID = 2;
var
  datastore: TVpCustomDatastore;
  grp: TVpResourceGroup;
begin
  datastore := VpControlLink1.Datastore;
  grp := datastore.Resources.AddResourceGroup([PARENT_ID, OVERLAYED_ID], NAME_OF_GROUP);
  grp.ReadOnly := true;
  grp.Pattern := opDiagCross;
  if datastore.Resource <> nil then
    datastore.Resource.Group := grp else
    datastore.Resource.Group := nil;
  datastore.RefreshEvents;  // или: datastore.UpdateGroupEvents;
end;

Идентификаторы наложенных ресурсов указываются в виде массива в первом параметре вызова AddResourceGroup. Первый идентификатор играет особую роль: он относится к ресурсу, к которому присоединена группа. Если этот ресурс отображается в компоненте DayView или WeekView, то события другого указанного идентификатора(ов) накладываются на один и тот же элемент управления.

Уровень детализации, видимый пользователю, просматривающему наложенные события, контролируется свойством ShowDetails группы ресурсов. По умолчанию отображается только имя наложенного ресурса. Если необходимо предоставить больше деталей, вы можете добавить другие элементы TVpOverlayDetails. Фон наложенных событий в дневном обзоре заштриховывается, как указано в свойстве Pattern группы ресурсов, если категория событий не исключена из видимых деталей; в противном случае событие рисуется, как указано в свойстве HiddenCategories хранилища данных.

Редактирование, удаление, перетаскивание наложенных событий по умолчанию отключено, но это можно разрешить, установив для свойства ReadOnly их группы ресурсов значение false.

Чтобы включить или отключить группы ресурсов, контекстное меню компонентов DayView и WeekView расширено соответствующим подменю. Подменю содержит элемент «none», означающий «нет наложенных событий», а также элемент для каждой группы ресурсов, в которой текущий выбранный ресурс является родительским. Заголовок пунктов меню определяется вторым (необязательным) параметром вызова AddResourceGroup (NAME_OF_GROUP); если поле пустое, имя группы выводится из описаний наложенных ресурсов.

Печать и предварительный просмотр

tvplanit printformatdesigner.png

Пакет VisualPlanIt содержит процедуры для печати элементов управления планировщика. Реализован даже предварительный просмотр печати. Процесс печати определяется с помощью шаблонов, которые здесь называются "print formats"(форматы печати). Они могут быть созданы во время разработки или с помощью XML-файла, загруженного во время выполнения, содержать список компонентов, которые будут напечатаны.

Основой поддержки печати является класс TVpPrinter - он доступен через свойство Printer в TVpControlLink. Он содержит дополнительную информацию, необходимую для процесса печати, и содержит список доступных PrintFormats.

Для быстрого доступа к дизайнеру формата печати дважды щелкните компонент TVpControlLink. Нажмите на верхнюю кнопку "New"(Новый), чтобы открыть редактор основного формата. Здесь вы можете назначить осмысленное имя для формата печати. При нажатии на нижнюю кнопку "Edit"(Редактировать) открывается редактор "Element"(Элемент) - это инструмент для определения содержимого в формате печатной печати, аналогичный дизайнеру отчетов, но менее удобный. В дополнение к элементам управления планировщика, DayView, WeekView, MonthView, TaskList и ContactGrid, редактор также позволяет добавлять в формат дополнительные объекты текста и формы. Несколько элементов могут содержаться в одном формате. Расположите элементы, используя спецификации Top/Left/Width/Height справа. Кроме того, всю страницу формата можно поворачивать с шагом 90°.

«Предварительный просмотр» может быть создан с помощью компонента TVpPrintPreview. Назначьте ControlLink формы для ControlLink и Printer модуля Printers для свойства Printer компонента предварительного просмотра. Для правильной работы печати у вас должен быть [предварительно установлен] пакет Printer4Lazarus в соответствии с требованиями проекта; это проще всего сделать, добавив в форму стандартный TPrintDialog, который вам, возможно, понадобится в любом случае. Откройте предварительный просмотр печати, вызвав его метод Execute. Следует отметить, что сам предварительный просмотр печати не выдает никаких команд печати. Поэтому должен быть написан дополнительный код печати, если пользователь решит начать распечатку из предварительного просмотра, что-то вроде этого: 

if VpPrintPreviewDialog1.Execute then
  if PrintDialog1.Execute then begin
    Printer.BeginDoc;
    try
      VpPrintPreviewDialog1.ControlLink.Printer.Print(
        Printer, 
        VpPrintPreviewDialog1.StartDate, 
        VpPrintPreviewDialog1.EndDate
      );
    finally
      Printer.EndDoc;
     end;
  end;

См. проработанный пример в проекте fulldemo в папке examples.

Локализация

Все внутренние строки, используемые пакетом VisualPlanIt, могут быть локализованы с помощью утилит перевода, доступных в Lazarus. Переведенные po-файлы можно найти в папке languages дистрибутива. Скопируйте их в языковую папку вашего приложения и переведите [его], вызвав 

uses
  translations;
var
  langdir: String;  // языковая папка вашего приложения 
  lang: String;     // аббревиатура языка, например "de" для немецкого
//...
  TranslateUnitResourceStrings('vpsr', langdir + 'vpsr.' + lang + 'po');
Light bulb  Примечание: Пользователям предлагается отправлять [разработчику] переводы ресурсов для своего родного языка.

Помимо предоставления переведенных строк, должны быть адаптированы различные «свойства, относящиеся к дате/времени» элементов управления планировщика:

  • Установите для VpDateView.DateLabelFormat значение DefaultFormatSettings.LongDateFormat, dto. с VpWeekView.DayHeadAttributes.DateFormat и VpWeekView.DateLabelFormat.
  • Установите VpMonthView.DatelabelFormat в строку 'mmmm yyyy', что означает «месяц названием + год».
  • Установите для VpTaskView.DisplayOptions.DueDateFormat значение DefaultFormatSettings.ShortDateformat.
  • Определите TVpTimeFormat вашей системы, вызвав GetTimeFormat (в модуле vpmisc). Результат может быть tf12Hour или tf24Hour и должен быть назначен свойствам TimeFormat VpDayView, VpWeekView и VpMonthView.
  • Установите свойства WeekStartsOn для VpMonthView и VpWeekView в код дня начала недели (1 = воскресенье, ..., 7 = суббота).

Наконец, TVpControlLink реализует процедуры локализации адресов в диалоге редактора контактов. Для этого к пакету VisualPlanIt прилагается файл vplocalize.xml. Он содержит правила для построения адресов в правильном формате, варьирующемся от страны к стране. Если это имя файла назначено свойству LocalizationFile элемента ControlLink, то эти правила вступают в силу при создании диалога редактора контактов. Обратите внимание, что этот файл не переводится с помощью файлов po.

Использование панели навигации

vpnavbar.png

TVpNavBar, показанный справа на этом скриншоте демо navbar, представляет собой инструмент навигации, похожий на тот, который известен в Outlook. Он состоит из нескольких папок, представленных кнопочными элементами управления, и нескольких элементов - это помеченные значки в большом пространстве между двумя кнопками. Кнопка папки, которую можно нарисовать в нескольких стилях, похожих на кнопки или вкладки, всегда отображается над соответствующей областью элемента. Щелчок по папке делит стопку папок на верхнюю и нижнюю части и отображает элементы, назначенные этой папке, между соответствующей папкой вверху и следующей папкой внизу. Индекс развернутой в данный момент папки задается свойством ActiveFolder, а индекс выбранных элементов в этой папке задается свойством ActiveItem. Событие OnItemClick запускается при щелчке элемента, в качестве параметра он имеет индекс выбранного элемента.

Значок может быть назначен каждому элементу. Эти изображения собраны в списке изображений, назначенном свойству Images панели навигации. Изображения обычно должны быть 32x32 пикселей. Свойство IconSize каждой папки определяет, будут ли эти изображения отображаться непосредственно как «большие изображения» или уменьшены в 2 раза (16x16 пикселей) как «маленькие изображения». Уменьшение масштаба выполняется компонентом.

vpnavbareditor.png

Заполнить TVpNavBar во время разработки легко, если версия VisualPlanIt по крайней мере 1.0.10, в которой работает редактор компонентов NavBar. Просто дважды щелкните по компоненту или выберите «Layout Tool ...» в контекстном меню компонента. Откроется редактор компонентов, отображаемый здесь в виде скриншота. Он содержит три списка:

  • Левый список (Folders) показывает папки, найденные на панели навигации. Нажмите кнопку «+», чтобы добавить новую папку, «-», чтобы удалить выбранную папку, или стрелки «вверх»/«вниз», чтобы изменить порядок папок. Свойства выбранной папки отображаются в инспекторе объектов:
    • Укажите Caption папки - это текст, который будет отображаться на кнопке/вкладке папки.
    • Оставьте IconSize в [значении] isLarge, если вы хотите использовать большие значки для элементов этой папки. В этом случае значки и подписи к ним будут отцентрированы, подпись будет находиться под значком и переноситься по словам, если текст длиннее, чем ширина панели навигации. Если же вы выберете isSmall, значки и подписи будут выровнены по левому краю, и (непереносимые по словам) заголовки будут нарисованы справа от значков. IconSize может меняться от папки к папке.
    • Не устанавливайте FolderType равным ftContainer - эта функция для добавления произвольных элементов управления в папку не работает в Lazarus на момент написания этой статьи.
  • В центральном списке (Items/Icons) отображаются элементы, назначенные папке, выделенной в левом списке. Заголовок и значок этого элемента отображаются в каждой строке. Снова нажмите кнопки «+», «-» или стрелки «вверх»/«вниз», чтобы добавить, удалить или изменить порядок элементов. И снова свойства выбранного элемента можно изменить в инспекторе объектов. Помимо Caption, уже упомянутого для папок, есть также свойство ImageIndex, которое указывает значок, отображаемый для элемента. Индекс изображения относится к списку изображений, назначенному свойству Images панели NavBar.
  • Правый список (Availabel images) содержит все изображения, найденные в ImageList. Он предназначен для упрощения назначения значков элементам: выберите элемент, для которого должен быть выбран значок. Выберите значок в правом списке изображений и нажмите на стрелку между списком элементов и изображений.

Если версия VisualPlanIt древнее, чем версия 1.0.10, получение папок и элементов в NavBar будет немного сложнее, поскольку редактор компонентов еще не был перенесен/адаптирован для Lazarus. В этом случае лучше всего изучить эту задачу с помощью инспектора объектов:

  • Добавьте компонент TVpNavBar в форму.
  • Добавьте список изображений, в идеале с размерами 32x32, и назначьте его свойству Images панели NavBar.
  • Нажмите кнопку «...» рядом с FolderCollection, чтобы открыть редактор коллекций для папок.
  • Нажмите "Add"(Добавить), чтобы добавить новую папку.
  • Выберите новую папку в редакторе коллекции, ее свойства появятся в инспекторе объектов и могут быть изменены там.
  • Чтобы добавить элементы в папку, нажмите ItemCollection. Откроется редактор коллекции для элементов, принадлежащих текущей папке.
  • Снова нажмите "Add"(Добавить), чтобы создать новый элемент, и выберите его в редакторе коллекции, чтобы ввести его свойства в инспекторе объектов.

Гаджеты

vpgadgets.png

В дополнение к компонентам планировщика пакет Visual PlanIt содержит также два автономных гаджета:

TVpLEDLabel

Это 14-сегментный светодиодный дисплей, который может отображать любую строку ASCII. Строка определяется с помощью свойства Caption, но количество светодиодных символов должно быть определено явно с помощью свойства Columns

TVpClock

Это цифровые или аналоговые часы - в зависимости от свойства DisplayMode. Разнообразие настроек можно применять для каждого режима отдельно, используя свойства в AnalogOptions и DigitalOptions. Свойства в значительной степени говорят сами за себя, за исключением, возможно, DigitalOptions.MilitaryTime, который активирует 24-часовое отображение, если true, или 12-часовой режим am/pm, если false. AnalogOptions.ClockFace заменяет нарисованный по умолчанию циферблат часов растровым изображением - см. Скриншот выше.

С помощью свойства ClockMode работа часов может быть изменена со стандартных часов (cmClock) [на другие] (секундомер или таймер обратного отсчета, cmTimer и cmCountdownTimer соответственно).

Retrieved from "http://wiki.freepascal.org/index.php?title=Turbopower_Visual_PlanIt/ru&oldid=133711"