Свойства комплексных графических объектов

Комплексные графические объекты обладают дополнительными свойствами. Далее приводится описание «расширенных» свойств комплексных графических объектов, например, текстового редактора, ползунка и других типов объектов.

Описание комплексных графических объектов приведено в разделе «Комплексные графические объекты«.

Рисунок: Свойства объекта типа «Текстовый редактор»

Рисунок: Свойства объекта типа: «Ползунок»

Рисунок: Свойства объекта типа «Цифровой дисплей (ЖК-индикатор)»

Рисунок: Свойства объекта типа «Трубопровод»

  • CurrentColor: текущий цвет (текстового редактора).
  • AutoFormatting: формат объекта (например, текстового редактора):
    • «AutoNone»:  не применять автоформатирование.
    • «AutoBulletList «:  автоматически форматировать только маркированные (bulletted) списки.
    • «AutoAll «:  применить все доступное автоформатирование.

В языке CTRL для управления данным свойством используется «autoFormatting«.

  • AllColumnsShowFocus: отображение фокуса всеми столбцами (Иерархический список).
  • BackgroundOrigin: первоисточник фона виджета. Данное свойство может быть применено в том случае, если фон виджета представляет собой пиксельное изображение, при этом имеет значение его позиционирование. Возможные варианты первоисточника фона:
    • «WidgetOrigin»
    • «ParentOrigin»
    • «WindowOrigin»
    • «AncestorOrigin»

В языке CTRL для управления данным свойством используется «backgroundOrigin«.

  • Стиль начала / Стиль окончания (beginStyle/endStyle): стили начала и окончания трубопровода: open, closed (открытое, закрытое) или connector (соединение).
  • defaultRenameAction (не используется начиная с версии 3.12): действие, выполняемое при потере редактором фокуса в процессе переименования элементов (в иерархическом списке):
    • «Accept » = элемент переименовывается, даже если кнопка ВВОД (Enter) не нажата
    • «Reject» = элемент не переименовывается до момента нажатия кнопки ВВОД (Enter).

В языке CTRL для управления данным свойством используется «defaultRenameAction«.

  • Кнопка по умолчанию (Defaultbutton): назначение кнопки (в дочерней панели), которая будет активироваться (нажиматься) при нажатии клавиши ВВОД (Enter) вне зависимости от того, какой объект в текущий момент находится в фокусе для ввода с клавиатуры. Например, если на панели имеются три кнопки, и значение свойства «Кнопка по умолчанию» одной из кнопок равняется «TRUE», то в случае нажатия клавиши ВВОД (Enter) будет выполняться сценарий данной кнопки. В том случае, если свойство «Кнопка по умолчанию» было активировано для нескольких кнопок, то будет выполняется код кнопки, которая была инициализирована последней.
  • decimals: количество знаков после запятой Цифрового дисплея (ЖК-индикатора). В языке CTRL для управления данным свойством используется «decimals«.
  • intValue: значение (целое число) Цифрового дисплея (ЖК-индикатора). В языке CTRL для управления данным свойством используется «intValue«.
  • mode: режим (система счисления) Цифрового дисплея (ЖК-индикатора). Режим (система счисления):
    • «Hex» — шестнадцатеричная
    • «Dec» — десятичная
    • «Oct» — восьмеричная
    • «Bin» — двоичная
      В языке CTRL для управления данным свойством используется «mode«.
  • digitCount: количество цифровых знакомест, отображаемых на Цифровом дисплее (ЖК-индикаторе). В языке CTRL для управления данным свойством используется «numDigits«.
  • segmentStyle: стиль сегментов ЖК-индикатора. Стили сегментов:
    • Outline:  выпуклые сегменты, цвет заливки соответствует цвету фона. Данная опция является опцией по умолчанию.  
    • Filled: выпуклые сегменты, цвет заливки соответствует цвету рисунка.  
    • Flat: плоские сегменты, цвет заливки соответствует цвету рисунка.
  • smallDecimalPoint: «TRUE» — запятая не занимает одно из цифровых знакомест и отображается между ними. «FALSE» — запятая полностью занимает одно из цифровых знакомест. В языке CTRL для управления данным свойством используется «smallDecimalPoint«.
  • Шаг (step): шаг счетчика. Допускается использование целых чисел от 1 до 1000. В языке CTRL для управления данным свойством используется «sbStep«.
  • Значение (value): текущее значение Цифрового дисплея (ЖК-индикатора) или счетчика. В языке CTRL для управления данным свойством Цифрового дисплея (ЖК-индикатора) используется «value«. Значение Cчетчика не может быть установлено с использованием языка CTRL.
  • lineStep: шаг ползунка при управлении клавишами перемещения курсора. В языке CTRL для управления данным свойством используется атрибут «lineStep«.
  • maxValue: максимальное значение ползунка. В языке CTRL для управления данным свойством используется «maxValue«.
  • minValue: минимальное значение ползунка. В языке CTRL для управления данным свойством используется «minValue«.
  • Ориентация: ориентация ползунка или колеса прокрутки («Horizontal» (горизонтальная) или «Vertical» (вертикальная)). В языке CTRL для управления данным свойством используется «orientation«.
  • pageStep: шаг ползунка при щелчке по нему. В языке CTRL для управления данным свойством используется «pageStep«.
  • tickInterval: интервал между рисками (отметками). В языке CTRL для управления данным свойством используется «tickInterval«.
  • tickPosition: расположение рисок относительно ползунка.
    • «NoTicks» — без рисок
    • «TicksBothSides» — риски (отметки) с обеих сторон ползунка
    • «TicksAbove» — риски над (горизонтальным) ползунком
    • «TicksBelow» — риски под (горизонтальным) ползунком
    • «TicksLeft» — риски слева от (вертикального) ползунка
    • «TicksRight» — риски справа от (вертикального) ползунка
  • tracking: активация/деактивация отслеживания положения ползунка во время его перемещения. Если отслеживание активировано (по умолчанию), то при перемещении ползунка всегда формируется сигнал valueChanged(). Если отслеживание деактивировано, то сигнал valueChanged() формируется при отпускании пользователем кнопки мыши (иными словами, свойство задает частоту вызова сценария события «Change» (либо только при отпускании пользователем кнопки мыши, либо всегда при перемещении ползунка)). В языке CTRL для управления данным свойством используется «tracking»«.
  • Значение (value): текущее значение Ползунка. В языке CTRL для управления данным свойством используется «value«.
  • vertical: флажки Селектора могут быть расположены горизонтально (FALSE) или вертикально (TRUE).
  • bold: насыщенность шрифта (полужирный шрифт). В языке CTRL для управления данным свойством используется «bold«.
  • DragAutoScroll: разрешение/запрещение автоматической прокрутки при перетаскивании. Свойство применимо в том случае, если объект содержит такой объем текста или элементов, при котором отображаются полосы прокрутки, а целевое местоположение перетаскиваемого текста или элемента визуально находится вне пределов границ объекта. При разрешенной автоматической прокрутке при достижении перетаскиваемым текстом или элементом края объекта производится прокрутка содержимого объекта. В языке CTRL для управления данным свойством используется «dragAutoScroll«.
  • Family: задает семейство шрифтов (гарнитуру) текущего шрифта. В языке CTRL для опроса данного свойства используется «family«.
  • FrameShadow: эффект рамки (3D-эффект) текстового редактора или иерархического списка. Доступные опции: «Plain» (плоская), «Raised» (выпуклая) or «Sunken» (утопленная). В языке CTRL для управления данным свойством используется «frameShadow«.
  • FrameShape: стиль рамки текстового редактора или иерархического списка. Доступные опции:
    • «NoFrame»      // без рамки
    • «Box»               // прямоугольник
    • «Panel»         // прямоугольная панель
    • «WinPanel»      // прямоугольная панель (Windows)
    • «HLine»        // горизонтальная линия
    • «VLine»       // вертикальная линия
    • «StyledPanel»   // прямоугольная панель. Внешний вид зависит от текущего стиля графического интерфейса пользователя.
    • «LineEditPanel»   // используется для формирования рамки, например, редактора строки. Внешний вид зависит от текущего стиля графического интерфейса пользователя.
    • «TabWidgetPanel» // используется для формирования рамки, например, виджетов вкладок. Внешний вид зависит от текущего стиля графического интерфейса пользователя.
    • «MShape»  // внутренняя маска. Опция «MShape» не должна использоваться!

В языке CTRL для управления данным свойством используется «frameShape«.

  • HScrollBarMode (начиная с версии 3.10 используется horizontalScrollBarPolicy): режим горизонтальной полосы прокрутки текстового редактора или иерархического списка. В языке CTRL для управления данным свойством используется «hScrollBarMode» (начиная с версии 3.10 используется «horizontalScrollBarPolicy»).
  • itemMargin: ширина поля элемента (дерева точек данных). Свойство использовалось в предыдущих версиях.
  • Italic: наклон шрифта (прямой, курсивный), например, в текстовом редакторе. В языке CTRL для управления данным свойством используется «italic«.
  • Переключатель (Togglebutton): если значение свойства «Переключатель» равняется «TRUE», то кнопка остается нажатой, даже если пользователь уже отпустил кнопку мыши или клавишу клавиатуры. Для возврата кнопки в исходное положение требуется повторное нажатие кнопки.
  • LineWidth: толщина линии рамки текстового редактора или иерархического списка. В языке CTRL для управления данным свойством используется «lineWidth«.
  • LinkUnderline (не используется начиная с версии 3.10): подчеркивание ссылки (при этом должен использоваться формат RTF (расширенный текстовый формат). В языке CTRL для управления данным свойством используется «linkUnderline«).
  • Margin (не используется начиная с версии 3.12): расстояние между наиболее близким к центру пикселем рамки и наиболее дальним от центра пикселем прямоугольника внутри рамки (Виджеты Текстовый редактор, Колесо прокрутки, Индикатор выполнения, Иерархический список). В языке CTRL для управления данным свойством используется «margin«.
  • MidLineWidth: ширина линии (например, между рамкой и прямоугольником с содержанием) иерархического списка. При этом свойство «frameShape» должно иметь определенное значение, например «HLine», «VLine» или «Box». В языке CTRL для управления данным свойством используется «midLineWidth«.
  • resizeMode: поведение объекта при изменении размера: изменение размеров всех столбцов списка, изменение размера только последнего столбца, без изменения размера столбцов. Режимы изменения размера:
    • «NoColumn» = размеры столбцов не изменяются.
    • «AllColumns» = Пропорциональное изменение размеров всех столбцов.
    • «LastColumn» = Изменение размера только последнего столбца.
  • rootIsDecorated: отображение в иерархическом списке значков открытого и закрытого состояний узловых элементов. В языке CTRL для управления данным свойством используется «rootIsDecorated«.
  • Режим выбора (SelectionMode): поведение иерархического списка при выборе [элементов списка] пользователем:
    • «Single» = при выборе элемента другой ранее выбранный элемент исключается из набора выбранных элементов. Для отмены выбора элемента необходимо щелкнуть по пустой области в пределах иерархического списка.
    • «Multi» = при выборе элемента обычным образом другие ранее выбранные элементы остаются в наборе выбранных элементов. Выбор нескольких элементов может быть осуществлен путем перемещения курсора мыши, при этом левая кнопка мыши должна удерживаться в нажатом состоянии.
    • «Extended» = при выборе элемента обычным образом другие ранее выбранные элементы исключаются из набора выбранных элементов. При удержании в нажатом состоянии клавиши Ctrl и щелчке по элементу происходит смена состояния данного элемента, состояние прочих элементов не изменяется. При удержании в нажатом состоянии клавиши Shift и щелчке по какому-либо элементу, все элементы между выбранным до момента щелчка элементом и тем элементом, по которому производится щелчок, включаются или исключаются из набора выбранных элементов, в зависимости от их текущего состояния. Также имеется возможность выбора нескольких элементов путем наведения на них курсора мыши.
    • «NoSelection» = элементы не могут быть выбраны.
  • showSortIndicator: отображение значка порядка сортировки в заголовках столбцов (собственно сортировка активируется при помощи свойства «sortingEnabled»):
  • TRUE = значок порядка сортировки отображается.
  • FALSE = значок порядка сортировки не отображается.
  • showToolTips: отображение всплывающих подсказок для не полностью отображенных столбцов иерархического списка:
  • TRUE = вывод на экран всплывающих подсказок для не полностью отображенных столбцов.
  • FALSE = всплывающие подсказки для не полностью отображенных столбцов отключены.
  • treeStepSize: количество пикселей, на которое дочерний элемент смещается относительно родительского элемента (иерархический список). В языке CTRL для управления данным свойством используется «treeStepSize«.
  • OverwriteMode: активация/деактивация режима перезаписи в текстовом редакторе. В языке CTRL для управления данным свойством используется «overwriteMode«.
  • PointSize: размер шрифта в текстовом редакторе. В языке CTRL для управления данным свойством используется «pointSize«.
  • ReadOnly: активация/деактивация в текстовом редакторе режима «только для чтения». В языке CTRL для управления данным свойством используется «readOnly«.
  • TabChangesFocus: если «TabChangesFocus» = «TRUE», то ввод знаков табуляции невозможен. В языке CTRL для управления данным свойством используется «tabChangesFocus«.
  • TabStopWidth: шаг табуляции в текстовом редакторе. В языке CTRL для управления данным свойством используется «tabStopWidth«.
  • TextFormat: формат текста в текстовом редакторе. Возможно использование либо «PlainText» (простого неформатированного текста) либо «RichText» (расширенного текстового формата). В языке CTRL для управления данным свойством используется «textFormat«.
  • Underline: подчеркивание текущего шрифта (текста). В языке CTRL для управления данным свойством используется «underline«.
  • UndoDepth (не используется начиная с версии 3.10): глубина истории отмены действий. В языке CTRL для управления данным свойством используется «undoDepth«.
  • UndoRedoEnabled: разрешение/запрещение отмены действий или их повторного выполнения. В языке CTRL для управления данным свойством используется «undoRedoEnabled«.
  • VScrollBarMode (начиная с версии 3.10 используется verticalScrollBarPolicy): режим горизонтальной полосы прокрутки текстового редактора или иерархического списка. В языке CTRL для управления данным свойством используется «vScrollBarMode» (начиная с версии 3.10 используется verticalScrollBarPolicy).
  • WordWrap: управление переносами в тексте (в текстовом редакторе):
     
    • «NoWrap» = переносы в тексте запрещены.
    • «WidgetWidth» = перенос в соответствии с текущей шириной виджета (настройка по умолчанию). По умолчанию местом переноса является пробел; настройка может быть изменена при помощи свойства «wrapPolicy«.
    • «FixedPixelWidth» = перенос при достижении заданного количества пикселей, отсчитываемого от правого края виджета. Количество пикселей задается при помощи свойства «wrapColumnOrWidth«.
    • «FixedColumnWidth» = перенос при достижении заданного количества символов, отсчитываемого от левого края виджета. Количество символов задается при помощи свойства «wrapColumnOrWidth«.

В языке CTRL для управления данным свойством используется метод «wordWrap«.

  1. Свойство «wrapColumnOrWidth» позволяет устанавливать количество символов для режима «FixedColumnWidth» и количество пикселей для режима «FixedPixelWidth» (см. свойство «wordWrap» выше). В языке CTRL для управления данным свойством используется метод «wrapColumnOrWidth«.
  • WrapPolicy: место переноса текста в текстовом редакторе при разрешенных переносах. Опции:
      • Anywhere — перенос текста в любом месте, в том числе в пределах слов.
      • AtWordBoundary — перенос текста на границе слова (например, пробел или символ новой строки).
      • AtWordOrDocumentBoundary — по возможности перенос текста на границе слова (например, пробел или символ новой строки). В противном случае — в любом месте.

В языке CTRL для управления данным свойством используется метод «wrapPolicy«.

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *