Flex - 顏色選擇器控制元件

ColorPicker 控制元件為使用者提供了一種從色板列表中選擇顏色的方法。預設模式是在方形按鈕中顯示單個色板。

當用戶點選色板按鈕時，色板面板出現並顯示整個色板列表。

類宣告

以下是mx.controls.ColorPicker類的宣告：

public class ColorPicker 
   extends ComboBase

公共屬性

序號	屬性及描述
1	colorField : String dataProvider 陣列物件中指定色板面板顯示的顏色十六進位制值的欄位名稱。
2	labelField : String dataProvider 陣列物件中包含要在 SwatchPanel 物件文字框中顯示為標籤的文字的欄位名稱。
3	selectedColor : uint SwatchPanel 物件中當前選定顏色的值。
4	selectedIndex : int [重寫] SwatchPanel 物件中所選專案的 dataProvider 中的索引。
5	showTextField : Boolean 指定是否顯示顯示顏色標籤或十六進位制顏色值的文字框。

受保護的屬性

序號	屬性及描述
1	swatchStyleFilters : Object [只讀] 從 ColorPicker 傳遞到預覽色板的一組樣式。

公共方法

序號	方法及描述
1	ColorPicker() 建構函式。
2	close(trigger:Event = null):void 隱藏下拉 SwatchPanel 物件。
3	open():void 顯示下拉 SwatchPanel 物件，該物件顯示使用者可以選擇的顏色。

序號

方法及描述

ColorPicker()

建構函式。

close(trigger:Event = null):void

隱藏下拉 SwatchPanel 物件。

open():void

顯示下拉 SwatchPanel 物件，該物件顯示使用者可以選擇的顏色。

事件

序號	事件及描述
1	change 由於使用者互動導致所選顏色更改時排程。
2	close 色板面板關閉時排程。
3	enter 如果 ColorPicker editable 屬性設定為 true 並且使用者在輸入十六進位制顏色值後按 Enter 鍵，則排程。
4	itemRollOut 當用戶將滑鼠從 SwatchPanel 物件中的色板移出時排程。
5	itemRollOver 當用戶將滑鼠懸停在 SwatchPanel 物件中的色板上時排程。
6	open 顏色色板面板開啟時排程。

繼承的方法

此類繼承自以下類：

mx.controls.comboBase
mx.core.UIComponent
mx.core.FlexSprite
flash.display.Sprite
flash.display.DisplayObjectContainer
flash.display.InteractiveObject
flash.display.DisplayObject
flash.events.EventDispatcher
Object

Flex 顏色選擇器控制元件示例

讓我們按照以下步驟在 Flex 應用程式中檢查 ColorPicker 控制元件的使用，方法是建立一個測試應用程式：

步驟	描述
1	如Flex - 建立應用程式章節所述，在包com.tutorialspoint.client下建立一個名為 HelloWorld 的專案。
2	修改HelloWorld.mxml，如下所述。保持其餘檔案不變。
3	編譯並執行應用程式，以確保業務邏輯按要求工作。

以下是修改後的 mxml 檔案src/com.tutorialspoint/HelloWorld.mxml的內容。

<?xml version = "1.0" encoding = "utf-8"?>
<s:Application xmlns:fx = "http://ns.adobe.com/mxml/2009"
   xmlns:s = "library://ns.adobe.com/flex/spark"
   xmlns:mx = "library://ns.adobe.com/flex/mx"
   width = "100%" height = "100%" minWidth = "500" minHeight = "500">
   
   <fx:Style source = "/com/tutorialspoint/client/Style.css" />
   <s:BorderContainer width = "550" height = "400" id = "mainContainer" 
      styleName = "container">
      <s:VGroup width = "100%" height = "100%" gap = "50" 
         horizontalAlign = "center" verticalAlign = "middle">
         <s:Label id = "lblHeader" text = "Form Controls Demonstration" 
            fontSize = "40" color = "0x777777" styleName = "heading" />
         
         <s:Panel id = "colorPickerPanel"
            backgroundColor = "{colorPicker.selectedColor}"	 
            title = "Using ColorPicker" width = "420" height = "200">
            <s:layout>
               <s:HorizontalLayout  gap = "10" verticalAlign = "middle" 
                  horizontalAlign = "center" />	
            </s:layout>
            
            <s:Label width = "150" color = "black" 
               text = "Select background color: " fontWeight = "bold" />
            <mx:ColorPicker id = "colorPicker" 
               showTextField = "true" selectedColor = "0xFFFFFF" />
         </s:Panel>	
      </s:VGroup>	 
   </s:BorderContainer>	
</s:Application>

完成所有更改後，讓我們像在Flex - 建立應用程式章節中一樣，在普通模式下編譯並執行應用程式。如果應用程式一切正常，它將產生以下結果：[ 線上試用 ]

flex_form_controls.htm

列印頁面