javatm platform
standard ed. 6

javax.swing
类 jcolorchooser

java.lang.object 继承者 java.awt.component 继承者 java.awt.container   继承者 javax.swing.jcomponent   继承者 javax.swing.jcolorchooser
所有〖all〗已实现的接口:
imageobserver, menucontainer, serializable, accessible

public class jcolorchooser
extends jcomponent
implements accessible

jcolorchooser 提供一个用于允许〖yǔn xǔ〗用户操作和选择颜色的控制器窗格。有关使用颜色选取器的信息,请参阅 the java tutorial 中的 how to use color choosers 一节。

此类提供三个级别的 api:

  1. 显示有模式颜色选取器对话框并返回用户所选颜色的静态便捷方法。
  2. 创建颜色选取器对话框的静态便捷方法,可以〖can〗指定当用户按下其中一个对话框按钮时要调用的 actionlistener
  3. 能直接创建 jcolorchooser 窗格实例(在任何容器中)。可以〖can〗添加 propertychange 侦听器以检测当前“颜色”属性何时更改。

警告: swing 不是线程安全〖safest〗的。有关更多信息,请参阅 swing's threadingpolicy

警告:此类的序列化对象与以后的 swing 版本不兼容。当前序列化支持〖support〗适用于短期存储,或适用于在运行相同 swing 版本的应用程序之间进行 rmi(remote method invocation,远程方法调用)。从 1.4 版本开始〖appeared〗,已在 java.beans 包中添加了支持〖support〗所有 javabeanstm 长期存储的功能。请参见 xmlencoder


嵌套类摘要
protected  classjcolorchooser.accessiblejcolorchooser
          此类实现对 jcolorchooser 类的可访问〖fǎng wèn〗性支持。
 
从类 javax.swing.jcomponent 继承的嵌套类/接口
jcomponent.accessiblejcomponent
 
从类 java.awt.container 继承的嵌套类/接口
container.accessibleawtcontainer
 
从类 java.awt.component 继承的嵌套类/接口
component.accessibleawtcomponent, component.baselineresizebehavior, component.bltbufferstrategy, component.flipbufferstrategy
 
字段摘要
protected  accessiblecontextaccessiblecontext
           
static stringchooser_panels_property
          chooserpanel 数组属性名。
static stringpreview_panel_property
          预览面板属性名。
static stringselection_model_property
          选择模型属性名。
 
从类 javax.swing.jcomponent 继承的字段
listenerlist, tool_tip_text_key, ui, undefined_condition, when_ancestor_of_focused_component, when_focused, when_in_focused_window
 
从类 java.awt.component 继承的字段
bottom_alignment, center_alignment, left_alignment, right_alignment, top_alignment
 
从接口 java.awt.image.imageobserver 继承的字段
abort, allbits, error, framebits, height, properties, somebits, width
 
构造方法摘要
jcolorchooser()
          创建初始颜色为白色的颜色选取器窗格。
jcolorchooser(color initialcolor)
          创建具有指定初始颜色的颜色选取器窗格。
jcolorchooser(colorselectionmodel model)
          创建具有指定 colorselectionmodel 颜色选取器窗格。
 
方法摘要
 voidaddchooserpanel(abstractcolorchooserpanel panel)
          将颜色选取器面板添加到颜色选取器。
static jdialogcreatedialog(component c,string title,boolean modal,jcolorchooser chooserpane,actionlistener oklistener,actionlistener cancellistener)
          创建并返回包含指定 colorchooser 窗格及 "ok"、"cancel" 和 "reset" 按钮的新对话框。
 accessiblecontextgetaccessiblecontext()
          获取与此 jcolorchooser 关联的 accessiblecontext。
 abstractcolorchooserpanel[]getchooserpanels()
          返回指定的颜色面板。
 colorgetcolor()
          获取颜色选取器的当前颜色值。
 booleangetdragenabled()
          获取 dragenabled 属性的值。
 jcomponentgetpreviewpanel()
          返回显示选取颜色的预览面板。
 colorselectionmodelgetselectionmodel()
          返回处理颜色选择的数据模型。
 colorchooseruijs随机数getui()
          返回呈现此组件的 l&f 对象。
 stringgetuiclassid()
          返回呈现此组件的 l&f 类的名称。
protected  stringparamstring()
          返回此 jcolorchooser 的字符串表示形式。
 abstractcolorchooserpanelremovechooserpanel(abstractcolorchooserpanel panel)
          移除指定的 color panel。
 voidsetchooserpanels(abstractcolorchooserpanel[] panels)
          指定用于选取颜色值的 color panel。
 voidsetcolor(color color)
          将颜色选取器的当前颜色设置为指定颜色。
 voidsetcolor(int c)
          将颜色选取器的当前颜色设置为指定颜色。
 voidsetcolor(int r,int g,int b)
          将颜色选取器的当前颜色设置为指定的 rgb 颜色。
 voidsetdragenabled(boolean b)
          设置 dragenabled 属性,该属性必须为 true 才能启用对此组件的自动拖动处理(拖放操作的第一部分)。
 voidsetpreviewpanel(jcomponent preview)
          设置当前预览面板。
 voidsetselectionmodel(colorselectionmodel newmodel)
          设置包含所选颜色的模型。
 voidsetui(colorchooserui ui)
          设置呈现此组件的 l&f 对象。
static colorshowdialog(component component,string title,color initialcolor)
          显示有模式的颜色选取器,在隐藏对话框之前一直阻塞。
 voidupdateui()
          uimanager 发出的关于 l&f 已更改的通知〖tōng zhī〗。
 
从类 javax.swing.jcomponent 继承的方法
addancestorlistener, addnotify, addvetoablechangelistener, computevisiblerect, contains, createtooltip, disable, enable, firepropertychange, firepropertychange, firepropertychange, firevetoablechange, getactionforkeystroke, getactionmap, getalignmentx, getalignmenty, getancestorlisteners, getautoscrolls, getbaseline, getbaselineresizebehavior, getborder, getbounds, getclientproperty, getcomponentgraphics, getcomponentpopupmenu, getconditionforkeystroke, getdebuggraphicsoptions, getdefaultlocale, getfontmetrics, getgraphics, getheight, getinheritspopupmenu, getinputmap, getinputmap, getinputverifier, getinsets, getinsets, getlisteners, getlocation, getmaximumsize, getminimumsize, getnextfocusablecomponent, getpopuplocation, getpreferredsize, getregisteredkeystrokes, getrootpane, getsize, gettooltiplocation, gettooltiptext, gettooltiptext, gettoplevelancestor, gettransferhandler, getverifyinputwhenfocustarget, getvetoablechangelisteners, getvisiblerect, getwidth, getx, gety, grabfocus, isdoublebuffered, islightweightcomponent, ismanagingfocus, isopaque, isoptimizeddrawingenabled, ispaintingforprint, ispaintingtile, isrequestfocusenabled, isvalidateroot, paint, paintborder, paintchildren, paintcomponent, paintimmediately, paintimmediately, print, printall, printborder, printchildren, printcomponent, processcomponentkeyevent, processkeybinding, processkeyevent, processmouseevent, processmousemotionevent, putclientproperty, registerkeyboardaction, registerkeyboardaction, removeancestorlistener, removenotify, removevetoablechangelistener, repaint, repaint, requestdefaultfocus, requestfocus, requestfocus, requestfocusinwindow, requestfocusinwindow, resetkeyboardactions, reshape, revalidate, scrollrecttovisible, setactionmap, setalignmentx, setalignmenty, setautoscrolls, setbackground, setborder, setcomponentpopupmenu, setdebuggraphicsoptions, setdefaultlocale, setdoublebuffered, setenabled, setfocustraversalkeys, setfont, setforeground, setinheritspopupmenu, setinputmap, setinputverifier, setmaximumsize, setminimumsize, setnextfocusablecomponent, setopaque, setpreferredsize, setrequestfocusenabled, settooltiptext, settransferhandler, setui, setverifyinputwhenfocustarget, setvisible, unregisterkeyboardaction, update
 
从类 java.awt.container 继承的方法
add, add, add, add, add, addcontainerlistener, addimpl, addpropertychangelistener, addpropertychangelistener, applycomponentorientation, arefocustraversalkeysset, countcomponents, deliverevent, dolayout, findcomponentat, findcomponentat, getcomponent, getcomponentat, getcomponentat, getcomponentcount, getcomponents, getcomponentzorder, getcontainerlisteners, getfocustraversalkeys, getfocustraversalpolicy, getlayout, getmouseposition, insets, invalidate, isancestorof, isfocuscycleroot, isfocuscycleroot, isfocustraversalpolicyprovider, isfocustraversalpolicyset, layout, list, list, locate, minimumsize, paintcomponents, preferredsize, printcomponents, processcontainerevent, processevent, remove, remove, removeall, removecontainerlistener, setcomponentzorder, setfocuscycleroot, setfocustraversalpolicy, setfocustraversalpolicyprovider, setlayout, transferfocusbackward, transferfocusdowncycle, validate, validatetree
 
从类 java.awt.component 继承的方法
action, add, addcomponentlistener, addfocuslistener, addhierarchyboundslistener, addhierarchylistener, addinputmethodlistener, addkeylistener, addmouselistener, addmousemotionlistener, addmousewheellistener, bounds
台南市永康区胜〖win〗利〖shèng lì〗街菜市场内一栋住宅,8月21日上午〖shàng wǔ〗10时6分发生〖occasionally occurred〗火警,消防局出动10多部各式消防车,人员30多人前往抢救,由于〖yóu yú〗火场位于市场内,道路狭小抢救困难,消防人员接驳水带全力抢救下,火势历时约40分钟完全〖completely〗扑灭,幸无人员伤亡及扩大酿灾,起火原因及财物损失由消防局调查中
0卡将于8月中旬起加入大台南公车服务〖fú wù〗行列,提供旅客更多选择,另外大台南公车转乘优惠也加倍延长为4小时,使用一卡通(含市民卡)、悠游卡及iCash 2
下埔里长林太源指出,传统饭栈仅用竹子、藤条两种材料,竹子共有3种,最硬的孟宗竹,用于支撑饭栈,再用桂竹作为骨架,而韧性佳的刺竹,则用在编扎饭栈
7公里处明隧道工程担任工地领班,上午〖shàng wǔ〗巡视水塔及水管线路时,滑落一旁的断崖,坠落的深度〖 dù〗约100米
当局并没有透露第8名死者状况,但当地报导表示第8位死者是被斩首于饭店30公里外
和平区鞍马溪的谷关发电厂旁铁门,19日下午1点左右发生〖occasionally occurred〗1女子跌落15米深的山谷边坡,消防人员获报到场见伤者意识清楚,以绳索将女子固定,拉上到平地地面,送医后并无大碍
, checkimage, checkimage, coalesceevents, contains, createimage, createimage, createvolatileimage, createvolatileimage, disableevents, dispatchevent, enable, enableevents, enableinputmethods, firepropertychange, firepropertychange, firepropertychange, firepropertychange, firepropertychange, firepropertychange, getbackground, getbounds, getcolormodel, getcomponentlisteners, getcomponentorientation, getcursor, getdroptarget, getfocuscyclerootancestor, getfocuslisteners, getfocustraversalkeysenabled, getfont, getforeground, getgraphicsconfiguration, gethierarchyboundslisteners, gethierarchylisteners, getignorerepaint, getinputcontext, getinputmethodlisteners, getinputmethodrequests, getkeylisteners, getlocale, getlocation, getlocationonscreen, getmouselisteners, getmousemotionlisteners, getmouseposition, getmousewheellisteners, getname, getparent, getpeer, getpropertychangelisteners, getpropertychangelisteners, getsize, gettoolkit, gettreelock, gotfocus, handleevent, hasfocus, hide, imageupdate, inside, isbackgroundset, iscursorset, isdisplayable, isenabled, isfocusable, isfocusowner, isfocustraversable, isfontset, isforegroundset, islightweight, ismaximumsizeset, isminimumsizeset, ispreferredsizeset, isshowing, isvalid, isvisible, keydown, keyup, list, list, list, location, lostfocus, mousedown, mousedrag, mouseenter, mouseexit, mousemove, mouseup, move, nextfocus, paintall, postevent, prepareimage, prepareimage, processcomponentevent, processfocusevent, processhierarchyboundsevent, processhierarchyevent, processinputmethodevent, processmousewheelevent, remove, removecomponentlistener, removefocuslistener, removehierarchyboundslistener, removehierarchylistener, removeinputmethodlistener, removekeylistener, removemouselistener, removemousemotionlistener, removemousewheellistener, removepropertychangelistener, removepropertychangelistener, repaint, repaint, repaint, resize, resize, setbounds, setbounds, setcomponentorientation, setcursor, setdroptarget, setfocusable, setfocustraversalkeysenabled, setignorerepaint, setlocale, setlocation, setlocation, setname, setsize, setsize, show, show, size, tostring, transferfocus, transferfocusupcycle
 
从类 java.lang.object 继承的方法
clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait
 

字段详细小糶ǎn〗畔

selection_model_property

public static final string selection_model_property
选择模型属性名。

另请参见:
常量字段值

preview_panel_property

public static final string preview_panel_property
预览面板属性名。

另请参见:
常量字段值

chooser_panels_property

public static final string chooser_panels_property
chooserpanel 数组属性名。

另请参见:
常量字段值

accessiblecontext

protected accessiblecontext accessiblecontext
构造方法详细信息

jcolorchooser

public jcolorchooser()
创建初始颜色为白色的颜色选取器窗格。


jcolorchooser

public jcolorchooser(color initialcolor)
创建具有指定初始颜色的颜色选取器窗格。

参数:
initialcolor - 选取器中的初始颜色设置

jcolorchooser

public jcolorchooser(colorselectionmodel model)
创建具有指定 colorselectionmodel 颜色选取器窗格。

参数:
model - 要使用的 colorselectionmodel
方法详细信息

showdialog

public static color showdialog(component component,      string title,      color initialcolor)    throws headlessexception
显示有模式的颜色选取器,在隐藏对话框之前一直阻塞。如果用户按下 "ok" 按钮,则此方法隐藏/释放对话框并返回所选颜色。如果用户按下 "cancel" 按钮或者在没有按 "ok" 的情况下关闭对话框,则此方法将隐藏/释放对话框并返回 null

参数:
component - 对话框的父 component
title - 包含对话框标题的 string
initialcolor - 显示颜色选取器时的初始 color 设置
返回:
所选颜色;如果用户退出,则返回 null
抛出:
headlessexception - 如果 graphicsenvironment.isheadless() 返回 true。
另请参见:
graphicsenvironment.isheadless()

createdialog

public static jdialog createdialog(component c,      string title,      boolean modal,      jcolorchooser chooserpane,      actionlistener oklistener,      actionlistener cancellistener)      throws headlessexception
创建并返回包含指定 colorchooser 窗格及 "ok"、"cancel" 和 "reset" 按钮的新对话框。如果按下 "ok" 或 "cancel" 按钮,则对话框自动隐藏(但未释放)。如果按下 "reset" 按钮,则将颜色选取器的颜色重置为上一次在对话框上调用 show 时设置的颜色,并且对话框仍然显示。

参数:
c - 对话框的父组件
title - 对话框的标题
modal - 一个 boolean,为 true 时,在关闭对话框之前,程序的剩余部分将一直处于非激活状态。
chooserpane - 要置于对话框中的颜色选取器
oklistener - 按下 "ok" 时调用的 actionlistener
cancellistener - 按下 "cancel" 时调用的 actionlistener
返回:
包含颜色选取器窗格的新对话框
抛出:
headlessexception - 如果 graphicsenvironment.isheadless() 返回 true。
另请参见:
graphicsenvironment.isheadless()

getui

public colorchooserui getui()
返回呈现此组件的 l&f 对象。

返回:
呈现此组件的 colorchooserui 对象

setui

public void setui(colorchooserui ui)
设置呈现此组件的 l&f 对象。

参数:
ui - colorchooserui l&f 对象
另请参见:
uidefaults.getui(javax.swing.jcomponent)

updateui

public void updateui()
uimanager 发出的关于 l&f 已更改的通知〖tōng zhī〗。根据 uimanager 的最新通知替换当前的 ui 对象。

覆盖:
jcomponent 中的 updateui
另请参见:
jcomponent.updateui()

getuiclassid

public string getuiclassid()
返回呈现此组件的 l&f 类的名称。

覆盖:
jcomponent 中的 getuiclassidjs随机数
返回:
字符串 "colorchooserui"
另请参见:
jcomponent.getuiclassid(),uidefaults.getui(javax.swing.jcomponent)

getcolor

public color getcolor()
获取颜色选取器的当前颜色值。默认情况下,此操作委托给模型。

返回:
颜色选取器的当前颜色值

setcolor

public void setcolor(color color)
将颜色选取器的当前颜色设置为指定颜色。colorselectionmodel 将激发 changeevent

参数:
color - 要在颜色选取器中设置的颜色
另请参见:
container.addpropertychangelistener(java.beans.propertychangelistener)

setcolor

public void setcolor(int r,     int g,     int b)
将颜色选取器的当前颜色设置为指定的 rgb 颜色。注意〖zhù yì〗,红色、绿色和蓝色的值应该〖yīng gāi〗介于数字 0 和 255 之间(包括〖included〗两者)。

参数:
r - 指定 red 量的 int
g - 指定 green 量的 int
b - 指定 blue 量的 int
抛出:
illegalargumentexception - 如果 r,g,b 值超出范围
另请参见:
color

setcolor

public void setcolor(int c)
将颜色选取器的当前颜色设置为指定颜色。

参数:
c - 在选取器中设置当前颜色的整数值,其中 8 个低位指定 blue 值,接下来的 8 个位指定 green 值,再往上的 8 个位指定 red 值。

网站地图 手机端

setdragenabled

public void setdragenabled(boolean b)
设置 dragenabled 属性,该属性必须为 true 才能启用对此组件的自动拖动处理(拖放操作的第一部分)。必须将 transferhandler 属性设置为非 null 值,拖动才有效。dragenabled 属性的默认值为 false

启用自动拖动处理时,只要用户在预览面板上按下鼠标按钮,大多数外观就开始〖appeared〗拖放操作了。有些外观可能〖kě néng〗不支持自动拖放;它们将忽略此属性。对于这些外观,可通过修改组件以直接调用 transferhandlerexportasdrag 方法来处理该问题〖wèn tí〗。

参数:
b - 作为 dragenabled 属性设置目标的值
抛出:
headlessexception - 如果 btrue 并且 graphicsenvironment.isheadless() 返回 true
从以下版本开始:
1.4
另请参见:
graphicsenvironment.isheadless(),getdragenabled(),jcomponent.settransferhandler(javax.swing.transferhandler),transferhandler

getdragenabled

public boolean getdragenabled()
获取 dragenabled 属性的值。

返回:
dragenabled 属性的值
从以下版本开始:
1.4
另请参见:
setdragenabled(boolean)

setpreviewpanel

public void setpreviewpanel(jcomponent preview)
设置当前预览面板。此操作将为名为 "previewpanel" 的属性激发 propertychangeevent

参数:
preview - 显示当前颜色的 jcomponent
另请参见:
container.addpropertychangelistener(java.beans.propertychangelistener)

getpreviewpanel

public jcomponent getpreviewpanel()
返回显示选取颜色的预览面板。

返回:
jcomponent 对象,即预览面板

addchooserpanel

public void addchooserpanel(abstractcolorchooserpanel panel)
将颜色选取器面板添加到颜色选取器。

参数:
panel - 要添加的 abstractcolorchooserpanel

removechooserpanel

public abstractcolorchooserpanel removechooserpanel(abstractcolorchooserpanel panel)
移除指定的 color panel。

参数:
panel - 要移除的指定面板的字符串
返回:
颜色面板
抛出:
illegalargumentexception - 如果面板不在已知选取器面板的列表中

setchooserpanels

public void setchooserpanels(abstractcolorchooserpanel[] panels)
指定用于选取颜色值的 color panel。

参数:
panels - abstractcolorchooserpanel 对象的数组

getchooserpanels

public abstractcolorchooserpanel[] getchooserpanels()
返回指定的颜色面板。

返回:
abstractcolorchooserpanel 对象的数组

getselectionmodel

public colorselectionmodel getselectionmodel()
返回处理颜色选择的数据模型。

返回:
colorselectionmodel 对象

setselectionmodel

public void setselectionmodel(colorselectionmodel newmodel)
设置包含所选颜色的模型。

参数:
newmodel - 新 colorselectionmodel 对象

paramstring

protected string paramstring()
返回此 jcolorchooser 的字符串表示形式。此方法仅在进行调试时使用,对于各个实现,所返回字符串的内容和格式可能〖kě néng〗有所不同。返回的字符串可能为空,但不可能为 null

覆盖:
jcomponent 中的 paramstring
返回:
jcolorchooser 的字符串表示形式

getaccessiblecontext

public accessiblecontext getaccessiblecontext()
获取与此 jcolorchooser 关联的 accessiblecontext。对于颜色选取器,accessiblecontext 采用 accessiblejcolorchooser 的形式。如有必要,可创建一个新的 accessiblejcolorchooser 实例。

指定者:
接口 accessible 中的 getaccessiblecontext
覆盖:
jcomponent 中的 getaccessiblecontext
返回:
充当此 jcolorchooser 的 accessiblecontext 的 accessiblejcolorchooser

javatm platform
standard ed. 6

提交错误或意见〖remark〗
有关更多的 api 参考资料和开发〖kāi fā〗人员文档,请参阅 java se 开发〖kāi fā〗人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作〖work〗代码示例。

版权所有 2007 sun microsystems, inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策