Основы_C++Builder_часть_1_версия_4

31

Для ввода однострочных текстовых данных используется компонент однострочного редактора Edit. Вводимый текст в формате AnsiString (UnicodeString для С++Builder 2009) помещается в свойство Text. Основные свойства показаны в таблице 5.2.

Таблица 5.2 – Основные свойства компонента Edit

В C++Builder (начиная с версии 6) имеется компонент LabeledEdit на странице Additional. Это смесь компонента Edit и Label, причем метка располагается как комментарий сверху поля однострочного редактора. Его основные свойства аналогичны компоненту Edit, а отличительные черты метки используются в составном поле EditLabel, где, например, задается текст метки в подсвойстве Caption. Свойство LabelPosition указывает, с какой стороны от окна размещается метка: lpAbove - сверху, выровненная по правому краю, lpBelow — снизу, выровненная по левому краю, lpLeft — слева, lpRight — справа.

В С+Builder 2009 добавлен компонент однострочного редактора с кнопками ButtonedEdit. Он является аналогом компонента Edit с добавлением свойств LeftButton и RightButton — объектов левой и правой кнопок. Свойство Visible этих объектов обеспечивает видимость кнопок. Свойство Imagelndex указывает индекс изображения в списке ImageList, с которым связан ButtonedEdit. Компонент имеет события OnLeftButtonClick и OnRightButtonClick, соответствующие щелчкам по левой и правой кнопкам.

Компонент MaskEdit отличается от Edit и LabeledEdit тем, что в нем можно задать строку маски (шаблона) в свойстве EditMask. Это позволяет обеспечить синтаксически безошибочный ввод пользователем определенных данных (номера, адреса, даты, время и т.п.). Маска включает три раздела, разделенные точкой с запятой. В первом разделе - шаблоне записываются

32

символы ввода в каждой позиции и символы, добавляемые самой маской; во втором - 1 или 0 в зависимости от того, надо или нет, чтобы символы, добавляемые маской, включались в свойство Text компонента; в третьем - символ, используемый для обозначения позиции, в которой еще не осуществлен ввод. Прочитать результат ввода можно или в свойствах Text или EditText; последнее содержит введенный текст вместе с символами маски.

5.1.2 Ввод-вывод многострочного текста.

Если требуется ввести или вывести несколько строк текста, то используется компонент многострочного редактора Memo из страницы Standard. Свойства компонента Memo аналогичны Edit, за исключением свойства Text, вместо которого имеется свойство Lines – массив объектовстрок типа TStrings. При выборе свойства в Инспекторе объектов вызывается окно редактора String List Editor (рисунок 5.1), где задаются первоначальные значения строк Memo. В Memo используется одинаковый формат для всего текста, определенный свойством Font.

Рисунок 5.1 – Окно текстового редактора String List Editor C++Builder версии 6.0

Для ввода-вывода форматированного текста следует использовать компонент текстового редактора RichText, который работает с текстом в формате RTF (Rich Text Format). Изменение атрибутов вводимого фрагмента текста выполняется в свойстве SelAttributes, которое имеет составной тип TTextAttributes. Последнее включает подсвойства цвета (Color), наименование шрифта (Name), размер (Size), стиль (Style) и пр.

Свойство DefAttributes определяет параметры, заданные по умолчанию и действующие до их изменения свойством SelAttributes. Это свойство доступно только при выполнении программы, поэтому его значения рекомендуется задавать в обработчиках события форм OnCreate. После модификации параметров текста вернуть обратно значения умолчания возможно с помощью метода Assign свойства SelAttributes.

33

Во время выполнения программы составное свойство Paragraph типа TParaAttributes определяет параметры текущего абзаца текста. Его вложенные свойства рассматриваются в таблице 5.3. Указанные в программе параметры Paragraph применяются к абзацу текста, на котором установлен курсор.

Таблица 5.3 - Вложенные свойства Paragraph компонента RichEdit

Свойство Lines для компонентов Memo и RichEdit является основным и содержит массив строк типа TStrings. Оно может выполнять обмен с данными из текстовых файлов с помощью вложенных методов таблицы 5.4.

Таблица 5.4 – Методы Lines компонентов RichText и Memo для работы с файлами

Пример загрузки текста в компоненту Memo1 из файла help.txt:

Memo1->Lines->LoadFromFile("help.txt");

Свойства Alignment и Wordwrap определяют выравнивание текста и допустимость переноса длинных строк. Задание свойству ReadOnly значения true блокирует модификацию текста, отображаемого компонентами Memo и RichText. Их общее свойство MaxLength ограничивает максимальную длину строк вводимого текста (при его значении 0 нет ограничений).

Свойство ScrollBars определяет наличие полос скроллинга (прокрутки) текстового окна в программе. Может принимать следующие значения:

Весь текст данных компонентов хранится в виде единой строке типа String в свойстве Text. Получение доступа к отдельной строке введенного текста выполняется свойством Strings[номер_строки], которое является подсвойством Lines. Свойство Count указывает число строк введенного

35

Свойство Options определяет множество параметров настроек таблицы: наличие разделительных вертикальных и горизонтальных линий, фиксированных (goFixedVertLine и goFixedHorzLine) и нефиксированных (goVertline и goHorzLine) ячеек, возможность при работе приложения изменения мышью размеров столбцов и строк (goColSizing и goRowSizing), перемещение столбцов и строк (goColMoving и goRowMoving), редактирования данных ячеек таблицы (goEditing) и прочие.

Свойства Col и Row хранят индексы столбца и строки выделенной ячейки таблицы.

Для доступа к массиву значений таблицы используется свойство Cells, которое имеет тип АnsyString или UnicodeString (для С++Builder 2009). Пример оформления заголовка и вывода в таблицу SG1 из N строк значений массивов типа double X[N] и Y[N]:

{SG1->Cells[0][i+1]=IntToStr(i); // Вывод номера SG1->Cells[1][i+1]=FloatToStr(X[i]); // Вывод X[i] SG1->Cells[2][i+1]=FloatToStr(Y[i]); // Вывод Y[i]

}

}//---------------------------------------------------------

Одним из важнейших событий компонента StringGrid является событие OnSelectCell, возникающее в момент выбора ячейки. В его обработчик передаются целочисленные параметры ACol(номер столбца) и ARow (номер строки) выделенной ячейки и логический параметр CanSelect — допустимость выбора ячейки (при CanSelect=false выполняется запрет выделения ячейки).

5.1.4 Ввод дискретных значений.

Для ввода или постепенного изменения дискретных значений используется компонент дискретного переключателя UpDown из палитры Win32. Для удобства он связывается с компонентом однострочного редактора Edit с помощью его свойства Assotiative, в котором указывается имя нужного переключателя. Основные свойства дискретного переключателя указаны в таблице 5.6. Главным свойством компонента является OnClick.

Свойство AlignButton может иметь значение udLeft или udRight, в зависимости от расположения кнопок слева или справа. Свойство Orientation (значение udHorizontal или udVertical) располагает кнопки по вертикали или по горизонтали. Свойство ArrowKeys дает возможность управления компонентом с помощью клавиши клавиатуры со стрелками. Свойство

36

Thousands определяет наличие разделительного пробела между каждыми тремя цифрами разрядов вводимого числа (при true).

Таблица 5.6 − Основные свойства UpDown

Свойства Min и Мах соответственно определяют минимальное и максимальное значения вводимых чисел. Свойство Increment задает приращение числа при нажатии на кнопку. Свойство Position хранит текущее значение числа, отображаемого в окне компонента, связанного с помощью свойства Assotiative.

5.1.5 Выбор значений из готовых списков.

Компоненты ListBox, CheckListBox, ValueListEditor, ComboBox,

ComboBoxE реализуют выбор строки текста из заранее заданных списков. Они позволяют избежать ошибок при вводе текстовых данных, если нужно выполнить выбор из массива альтернативных значений.

ListBox и CheckListBox выполняют выбор нужной строки из представленных списков. Их основным свойством является Items типа TStrings, которое содержит список строк альтернативных вариантов ввода. При работе приложения можно менять состав списка с помощью вложенных в Items методов: Clear (очистка списка), Add (добавление новой строки списка) и другими.

В ListBox свойство MultiSelect разрешает выполнять множественный выбор из списка. При его значении, равном false (по умолчанию), выполняется выбор только одного элемента списка.

При выполнении приложения номер выбранной строки из списка помещается в свойство ItemIndex типа int, которое при отсутствии выбора равно -1. При множественном выборе (MultiSelect=true) значение Itemlndex соответствует номеру списка, находящемуся в фокусе ввода. При этом выполняется проверка выбора определенного элемента списка по значению соответствующего элемента логического массива свойства

Selected[номер_строки_списка].

С помощью свойства ExtendedSelect (при значении true) задается способ множественного выбора интервала элемента с фиксацией клавиш Shift и Ctrl, а также переводом курсора к нужным элементам. При ExtendedSelect=false клавиши Shift и Ctrl не используются.

37

Свойство Columns задает число столбцов отображаемого списка, если он не помещается целиком. Свойство Sorted упорядочивает список по алфавиту (при true новые строки в список добавляются в алфавитном порядке, а не в конец). AutoComplete (при true) реализует быстрый поиск строки списка по первому символу.

5.1.6 Список значений.

Компонент ValueListEditor отображает окно редактирования таблицы значений строк вида «имя = значение». Окно имеет две колонки с заголовками Keys и Values, значения которых можно изменить в свойстве TitleCaptions. Свойство Strings типа TStrings содержит список всех строк. Этот список можно заполнить предварительно с помощью Инспектора объекта или программно. Все строки списка должны задаваться в следующем формате:

наименование параметра = значение

Для изменения списка значений String можно использовать все встроенные свойства и методы класса TString, рассмотренные ранее для других компонентов.

Свойство Keys является массивом имен типа AnsiSring или UnicodeString. Первым индексом массива является 1.

Свойство Values позволяет получать доступ к значениям из строки с помощью имени из свойства Key. Его формат имеет следующий вид:

AnsiString Values[const AnsiString Key]

Также возможен доступ к именам и значениям таблицы с помощью свойства Strings: String—>Names (обеспечивает доступ к массиву имен) и Strings—>Values (доступ к массиву значений).

Свойство Cells[номер_столбца][номер_строки] дает доступ к данным таблицы аналогично рассмотренному ранее компоненту StringGrid.

Свойство KeyOptions определяет доступные пользователю операции редактирования колонки имен при работе приложения. Оно является множеством, которое может быть пустым или содержать элементы keyEdit (позволяет редактировать имена в первой колонке), keyAdd (позволяет добавлять в список новые строки клавишей Insert), keyDelete (позволяет удалять выделенную строку клавишей Delete), keyUnique (не позволяет пользователю добавить новую строку с именем, уже имеющимся в списке).

Свойство времени выполнения ItemProps позволяет управлять способом редактирования пользователем значения каждого из элементов списка. Свойство DisplayOptions является множеством следующих элементов doColumnTitles (строка заголовка фиксирована), doKeyColFixed (ширина столбца имен неизменна), doAutoColResize (при изменении ширины компонента ширина колонок автоматически изменяется).

38

Свойство Options содержит множество настроек, управляющих отображением линий таблицы, возможностью изменения размера колонок и др.

5.2 Программирование ввода логических значений

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

1)компонента CheckBox – крестообразного маркера;

2)компонента RadioButton – круглого маркера.

При этом выбор состояния выключателя изменяется с помощью установки мышью маркера в виде крестика или точки соответственно. Основные свойства переключателей показываются в таблице 5.7.

Таблица 5.7 – Основные свойства независимых переключателей

Если необходимо реализовать выбор одного признака из некоторой группы, то следует использовать группу зависимых переключателей RadioGroup или CheckListBox из страницы Standard. В группе объединяется заданное число переключателей, из которых можно установить маркер только у одного. Основные свойства группы переключателей показываются в таблице 5.8.

Таблица 5.8 – Основные свойства группы независимых переключателей

Пример использования группы RadioGroup1 из двух переключателей для задания типа сохраняемого файла графика Chart1:

switch (RadioGroup1->ItemIndex)

{ case 0 : Chart1->SaveToBitmapFile (SavePictureDialog1->FileName+".bmp"); break;

case 1 : Chart1->SaveToMetafile (SavePictureDialog1->FileName+".wmf");

}//----------------------------------------------------------

39

Свойства компонента CheckListBox аналогичны компоненту ListBox.

5.3Программирование управляющих элементов приложения

5.3.1Реализация кнопок.

Простейшие управляющие элементы на приложении возможно запрограммировать с помощью следующих компонентов кнопок:

1)Button – простая командная кнопка из палитры Standard;

2)BitBtn – кнопка с пиктограммой из палитры Additional;

3)SpeedButton – квадратная кнопка инструментов из Additional;

4)RadioButton − переключатель выбора из панели Standard. Важнейшим событием этих компонентов является нажатие (OnClick),

для программирования которого достаточно щелкнуть мышью по кнопке и описать код обработчика в теле открывшейся функции. Важнейшие свойства компонента Button приводятся в таблице 5.9, а BitBtn – в таблице 5.10.

Таблица 5.9 – Важнейшие свойства кнопки Button

5.2.2 Компонент программирования Главного меню.

Главное меню приложения программируется с помощью компонента MainMenu из страницы Standard, которое имеет свойства, указанные в таблице 5.11.

Таблица 5.11 – Основные свойства компонента MainMenu