DroidScript
DroidScript
учимся и разрабатываем

Список

05.04.2019

Списки в используется для отображения перечисляемых величин, а также могут использоваться для вывода каталога товаров. Для создания списка используется конструктор CreateList:

app.CreateList( [] list, float width, float height, [(str)] options )

Параметры:

  • list - список - опции через запятую или массив
  • width - ширина списка
  • height - высота списка
  • options:
    • Опции оформления надписей:
      • Autoselect - не документировано
      • Center - выравнивание по центру
      • FontAwesome – разрешает использовать пиктограммы в надписи
      • Expand - занять внутри скроллера всю высоту
      • Html – разрешает использовать следующие теги в надписи:
        • <a href="...">
        • <img src="...">
        • <font color="..." face="...">
        • <b>, <u>, <i>, <strong>, <tt>
        • <small>, <big>
        • <br>
        • <div>, <p>
        • <h1>,  <h2>, <h3>, <h4>,  <h5>, <h6>
        • <sub>, <sup>
      • Horiz - располагает тело за заголовком в строку
      • Menu - включает режим отображения "Меню"
      • Monospace - моноширинный шрифт
      • Normal - не документировано
      • ShowsScroll - отображать полосы прокрутки
    • Опции оформления опций:
      • AlumButton - опции списка в виде алюминиевых кнопок
      • DarkButton - тёмные кнопки
      • GreenButton - опции списка в виде зелёных кнопок
      • OrangeButton - опции списка в виде оранжевых кнопок
      • WhiteGrad - опции списка на белом градиентном фоне
    • Опции действий:
      • NoSound - не воспроизводить звук при нажатии

Опция списка можетт состоять из четырёх компонентов, разделённых символом двоеточия:

  • title : icon - заголовок : пиктограмма
  • title : body : icon - заголовок : основной текст : пиктограмма
  • title : body : extra : icon - заголовок : основной текст : дополнительный текст : пиктограмма

Тип пиктограммы может быть задан следующими строками:

  • “folder” - папка
  • “audiofolder” - папка с аудиофайлами
  • “photofolder” - папка с фотографиями
  • “videofolder” - папка с видеофайлами
  • “audio” - аудиофайл
  • “photo” - фотография
  • “video” - видео
  • “playlist” - список для воспроизведения

Если в тексте записи нужно использовать символ двоеточия, то его указывают последовательностью симаолов ^c^.

Список имеет непрозрачный фон.

Базовый пример

Выполнить в DS

Методы списков:

  • AddItem( str title, str body, str image ) - добавляет опцию в список
    Выполнить в DS
    myObject.AddItem( 'Заголовок', 'Описание', null );
  • GetItem( string title ):{} - возвращает заданную заголовком опцию
    Выполнить в DS
    app.ShowPopup( JSON.stringify(myObject.GetItem( 'Товар 1' )));
  • GetItemByIndex( int index ){} - возвращает заданную индексом опцию
    Выполнить в DS
    app.ShowPopup( JSON.stringify( myObject.GetItemByIndex( 4 )));
  • GetLength():int - возвращает количество опций
    Выполнить в DS
    app.ShowPopup( myObject.GetLength());
  • GetList( str delim ):[] - возвращает список с возможным указание символа разделителя
    Выполнить в DS
    app.ShowPopup( myObject.GetList( '.' ));
  • GetTextSize( ('px','dip','sp','mm', 'pt') mode ):float - возвращает размер шрифта надписи в заданных единицах
    Выполнить в DS
    app.ShowPopup( myObject.GetTextSize( 'sp' ));
  • GetType():str - возвращает тип объекта
    Выполнить в DS
    app.ShowPopup( myObject.GetType() );
  • InsertItem( int index, str title, str body, str image ) - вставляет опцию в заданную индексом позицию
    Выполнить в DS
    myObject.InsertItem( 0, 'Новая запись' );
  • RemoveAll() - очищает свисок
    Выполнить в DS
    myObject.RemoveAll();
  • RemoveItem( str title ) - удаляет опцию c заданным заголовком
    Выполнить в DS
    myObject.RemoveItem( 'Новая запись' );
  • RemoveItemByIndex( int index ) - удаляет опцию по заданному индексу
    Выполнить в DS
    myObject.RemoveItemByIndex( 0 );
  • ScrollToItem( str title, str body ) - прокручивает список к заданной заголовком и телом опции
    Выполнить в DS
    myObject.ScrollToItem( 'Товар 5', 'Описание 5' );
  • ScrollToItemByIndex( int index ) - прокручивает список к заданной индексом опции
    Выполнить в DS
    myObject.ScrollToItem( 3 );
  • SetItem( str title, str newTitle, str newBody, str newImage ) - Заменяет параметры заданной заголовком опции
    Выполнить в DS
    myObject.SetItem( 'Новая запись', 'Новый заголовок' );
  • SetItemByIndex( int index, str newTitle, str newBody, str newImage ) - изменяет параметры заданной индексом опции
    Выполнить в DS
    myObject.SetItemByIndex( 0, 'Новости', 'Новый текст', '/Sys/Img/Droid1.png' );
  • SetColumnWidth( str icon, str title, str body, mode) - задааёт ширину
  • SetDivider( float height, str color ) - задаёт высоту и цвет разделителя опций
    Выполнить в DS
    myObject.SetDivider( 0.1, '#ff000077' );
  • SetEllipsize( ('start','middle','end') mode ) - устанавливает многоточие в начале, середине или конце заголовка
    Выполнить в DS
    myObject.SetEllipsize( 'end' );
  • SetEllipsize1( ('start','middle','end') mode ) - устанавливает многоточие в начале, середине или конце текста
    Выполнить в DS
    myObject.SetEllipsize1( 'start' );
  • SetEllipsize2( ('start','middle','end') mode ) - устанавливает многоточие в начале, середине или конце подтекста
    Выполнить в DS
    myObject.SetEllipsize2( 'middle' );
  • SetFontFile( str file ) - задаёт путь к файлу шрифта
    Выполнить в DS
    myObject.SetFontFile ( '/system/fonts/DroidSans.ttf' );
  • SetHiTextColor1( clr ) - не документировано

  • SetHiTextColor2( clr ) - не документировано
  • SetIconMargins( float left, float top, float right, float bottom, str mode) - задаёт внешние отступы для пиктограмм
  • SetIconSize( float size, str mode) - задаёт размер пиктограмм
    Выполнить в DS
    myObject.SetIconSize( 0.5 );
  • SelectItem( str title, str body, bool scroll ) - выбирает опцию, если совпал заголовок/заголовок и тело с возможностью прокрутки к ней (scroll = true)
    Выполнить в DS
    myObject.SelectItem( 'Новый заголовок', 'Описание', false );
  • SelectItemByIndex( int index, bool scroll ) - выбирает опцию по индексу с возможностью прокрутки к ней (scroll = true)
    Выполнить в DS
    myObject.SelectItemByIndex( 2, true );
  • SetList( [] list, str delim ) - устанавливает список опций с возможным указанием символа разделителя
    Выполнить в DS
    myObject.SetList( '1;2;3', ';');
  • SetOnLongTouch( callback ) - задаёт ФОВ для обработки долгого касания
    Выполнить в DS
    myObject.SetOnLongTouch( function(){ app.ShowPopup( 'Долгое касание' ); });
  • SetOnTouch( callback( str title, str body, str type, int index) ) - задаёт ФОВ для обработки выбора элемента списка при касании. Система передаёт методу параметры:
    • title - заголовок
    • body - текст
    • type - название значка
    • index - индекс записи
    Выполнить в DS
    myObject.SetOnTouch( function( p_title ){ app.ShowPopup( 'Выбран элемент с заголовком' + p_title ); });
  • SetTextColor( str clr ) - задаёт цвет заголовка
    Выполнить в DS
    myObject.SetTextColor( 'red' );
  • SetTextColor1( str clr ) - задаёт цвет подзаголовка 1
    Выполнить в DS
    myObject.SetTextColor1( 'bue' );
  • SetTextColor2( str clr ) - задаёт цвет подзаголовка 2
    Выполнить в DS
    myObject.SetTextColor2( '#ff678965' );
  • SetTextMargins( float left, float top, float right, float bottom, ('inner', 'outer') option) - задаёт отступы для текста
    Выполнить в DS
    myObject.SetTextMargins( 0.1, 0, 0, 0, 'inner' );
  • SetTextShadow( int radius, int dx, int dy, str color ) - задаёт тень заголовку заданного радиуса действия, смещения и цвета
    Выполнить в DS
    myObject.SetTextShadow( 2, 1, 1, ''#ff333333' );
  • SetTextShadow1( int radius, int dx, int dy, str color ) - задаёт тень тексту заданного радиуса действия, смещения и цвета
    Выполнить в DS
    myObject.SetTextShadow1( 2, 1, 1, ''#ff33ff33' );
  • SetTextShadow2( int radius, int dx, int dy, str color ) - задаёт тень подтексту заданного радиуса действия, смещения и цвета
    Выполнить в DS
    myObject.SetTextShadow2( 2, 2, 2, ''#ffff3333' );
  • SetTextSize( int size, ('px','dip','sp','mm', 'pt') mode ) - задаёт размер шрифта заголовка
    Выполнить в DS
    myObject.SetTextSize( 20, 'sp' );
  • SetTextSize1( int size, ('px','dip','sp','mm', 'pt') mode ) - задаёт размер шрифта текста
    Выполнить в DS
    myObject.SetTextSize1( 18, 'sp' );
  • SetTextSize2( size, ('px','dip','sp','mm','pt','normal') mode ) - задаёт размер шрифта подтекста ('normal' - отключает жирное начертание)
    Выполнить в DS
    myObject.SetTextSize2( 16, 'normal' );
© 2016-2024 
actech