GetStandardIcon

From SunFlurry wiki
Revision as of 12:03, 6 June 2019 by Admin (talk | contribs) (Created page with "{{infobox function |name=GetStandardIcon |object=Функции общего назначения |caption=Системные функции |type=1 |status=2 |db=0 |excep...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
  GetStandardIcon (Системные функции)
Объект:Функции общего назначения
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Нет
Исключения:Невозможно превратить в число, не объект базы данных
Визуальность:Нет

Функция возвращает индекс стандартной иконки указанного объекта базы данных, данные индексы не совпадают с номерами иконок из библиотеки иконок и могут быть использованы только для столбцов визуальных таблиц, имеющих тип "стандартная иконка". Различное состояние объекта (удален, новый и пр.) отображается разными иконками. Возможно также указание на то, что иконка находится для открытой папки справочника. Функция обычно используется внутри событий, типа OnInitLine, когда выводимая иконка должна соответствовать состоянию объекта базы данных, не совпадающего с загруженным (находящегося в другом столбике) или подобных ситуациях.

Синтаксис

GetStandardIcon(<Объект базы данных (DB)>,<Закрепленная строка папок (INT)>=0):<Индекс стандартной иконки объекта (INT)>

Аргументы

  • <Объект базы данных (DB)> - Объект базы данных, индекс стандартной иконки которого необходимо найти.
  • <Закрепленная строка папок (INT)> - (необязательный аргумент) Для закрепленной (неподвижной) строки с открытыми папками, параметр должен быть равен 1 (так как иконки папок для такой строки должны выглядеть открытыми), иначе 0 (по умолчанию).

Возвращаемое значение

Возвращает число-индекс иконки, которое затем можно использовать в вызове функции Tab.Icon.

Примеры

//Отрезок кода из обработчика события OnInitLine
//MainTab -- вызывающая таблица, строчная часть текущего элемента, в элементах строчной части присутствует реквизит Номенклатура
//  иконку которого необходимо вывести (для папки, иконку папки, для удаленных элементов, иконку удаленного элемента)
//Без использования функции GetStandardIcon, в таблицу будет выведена иконка строки строчной части, что неинформативно и нежелательно в данном случае.
MainTab:=Form.MainTab.Value;  
For i:=IndexFrom to IndexTo Do
  MainTab.CurLine:=i;
  MainTab.Icon(i,"Icon",GetStandardIcon(MainTab.Номенклатура));
Enddo;