Компоненты Delphi страницы Standart

Компонент Delphi ListBox




Уроки Delphi
  1.  Первая программа
  2.  Использование компонентов
  3.  События Delphi
  4.  Типы данных Delphi
  5.  Создание своих типов данных
  6.  Выражения и операторы
  7.  Работа с файлами в Delphi
  8.  Дополнительные формы
  9.  Подпрограммы в Delphi
  10. Исключительные ситуации
  11. Взаимодействие приложения с пользователем
  12. Указатели в Delphi
  13. Обзор компонентов
  14. Работа со строками
  15. Создание интерфейса
  16. Графика в Delphi
  17. Многопоточность в Delphi
  18. Динамическое создание
        компонентов
Поиск по сайту




 Это важно:
   Метод Application.ProcessMessages;

 Это полезно:
   Параметр Sender в обработчиках событий;










Бояться не надо





   Компонент Delphi ListBox это компонент, служащий для хранения и обработки текстовой информации. Каждая строка Delphi ListBox хранит строку данных в формате String.

Компонент Delphi ListBox
на этапе конструирования
Компонент Delphi ListBox
на Форме в рабочей программе

   Компонент ListBox - это массив строк. ListBox может загружать данные с диска, и сохранять информацию в файл. Также ListBox может сортировать строки. Доступ к строкам предоставляет свойство Items этого компонента. В соответствии с этим, вот как происходит обращение к строке с номером i:

   ListBox1.Items[i-1]; // Минус один, так как нумерация строк в компоненте начинается с нуля.

   Прежде всего рассмотрим методы добавления строк в компонент Delphi ListBox:

  1. Считывание из файла;
  2. Добавление строки в конец списка;
  3. Добавление строки перед строкой с номером i;
  4. Добавление строк на этапе конструирования.

Методы добавления строк в компонент Delphi ListBox

Считывание из файла

   Компонент Delphi ListBox может обращаться напрямую к текстовому файлу как для считывания информации из файла, так и для сохранения всех своих строк в текстовый файл. Каждая запись в файле будет записана в виде одной строки компонента, и при сохранении каждая строка будет сохранена в виде одной записи файла:
   ListBox1.Items.LoadFromFile('Имя_Файла');  // Процедура считывания из файла
   ListBox1.Items.SaveToFile('Имя_Файла');  // Процедура записи в файл

Добавление строки в конец списка

   Программист может последовательно добавлять строки в компонент, не заботясь об их нумерации, и они будут размещаться в конец списка:
   ListBox1.Items.Add('Новая_Строка'); //Добавление строк в конец списка
Так как количество строк в компоненте равно ListBox1.Items.Count, то новая (последняя) строка имеет номер ListBox1.Items.Count-1. Это объясняется тем, что нумерация строк начинается от 0.

Добавление строки перед строкой с номером i

   Программист может разместить новую строку среди существующих строк там, где ему необходимо. Для этого нужно воспользоваться методом Insert, и указать номер строки, перед которой необходимо записать новую строку:
   ListBox1.Items.Insert(i, 'Новая_Строка');  // Добавление строки перед строкой с номером i
При этом новая строка получает номер i.

Добавление строк на этапе конструирования

   В Инспекторе Объектов зайдите на строчку Items и нажмите на появившуся кнопку. Появится окно редактора содержимого, где и можно внести нужную информацию. После нажатия кнопки OK содержимое редактора появится в компоненте ListBox на Форме.


Пользователь может выделить строку, щёлкнув по ней мышкой. Номер выделенной строки возвращает свойство компонента ListBox.ItemIndex. То есть, получить текст выделенной строки можно так:

   S := ListBox1.Items[ListBox1.ItemIndex];

Не забывайте пользоваться оператором присоединения with. С его использованием это присваивание выглядит так:

with ListBox1 do
  begin
    S := Items[ItemIndex];
  end;


   При многократном использовании свойств компонента данная запись очень экономит силы. Кстати, оператор присоединения допускает работу с несколькими компонентами, которые нужно разделить запятой. Например, присваивание строки компонента ListBox ячейке таблицы StringGrid выглядит так:

with ListBox1, StringGrid1 do
  begin
    Cells[i, j] := Items[ItemIndex];
  end;


Для удаления строк из компонента применяется метод Delete. Удаление строки с номером i:

   ListBox1.Items.Delete(i);

   Чтобы при добавлении каждая строка была отсортирована (сортировка идёт только по возрастанию), нужно установить:

   ListBox1.Sorted := True;

Также возможно установить это свойство на этапе конструирования в Инспекторе Объектов.

   К сожалению, компонент не обладает возможностью добавлять только уникальные данные. Один и тот же текст запишется несколько раз. Для реализации этой возможности приходится дополнительно применять невизуальный аналог компонента ListBox - объект StringList, обладающий такой возможностью:

procedure TForm1.Button1Click(Sender: TObject);
var SL: TStringList;
S: String;
begin
SL:=TStringList.Create; // Создаём список строк типа TStringList
SL.Sorted:=True; // Устанавливаем свойство - сортировать строки
SL.Duplicates:=dupError; // Устанавливаем свойство - дубликаты вызывают ошибку добавления
try
  SL.Add(S); // Пробуем добавить строку в объект StringList
  ListBox1.Items.Add(S); // Добавляем строку в компонент ListBox
except
  Caption:='Попытка добавить дубликат';
  // Попытка добавить дубликат вызовет ошибку в первой строке секции try/except,
  // прерывание и переход к секции except/end.
  // Добавления в ListBox не будет.
end;
end;

   Компонент ListBox автоматически добавит полосу прокрутки, если количество строк не помещается по высоте компонента. Высота каждой строки равна ItemHeight. Если нужно чтобы при добавлении новой строки полоса прокрутки точно не возникла, этот размер нужно добавить к высоте компонента. Но делать это нужно только начиная с определённого количества строк. Поэтому нужно делать проверку:

ListBox1.Items.Add('Новая_строка');
with ListBox1 do
  if (Items.Count > (Height/ItemHeight))
    then Height := Height + ItemHeight;


   Но если высота компонента не нацело делится на высоту строки, то прокрутка всё равно возникнет. Поэтому нужно отнять единичку:

ListBox1.Items.Add('Новая_строка');
with ListBox1 do
  if (Items.Count > (Height/ItemHeight)-1)
    then Height := Height + ItemHeight;


   Однако на долю секунды полоса прокрутки всё-таки появляется. Поэтому сначала сделаем проверку, а затем уже будем добавлять строку. В этом случае уже нужно отнимать не 1, а 2:

with ListBox1 do
  if (Items.Count > (Height/ItemHeight)-2)
    then Height := Height + ItemHeight;
ListBox1.Items.Add('Новая_строка');


Обзор компонентов Delphi           В начало урока          Компонент Delphi ComboBox

Уроки Delphi начинающим







© 2023 Delphi-Manual.ru - Уроки Delphi начинающим с нуля