Картинка (Picture)

Объект «Картинка» («Picture») предназначен для работы с графическими объектами, используемыми в интерфейсе мобильного приложения. Картинки физически хранятся в виде графических файлов в заданной папке. В локальной БД мобильного приложения хранятся ссылки на графические файлы, при этом идентификация картинок происходит при помощи ГУИД (GUID).

Объект «Картинка» («Picture») можно создать c помощью оператора «Новый» («New»), используя имя типа «Картинка» («Picture»). Для объекта могут быть использованы следующие формы конструктора:

Первая форма конструктора – объект «Картинка» («Picture») создается из файла или по идентификатору изображения в конфигурации.

Новый Картинка(<Строка>, <Флаг>)

New Picture(<String>, <Flag>)

Параметры:

Строка (String) – строковое значение, полный путь к файлу картинки или уникальный строковый идентификатор картинки согласно конфигурации (из XML-файла).

Флаг (Flag) – число или строковое значение, показывающее, как интерпретировать переданную строку.

Возможные значения параметра «Флаг» («Flag»):

• 1 или «файл» или «file» – значение параметра «Строка» («String») интерпретируется как полный путь к файлу. 
• 2 или «картинка» или «image» – значение параметра «Строка» («String») интерпретируется как идентификатор картинки из ресурсов (согласно конфигурации). 

Примечание: Если объект не создается, то возвращается значение «Неопределено» («Undefined»). Объект не создается, если файла по переданному пути не существует или объекта с указанным идентификатором нет в ресурсах.

Примеры:

//Переданная строка интерпретируется как полный путь к файлу
Картинка = Новый Картинка(«/sdcard/my_pictures/my_picture.jpg», 1);
Картинка = Новый Картинка(«/sdcard/my_pictures/my_picture.jpg», «файл»);

 
//Переданная строка интерпретируется как идентификатор картинки из ресурсов
Картинка = Новый Картинка(«PictureId», 2);

Вторая форма конструктора – объект «Картинка» создается по идентификатору изображения в базе данных.

Новый Картинка(<Идентификатор>)

New Picture(<Id>)

Параметры:

Идентификатор (Id) – идентификатор картинки (объект ГУИД (GUID)). Объект «Картинка» («Picture») создается по информации из базы данных. Если объекта с указанным идентификатором нет в базе данных, то объект не создается и возвращается значение «Неопределено» («Undefined»).

Пример:

Картинка = Новый Картинка(Новый ГУИД(«09A2B611-07DB-4D09-BB88-9C6681F102AC»));

Третья форма конструктора – объект «Картинка» создается в соответствии с заданными размерами.

Новый Картинка(<Ширина>, <Высота>)

New Picture(<Width>, <Height>)

Параметры:

Ширина (Width) – ширина картинки.

Высота (Height) – высота картинки.

Пример:

Картинка = Новый(«Картинка, 240, 320»);