Палитра компонентов Kylix

Свойства основных компонентов Kylix

Рассмотрим свойства, которые имеют стандартные компоненты Kylix. Для начала - основные свойства, которые присущи компонентам - наследникам класса TControl. Кроме краткого описания свойства, мы будем приводить строку кода, описывающего данное свойство внутри класса TControl. Это поможет вам понять, какой тип имеет данное свойство.
Свойство Action предназначено для определения действия, связанного с элементом управления (меню, кнопкой и т. д). Оно описывается в классе TControl следующим образом:

property Action: TBasicAction;

Значение этого свойства устанавливается во время разработки приложения, путем выбора из выпадающего списка предусмотренных действий. Данный список формируется путем размещения на форме компонента TActionList и задания его свойств.
Свойство ActionLink устанавливает связь между элементом управления и действием, определенным в свойстве Action. Оно описывается следующим образом:

property ActionLink: TControlActionLink;

Свойство Align предназначено для задания способа выравнивания компонента внутри компонента контейнерного типа. Оно описывается так:

property Align: TAlign;

Перечислим возможные значения данного свойства:
aiNone - компонент остается на том месте, где он был размещен во время разработки приложения. Данное значение присваивается свойству Align по умолчанию;
alTop - компонент занимает всю верхнюю часть компонента-контейнера. Во время выполнения приложения ширина компонента зависит от ширины компонента-контейнера. Высота компонента остается неизменной, независимо от высоты контейнера;
alBottom - аналогичен aiTop, за исключением того, что компонент занимает всю нижнюю часть компонента-контейнера;
aliLeft - компонент занимает всю левую часть компонента-контейнера. Во время выполнения приложения высота компонента зависит от высоты компонента-контейнера. При изменении ширины компонента-контейнера ширина компонента остается неизменной;
alRight - аналогичен alLeft, за исключением того, что компонент занимает всю правую часть компонента-контейнера;
alClient - компонент занимает всю клиентскую часть компонента-контейнера. При изменении высоты и ширины компонента-контейнера изменяются высота и ширина компонента. Если в клиентской части компонента контейнерного типа уже имеются другие компоненты, то данный компонент занимает всю оставшуюся незанятой часть компонента-контейнера.

Примечание
Значения alTop и alBottom имеют больший приоритет по сравнению со значениями alLef t и alRight. Таким образом, если вы вывели на форму два компонента, присвоив свойству Align одного из них значение aiTop, а другому - alRight, то первый компонент вытеснит верхнюю часть второго компонента (рис. 8.12).

Свойство Anchors предназначено для определения привязки компонента к родительскому компоненту при изменении размеров родительского компонента. Оно определяется следующим образом:

property Anchors: TAnchors;

Это свойство имеет тип множества (TAnchors), которое может содержать
такие элементы:
akTop - компонент привязан к верхнему краю родительского компонента;
akLeft - компонент привязан к левому краю родительского компонента;
akBottom - компонент привязан к нижнему краю родительского компонента; akRight - компонент привязан к правому краю родительского компонента.



Рис. 8.12. Применение свойства Align

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

property BoundsRect: TRect;

Примечание
Настоящие координаты можно получить из следующих свойств компонента: Left (левый край компонента), Тор (верхний фай), width (ширина компонента) и Height (высота). Описание этих свойств приводится ниже.

Таким образом, запись

R :=Control.BoundsRect;

эквивалентна записи

R.Tор := control.Top;
R.Left := Control.Left;
R.Right := Control.Left + Control.Width;
R.Bottom := Control.Top + Control.Height;

Началом координат считается левый верхний угол окна, содержащего данный компонент.
Свойство caption связывает с компонентом некоторую строку текста, поясняющую его назначение. Данная строка является обычно заголовком компонента (заголовком кнопки, метки, пункта меню и др.). Это свойство описывается следующим образом:

property Caption: TCaption;

По умолчанию свойство устанавливается таким же, как имя компонента (свойство Name). Для пунктов меню и кнопок с помощью этого свойства можно задать кнопку быстрого вызова, для чего перед символом кнопки быстрого вызова ставится символ амперсанда (&). Например, для быстрого вызова меню Файл перед буквой "Ф" в свойстве Caption данного пункта меню можно поставить знак амперсанда: &Файл. При этом буква "Ф" в пункте меню станет подчеркнутой. Теперь для вызова данного пункта меню пользователю будет достаточно воспользоваться комбинацией клавиш <Alt>+<Ф>. Для того чтобы отобразить в заголовке символ &, вы можете использовать такую запись: &&.
Свойство ciientHeight предназначено для установки или чтения высоты клиентской области компонента. Это свойство описывается так:
property CiientHeight: Integer;

Оно применяется при изменении размеров компонента, которые содержат в себе другие компоненты. При таком изменении будет происходить изменение компонентов, содержащихся в компоненте-контейнере.
Свойство clientorigin предназначено для получения экранных координат (х и у) левого верхнего угла клиентской области компонента. Началом координат является верхний левый угол экрана. Возвращаемые координаты передаются в структуре типа TPoint. Данное свойство предназначено только для чтения. Оно описано следующим образом:

property ClientOrigin: TPoint;

Свойство clientRect возвращает координаты углов клиентской области компонента. Данное свойство также предназначено только для чтения. Координаты возвращаются в структуре типа TRect. Свойство описывается так:

property ClientRect: TRect;

Вместо вызова данного свойства можно воспользоваться свойствами Rect,
ClientWidth И CiientHeight (они описаны ниже):

Rect (0, 0, ClientWidth, ClientHeight)

Свойство clientwidth предназначено для установки или чтения горизонтального размера клиентской области компонента. Данное свойство описано следующим образом:

property ClientWidth: Integer;

Свойство Color определяет цвет фона компонента. Значение данного свойства может быть или числом, определяющим интенсивность трех основных цветов (красного, зеленого и синего), или константой, определенной в Kylix (табл. 8.13).

Таблица 8.13. Константы цвета в среде Kylix

Данные константы цвета, начиная с ciBackground, определяются той цветовой схемой X-Windows, которая установлена пользователем на конкретном компьютере. Эти цвета рекомендуется использовать при разработке приложений для передачи третьим лицам.
Свойство components хранит в себе массив компонентов, владельцем ко-fc торых является данный компонент. Параметр свойств index позволяет выбрать любой компонент из массива, благодаря свойству Component index (см. далее). Индексы компонентов нумеруются, начиная с нуля. Число компонентов, содержащихся в массиве, можно определить с помощью свойства componentcount (см. далее).
Свойство component index определяет индекс (порядковый номер) компонента, содержащегося в компоненте-контейнере, а свойство Componentcount - число компонентов, входящих в данный компонент контейнерного типа.
Рассмотрим пример применения данных свойств. Предположим, что на форме имеется несколько компонентов. Задача - сместить все компоненты, которые присутствуют на форме, кроме компонента Buttoni, вправо на 10 единиц. Для этого можно использовать следующий код:

for i := 0 to Componentcount - 1 do
if (Components[i].Name <> 'Buttoni') then
(Components[i] as TControl).Left: = (Components[i] as TControl).Left + 10;

Свойство constraints определяет размер ограничений, т. е. максимальную и минимальную величины ширины и длины компонента. Оно описывается следующим образом:

property Constraints: TSizeConstraints;

Примечание
Не устанавливайте данное свойство, если вы используете свойства Align или Anchors, т. к. это может привести к конфликту свойств и неправильной работе - приложения.

Свойство controistate предназначено для определения текущего состояния компонента во время выполнения приложения. Данное свойство описано следующим образом:

property Controistate: TControlState;

Значение свойства controlState состоит из набора флагов, обозначения которых приведены в табл. 8.14.

Таблица 8.14. Флаги значения свойства ControдStyle

Свойство controistyie определяет различные атрибуты компонента. Например, может ли компонент быть захвачен мышью, имеет ли компонент фиксированные размеры и др. Данное свойство определяет не экземпляра ры класса, а класс в целом. Оно описано следующим образом:

property ControlStyle: TControlStyle;

Значение данного свойства также состоит из флагов (табл. 8.15).

Таблица 8.15. Флаги значения свойства Controlstyle

Свойство cursor определяет вид указателя мыши, когда он находится над данным компонентом. Оно описывается следующим образом:

property Cursor:TCursor;

В свою очередь, тип TCursor описан так:

type TCursor = -32768 .. 32768;

Kylix имеет встроенные виды указателей. Кроме встроенных, разработчик может помещать в приложение собственные виды указателя мыши. В табл. 8.16 приводятся встроенные типы указателей мыши.

Таблица 8. 16. Указатели мыши

Свойство DragMode определяет поведение компонента в процессе его перетаскивания. Свойство описывается следующим образом:

property DragMode: TDragMode;

Данное свойство может принимать одно из двух значений: dmAutomatic или dmManuai. В первом случае от разработчика не требуется обработки событий. Достаточно щелкнуть кнопкой мыши на компоненте и начать его перетаскивание. Во втором случае компонент не может начать процесс перетаскивания, пока приложение не вызовет метод BeginDrag.
Свойство DragObject содержит значение, определяющее объект перетаскивания, ассоциированный с элементом управления. Данное свойство описано так:

property DragObject: TDragObject;

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

property Enabled: Boolean;

Недоступный компонент (Enabled = false) отображается серым цветом. Он игнорирует события клавиатуры, мыши и таймера. Данное свойство .подменяется для временного ограничения доступа пользователя к компонентам. Например, если вы хотите сделать временно недоступной кнопку, нужно в свойстве Enabled кнопки установить значение false:

Buttonl.Enabled := false;

Свойство Font предназначено для установки шрифта, а также всех его атрибутов (размера, стиля, цвета и т. д.). Описано так:

property Font: TFont;

Свойство Height применяется для задания высоты компонента. Описывается это свойство так:

property Height: Integer;

Свойство HelpContext определяет номер, используемый в контекстно-зависимой справке. То есть задается номер страницы справки, которая будет отображаться на экране, когда пользователь нажмет клавишу <F1>. Данное свойство описано следующим образом:

property HelpContext: THelpContext;

Свойство HelpFile описано следующим образом:

property HelpFile: String;

Данное свойство содержит имя файла, который будет использоваться приложением в качестве файла контекстно-зависимой справки.
Свойство HeipKeyword предназначено для осуществления поиска в файле контекстно-зависимой справки по ключевому слову. Данное свойство описано следующим образом:

property HelpKeyword: String;

Свойство Hint применяется для задания текста всплывающей подсказки. Это свойство описано так:

property Hint: String;

Данное свойство обычно состоит из двух частей, разделяемых символом "I". Например,

Buttonl.Hint := "Открыть | Выбор и открытие файла рисунка";

В данном случае при наведении указателя мыши на кнопку Button1 будет выдана всплывающая подсказка "Открыть", вторая часть подсказки будет выведена в специальную область, отведенную для таких подсказок, например на панель состояния. Разработчик может пользоваться только первой частью подсказки, без использования символа "|". Кроме того, для отображения всплывающих подсказок нужно дополнительно установить свойство showHint в true (см. далее).
Свойство Left применяется для задания координаты левого края компонента. За начало координат всех компонентов берется левый верхний угол клиентской области родительского компонента. Для форм началом координат является левый верхний угол экрана.
Данное свойство описано следующим образом:

property Left: Integer;

Свойство Mousecapture используется для определения факта захвата мышью элемента управления. Данное свойство имеет логический тип и описано следующим образом:

property MouseCapture: Boolean;

Если элемент управления захвачен мышью - возвращается True, иначе - False.

Свойство Name определяет имя компонента, по которому на него ссылаются другие компоненты и которое в дальнейшем используется разработчиком. Данное свойство описано так:

property Name: TComponentName;

Имя задается в процессе разработки программы и не должно изменяться во время работы программы. Kylix по умолчанию самостоятельно дает имена новым компонентам, например: Button1, Button2, Label1 и т. п. Рекомендуется изменять эти имена на более осмысленные.
Свойство Parent определяет родительский компонент контейнерного типа, в пределах которого располагается данный компонент. Это свойство описано следующим образом:

property Parent: TWidgetControl;

Примечание
Важно различать два похожих свойства. Свойство Parent определяет родительский компонент, т. е. тот компонент, на котором располагается данный компонент. Свойство Owner определяет владельца компонента. Владелец - это компонент, который передается в качестве параметра в конструктор данного компонента и который владеет им. Например, форма является владельцем всех расположенных на ней компонентов и одновременно - родителем.

Свойство ParentColor указывает, будет ли данный компонент иметь такой же цвет, как и его предок. Свойство описано так:

property ParentColor: Boolean;

Если вы хотите, чтобы компонент унаследовал значения цвета от своего предка, то установите данное свойство в true. Если это свойство будет иметь значение False, компонент будет использовать цвета, заданные в его собственных свойствах.
Свойство Parent Font предназначено для определения, будет ли для данного компонента использоваться шрифт, применяемый в родительском компоненте контейнерного типа. Например, если на форме находится кнопка, то при установке у данной кнопки свойства Parent Font в true приведет к тому, что надпись на кнопке будет выполнена тем шрифтом, который указан в свойстве Font формы. Данное свойство описано так:

property ParentFont: Boolean;

О Свойство ParentshowHint предназначено для включения и выключения родительского свойства showHint. Оно описано следующим образом:

property ParentshowHint: Boolean;

Данное свойство используется для одновременного разрешения или запрещения показа всплывающих подсказок в пределах некоторой формы или компонента контейнерного типа.
Свойство PopupMenu служит для сопоставления с данным компонентом всплывающего по щелчку правой кнопки мыши меню. Данное свойство описано так:

property PopupMenu: TPopupMenu;

Свойство ScalingFiags служит для определения, какие атрибуты элемента управления могут изменять размеры (масштабироваться). Данное свойство описано следующим образом:

property ScalingFiags: TScalingFlags;

Тип TScalingFlags представляет собой набор флагов, которые описаны в табл. 8.17.

Таблица 8.17. Флаги TScalingFlags

Свойство showHint применяется для включения или выключения показа всплывающих подсказок при задержке указателя мыши над компонентом. Текст подсказки задается в свойстве Hint. Свойство showHint описано следующим образом:

property ShowHint: Boolean;

Свойство Text предназначено для задания или чтения строки текста, связанной с данным компонентом. Данное свойство описано так:

property Text: TCaption;

Это свойство применяется в компонентах типа TEdit и в компонентах-списках.
Свойство тор применяется для задания или чтения значения, определяющего координату верхнего края компонента. Данное свойство описано следующим образом:

property Top: Integer;

Свойство visible применяется для определения, будет ли виден компонент на форме во время выполнения программы. Оно описано так:

property Visible: Boolean;

Если свойство имеет значение true, то компонент будет виден, иначе - невидим.
Свойство Width применяется для установки горизонтального размера компонента, а также для чтения текущего значения ширины компонента. Данное свойство имеет целый тип и описано следующим образом:

property Width: Integer;

Рассмотрим теперь свойства, характерные для класса TWidgetcontroi и его наследников.
Свойство Bitmap служит для задания растрового изображения, которое отображается как фоновый рисунок элемента управления. Данное свойство в классе TWidgetcontroi описано следующим образом:

property Bitmap: TBitmap;

Свойство Brush предназначено для установки цвета и кисти для закраски фонового изображения элемента управления. Данное свойство описано так:

property Brush: TBrush;

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

property ChildHandle: QwidgetH; library;

Свойство controicount возвращает число дочерних элементов управления от данного. Оно описано так:

property ControlCount : Integer;

Это свойство применяется только для чтения. Значение, хранящееся в данном свойстве, всегда на единицу больше, чем самый последний индекс дочернего элемента (см. свойство controls ниже), т. к. первый индекс всегда равен нулю.
Свойство controls представляет собой массив, содержащий список всех дочерних элементов управления по отношению к данному элементу. Это свойство описывается следующим образом:

property Controls [Index: Integer]: TControl;

Примечание
Не путайте свойство Controls со свойством Components. Свойство Controls содержит список всех дочерних окон от данного, а свойство Components - список всех компонентов, владельцем которых этот компонент является.

Данное свойство применяется только для чтения. Для добавления или удаления дочерних элементов управления используйте соответствующие методы InsertControl И RemoveControl.
Свойство Handle обеспечивает доступ к дескриптору окна элемента т управления. Описано следующим образом:

property Handle: QWidgetH read GetHandle; library;

Данное свойство применяется только для чтения.

Свойство InputKeys определяет тип клавиш, которые могут применяться для ввода, информации внутри данного элемента управления при получении им фокуса. Свойство описано следующим образом:

property InputKeys: TInputKeys;

Стоит сказать несколько слов о типе TInputKeys. Этот тип представляет colt-бой перечисляемый тип, значения которого показаны в табл. 8.18.

Таблица 8.18. Значения типа TInputKeys

Свойство Masked включает или выключает свойство Automask для отображения непрямоугольных окон. Описано следующим образом:

property Masked: Boolean;

Принимает значение True, если окно имеет непрямоугольную форму.
Свойство Palette хранит значение текущей палитры, которая используется для рисования данного элемента управления. Описано следующим образом:

property Palette: TWidgetPalette;

Свойство ParentWidget служит для ссылки на родительский элемент управления, т. е. на дескриптор окна родителя данного элемента управления. Описано следующим образом:

property ParentWidget: QWidgetH;
Свойство style предназначено для задания стиля компонента. Описано так:

property Style: TWidgetStyle;

Свойство TabOrder применяется для задания последовательности перехода от одного компонента формы к другому при помощи клавиши <Таb>. Свойство описано следующим образом:

property TabOrder: TTabOrder;

Нумерация осуществляется, начиная с нуля. Если задать свойству TabOrder компонента значение -1, этот компонент не сможет получить фокус при помощи клавиши <Таb>. Предположим, что на форме расположены три кнопки: Button1, Button2 и Button3. Для того чтобы фокус между этими кнопками передавался следующим образом: сначала активна кнопка Button2, Затем - Button1 и потом уже Button3, нужно установить свойство TabOrder для кнопки Button1 равным 1, для Button2 - 0, а для Button3 - 2.
Свойство Tabstop применяется для указания возможности передачи фокуса на компонент при помощи клавиши <Таb>. Оно описывается следующим образом:

property TabStop: Boolean;

Если значение данного свойства равно true, то при помощи клавиши <Таb> можно передать фокус этому компоненту, в зависимости от его свойства TabOrder. Если значение свойства Tabstop равно false, то независимо от свойства TabOrder фокус будет невозможно передать при помощи клавиши <Таb>.

НОВОСТИ ФОРУМА Рыцари теории эфира

10.11.2021 - 12:37: ПЕРСОНАЛИИ - Personalias -> WHO IS WHO - КТО ЕСТЬ КТО - Карим_Хайдаров. 10.11.2021 - 12:36: СОВЕСТЬ - Conscience -> РАСЧЕЛОВЕЧИВАНИЕ ЧЕЛОВЕКА. КОМУ ЭТО НАДО? - Карим_Хайдаров. 10.11.2021 - 12:36: ВОСПИТАНИЕ, ПРОСВЕЩЕНИЕ, ОБРАЗОВАНИЕ - Upbringing, Inlightening, Education -> Просвещение от д.м.н. Александра Алексеевича Редько - Карим_Хайдаров. 10.11.2021 - 12:35: ЭКОЛОГИЯ - Ecology -> Биологическая безопасность населения - Карим_Хайдаров. 10.11.2021 - 12:34: ВОЙНА, ПОЛИТИКА И НАУКА - War, Politics and Science -> Проблема государственного терроризма - Карим_Хайдаров. 10.11.2021 - 12:34: ВОЙНА, ПОЛИТИКА И НАУКА - War, Politics and Science -> ПРАВОСУДИЯ.НЕТ - Карим_Хайдаров. 10.11.2021 - 12:34: ВОСПИТАНИЕ, ПРОСВЕЩЕНИЕ, ОБРАЗОВАНИЕ - Upbringing, Inlightening, Education -> Просвещение от Вадима Глогера, США - Карим_Хайдаров. 10.11.2021 - 09:18: НОВЫЕ ТЕХНОЛОГИИ - New Technologies -> Волновая генетика Петра Гаряева, 5G-контроль и управление - Карим_Хайдаров. 10.11.2021 - 09:18: ЭКОЛОГИЯ - Ecology -> ЭКОЛОГИЯ ДЛЯ ВСЕХ - Карим_Хайдаров. 10.11.2021 - 09:16: ЭКОЛОГИЯ - Ecology -> ПРОБЛЕМЫ МЕДИЦИНЫ - Карим_Хайдаров. 10.11.2021 - 09:15: ВОСПИТАНИЕ, ПРОСВЕЩЕНИЕ, ОБРАЗОВАНИЕ - Upbringing, Inlightening, Education -> Просвещение от Екатерины Коваленко - Карим_Хайдаров. 10.11.2021 - 09:13: ВОСПИТАНИЕ, ПРОСВЕЩЕНИЕ, ОБРАЗОВАНИЕ - Upbringing, Inlightening, Education -> Просвещение от Вильгельма Варкентина - Карим_Хайдаров.