Картинка (Picture)

<< Click to Display Table of Contents >>

Navigation:  Раздел 7 Расширения языка L9 > Объекты пользовательского интерфейса > Объекты для работы с картинками >

Картинка (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);