3.5.2.1.9. ColorPicker

ColorPicker представляет собой поле для предпросмотра и выбора цвета. Компонент возвращает шестнадцатеричный (HEX) код цвета в виде строки.

gui color picker

Пример использования ColorPicker с надписью, взятой из пакета локализованных сообщений:

<colorPicker id="colorPicker" caption="msg://colorPickerCaption"/>

Пример ColorPicker с закрытым окном палитры.

gui color picker mini

Для создания ColorPicker, связанного с данными, необходимо использовать атрибуты dataContainer и property.

<data>
    <collection id="carsDc" class="com.company.sales.entity.Car" view="_local">
        <loader>
            <query>
                <![CDATA[select e from sales_Car e]]>
            </query>
        </loader>
    </collection>
</data>
<layout>
    <colorPicker id="colorPicker" dataContainer="carsDc" property="color"/>
</layout>

Атрибуты colorPicker:

  • buttonCaption - надпись кнопки компонента.

  • defaultCaptionEnabled - если установлено true и не задан атрибут buttonCaption, в качестве надписи кнопки используется HEX-код текущего цвета.

  • historyVisible - определяет видимость истории последних выбранных цветов в окне палитры.

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

  • swatchesVisible - определяет видимость вкладки палитры.

  • rgbVisible - определяет видимость вкладки селектора RGB.

  • hsvVisible - определяет видимость вкладки селектора HSV.

По умолчанию включена только вкладка селектора RGB.

Надписи окна палитры можно переопределить:

  • popupCaption - надпись заголовка окна палитры.

  • confirmButtonCaption - надпись кнопки подтверждения.

  • cancelButtonCaption - надпись кнопки отмены.

  • swatchesTabCaption - заголовок вкладки палитры.

  • lookupAllCaption - надпись элемента выпадающего списка, отвечающего за все цвета.

  • lookupRedCaption - надпись элемента выпадающего списка, отвечающего за оттенки красного.

  • lookupGreenCaption - надпись элемента выпадающего списка, отвечающего за оттенки зеленого.

  • lookupBlueCaption - надпись элемента выпадающего списка, отвечающего за оттенки синего.

Метод компонента getValue() возвращает строку, содержащую HEX-код цвета.