Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Выпадающий список

Компонент Выпадающий список предоставляет возможность выбора одного из нескольких заранее определенных элементов. Каждый элемент в выпадающем списке имеет индекс – порядковый номер позиции. Нумерация начинается с 0 (первый элемент – 0, второй – 1 и т. д.). Индексы применяются для обращения к конкретным элементам при получении, изменении, вставке или удалении.

Выпадающий список используется для различных сценариев, где требуется выбор из заранее определённых вариантов. Например, для выбора пользователей при авторизации в системе безопасности и т.д.

Как заполнить выпадающий список при открытии формы

Чтобы заполнить выпадающий список данными при открытии формы:

  1. Добавьте на форму компонент Выпадающий список.
  2. Настройте обработчик события AboutToOpened формы. Используйте методы Clear() и AddItem() для очистки и заполнения списка. Пример кода: 

    ComboBox_1.Clear();
    ComboBox_1.AddItem("Администратор");
    ComboBox_1.AddItem("Оператор");
    ComboBox_1.AddItem("Пользователь");

Как отобразить выбранное значение в заголовке формы

Чтобы выбранное значение отображалось, например, в заголовке формы:

Настройте обработчик события Activated выпадающего списка. Используйте метод GetItem() для получения текста выбранного элемента. Пример кода:

selectedText: string = ComboBox_1.GetItem(index);
WindowCaption = selectedText;

Как добавить новый элемент в список

Чтобы можно было добавлять новые варианты в выпадающий список при нажатии кнопки:

  1. Добавьте на форму поле ввода для ввода нового элемента.
  2. Добавьте кнопку, которая будет добавлять элемент.
  3. Настройте обработчик события ButtonPressed кнопки. Используйте метод AddItem() для добавления элемента:

    if (LineEdit_1.Text != "") {
    ㅤㅤComboBox_1.AddItem(LineEdit_1.Text);
    ㅤㅤLineEdit_1.Text = ""; // Очищаем поле ввода
    }

Как изменить текст существующего элемента списка

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

  1. Добавьте на форму кнопку, которая будет изменять текст элемента.
  2. Настройте обработчик события ButtonPressed кнопки. Используйте метод SetItem() для изменения текста элемента по его индексу.

    newText: string = LineEdit_1.Text;
    if (newText != "") {
    ㅤㅤComboBox_1.SetItem(0, newText); // Изменяем текст первого элемента (индекс 0)
    ㅤㅤLineEdit_1.Text = ""; // Очищаем поле ввода
    }

Как проверить, есть ли нужный элемент в списке перед добавлением

Чтобы избежать дублирования элементов при добавлении новых вариантов:

  1. Добавьте на форму кнопку, которая будет добавлять элемент.
  2. Добавьте текстовое поле для отображения сообщений.
  3. Настройте обработчик события ButtonPressed кнопки. Используйте метод IndexOf() для поиска элемента.

    newItem: string = LineEdit_1.Text;
    if (newItem != "") {
    ㅤㅤindex: int4 = ComboBox_1.IndexOf(newItem);
    ㅤㅤif (index == -1) {
    ㅤㅤㅤㅤ// Элемент не найден, можно добавлять
    ㅤㅤㅤㅤComboBox_1.AddItem(newItem);
    ㅤㅤ} else {
    ㅤㅤㅤㅤ// Элемент уже существует
    ㅤㅤㅤㅤText_1.Text = "Такой элемент уже есть в списке";
    ㅤㅤ}
    }

Как добавить элемент в определенное место списка

Чтобы вставить новый элемент не в конец списка, а в конкретную позицию:

  1. Добавьте на форму кнопку, которая будет вставлять элемент в определенную позицию списка.
  2. Настройте обработчик события ButtonPressed кнопки. Используйте метод InsertItem() для вставки в конкретную позицию списка.

    newText: string = LineEdit_1.Text;
    if (newText != "") {
    ㅤㅤComboBox_1.InsertItem(1, newText); // Вставляем на вторую позицию
    ㅤㅤLineEdit_1.Text = ""; // Очищаем поле ввода
    }

Как удалить элемент из списка

Чтобы удалить конкретный элемент из выпадающего списка:

  1. Добавьте на форму кнопку, которая будет удалять элемент.
  2. Настройте обработчик события ButtonPressed кнопки. Используйте функцию RemoveItem() для удаления конкретного элемента из выпадающего списка.

    // Удалить второй элемент (индекс 1)
    ComboBox_1.RemoveItem(1);

Как очистить весь список

Чтобы удалить все элементы из выпадающего списка:

  1. Добавьте на форму кнопку, которая будет очищать список.
  2. Настройте обработчик события ButtonPressed кнопки. Используйте функцию Clear() для очистки всего списка.

    ComboBox_1.Clear();