3.5.2.1.9. ColorPicker
ColorPicker
представляет собой поле для предпросмотра и выбора цвета. Компонент возвращает шестнадцатеричный (HEX) код цвета в виде строки.
Пример использования ColorPicker
с надписью, взятой из пакета локализованных сообщений:
<colorPicker id="colorPicker" caption="msg://colorPickerCaption"/>
Пример ColorPicker
с закрытым окном палитры.
Для создания 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
:
-
defaultCaptionEnabled
- если установленоtrue
и не задан атрибутbuttonCaption
, в качестве надписи кнопки используется HEX-код текущего цвета.
-
historyVisible
- определяет видимость истории последних выбранных цветов в окне палитры.
Видимость вкладок окна палитры можно определить с помощью атрибутов:
-
swatchesVisible
- определяет видимость вкладки палитры. -
rgbVisible
- определяет видимость вкладки селектора RGB. -
hsvVisible
- определяет видимость вкладки селектора HSV.
По умолчанию включена только вкладка селектора RGB.
-
popupCaption
- надпись заголовка окна палитры. -
confirmButtonCaption
- надпись кнопки подтверждения. -
cancelButtonCaption
- надпись кнопки отмены. -
swatchesTabCaption
- заголовок вкладки палитры. -
lookupAllCaption
- надпись элемента выпадающего списка, отвечающего за все цвета. -
lookupRedCaption
- надпись элемента выпадающего списка, отвечающего за оттенки красного. -
lookupGreenCaption
- надпись элемента выпадающего списка, отвечающего за оттенки зеленого. -
lookupBlueCaption
- надпись элемента выпадающего списка, отвечающего за оттенки синего.
Метод компонента getValue()
возвращает строку, содержащую HEX-код цвета.
- Атрибуты colorPicker
-
align - buttonCaption - cancelButtonCaption - caption - captionAsHtml - confirmButtonCaption - contextHelpText - contextHelpTextHtmlEnabled - css - dataContainer - defaultCaptionEnabled - description - descriptionAsHtml - editable - box.expandRatio - height - historyVisible - hsvVisible - htmlSanitizerEnabled - icon - id - lookupAllCaption - lookupBlueCaption - lookupGreenCaption - lookupRedCaption - popupCaption - rgbVisible - required - stylename - swatchesTabCaption - swatchesVisible - tabIndex - visible - width
- API