QColorDialog Class Reference · PyQt4 中文文檔

# QColorDialog Class Reference ## [[QtGui](index.htm) module] 該QColorDialog類提供了一個對話框控件指定顏色。[More...](#details) 繼承[QDialog](qdialog.html)。 ### Types * `enum ColorDialogOption { ShowAlphaChannel, NoButtons, DontUseNativeDialog }` * `class **[ColorDialogOptions](index.htm)**` ### Methods * `__init__ (self, QWidget?parent?=?None)` * `__init__ (self, QColor?initial, QWidget?parent?=?None)` * `changeEvent (self, QEvent?e)` * `QColor currentColor (self)` * `done (self, int?result)` * `open (self)` * `open (self, QObject?receiver, SLOT()SLOT()?member)` * `open (self, callable?receiver)` * `ColorDialogOptions options (self)` * `QColor selectedColor (self)` * `setCurrentColor (self, QColor?color)` * `setOption (self, ColorDialogOption?option, bool?on?=?True)` * `setOptions (self, ColorDialogOptions?options)` * `setVisible (self, bool?visible)` * `bool testOption (self, ColorDialogOption?option)` ### Static Methods * `int customColor (int)` * `int customCount ()` * `QColor getColor (QColor?initial?=?Qt.white, QWidget?parent?=?None)` * `QColor getColor (QColor?initial, QWidget?parent, QString?title, ColorDialogOptions?options?=?0)` * `(int, bool?ok) getRgba (int?initial?=?4294967295, QWidget?parent?=?None)` * `setCustomColor (int, int)` * `setStandardColor (int, int)` ### Qt Signals * `void colorSelected (const QColor&)` * `void currentColorChanged (const QColor&)` * * * ## Detailed Description 該QColorDialog類提供了一個對話框控件指定顏色。顏色對話框的功能是讓用戶選擇的顏色。例如，您可以使用這一個繪圖程序，以允許用戶設置畫筆的顏色。靜態函數提供了模態對話框的顏色。靜[getColor](qcolordialog.html#getColor)（）函數顯示對話框，并且允許用戶指定顏色。此功能也可以用來讓用戶選擇一種顏色與透明度級別：通過[ShowAlphaChannel](qcolordialog.html#ColorDialogOption-enum)選項作為附加參數。用戶可以存儲[customCount](qcolordialog.html#customCount)（）不同的自定義顏色。自定義顏色是由所有的顏色對話框共享，程序的執行過程中記住。使用[setCustomColor](qcolordialog.html#setCustomColor)（）來設置自定義顏色，并使用[customColor](qcolordialog.html#customColor)（）來獲取它們。該[Standard Dialogs](index.htm)示例顯示了如何使用QColorDialog以及其他內置Qt對話框。 ![A color dialog in the Plastique widget style.](https://img.kancloud.cn/96/d8/96d8e9477dc19d7711c18c0353631435_547x417.png) * * * ## Type Documentation ``` QColorDialog.ColorDialogOption ``` 此枚舉指定了影響顏色對話框的外觀和感覺的各種選項。 | Constant | Value | Description | | --- | --- | --- | | `QColorDialog.ShowAlphaChannel` | `0x00000001` | 允許用戶選擇一種顏色的alpha分量。 | | `QColorDialog.NoButtons` | `0x00000002` | 不顯示**OK**和**Cancel**按鈕。（有用的“現場對話” 。） | | `QColorDialog.DontUseNativeDialog` | `0x00000004` | 使用Qt的Mac上的標準顏色對話框，而不是蘋果的原生顏色面板。 | 這個枚舉被引入或修改的Qt 4.5 。該ColorDialogOptions類型是一個typedef為[QFlags](index.htm)\u003cColorDialogOption\u003e 。它存儲ColorDialogOption值的或組合。 **See also** [options](qcolordialog.html#options-prop)，[setOption](qcolordialog.html#setOption)（）[testOption](qcolordialog.html#testOption)（）和[windowModality](qwidget.html#windowModality-prop)（）。 * * * ## Method Documentation ``` QColorDialog.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個顏色對話框與給定_parent_。此功能被引入Qt的4.5 。 ``` QColorDialog.__init__ (self, QColor?initial, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個顏色對話框與給定_parent_并指定_initial_顏色。此功能被引入Qt的4.5 。 ``` QColorDialog.changeEvent (self, QEvent?e) ``` 從重新實現[QWidget.changeEvent](qwidget.html#changeEvent)（）。 ``` QColor QColorDialog.currentColor (self) ``` [ ``` int QColorDialog.customColor (int) ``` ](qcolor.html) [返回自定義顏色在給定的_index_作為](qcolor.html)[QRgb](qcolor.html#QRgb-typedef)值。此功能被引入Qt的4.5 。 **See also** [setCustomColor](qcolordialog.html#setCustomColor)（）。 ``` int QColorDialog.customCount () ``` 返回所支持的自定義顏色數[QColorDialog](qcolordialog.html)。所有的顏色對話框共用相同的自定義顏色。 ``` QColorDialog.done (self, int?result) ``` 從重新實現[QDialog.done](qdialog.html#done)（）。關閉對話框，并將其結果代碼_result_。如果顯示此對話框[exec_](qdialog.html#exec)（），（）完成將導致本地事件循環來完成，并[exec_](qdialog.html#exec)（）返回_result_。 **See also** [QDialog.done](qdialog.html#done)（）。 ``` QColor QColorDialog.getColor (QColor?initial?=?Qt.white, QWidget?parent?=?None) ``` [](qcolor.html) [彈出的窗口給出一個模式對話框的顏色_title_（或“選擇顏色” ，如果沒有指定），讓用戶選擇一種顏色，并返回該顏色。彩色初始設定為_initial_。對話框是一個孩子_parent_。它返回一個無效的（見](qcolor.html)[QColor.isValid](qcolor.html#isValid)（））如果用戶取消該對話框的顏色。該_options_參數允許您自定義對話框。在Symbian ，這個靜態函數將使用原生顏色對話框，而不是一個[QColorDialog](qcolordialog.html)。在Symbian的參數_title_和_parent_有沒有相關性和_options_參數僅用于定義是否被使用或不是天然顏色對話框。此功能被引入Qt的4.5 。 ``` QColor QColorDialog.getColor (QColor?initial, QWidget?parent, QString?title, ColorDialogOptions?options?=?0) ``` [](qcolor.html) [彈出一個模態對話框顏色，讓用戶選擇一種顏色，并返回該顏色。彩色初始設定為_initial_。對話框是一個孩子_parent_。它返回一個無效的（見](qcolor.html)[QColor.isValid](qcolor.html#isValid)（））如果用戶取消該對話框的顏色。在Symbian ，這個靜態函數將使用原生顏色對話框，而不是一個[QColorDialog](qcolordialog.html)。 ``` (int, bool?ok) QColorDialog.getRgba (int?initial?=?4294967295, QWidget?parent?=?None) ``` ``` QColorDialog.open (self) ``` 顯示該對話框的[window modal dialog](qdialog.html#modal-dialogs)，立即返回。此功能被引入Qt的4.5 。 **See also** [QDialog.open](qdialog.html#open)（）。 ``` QColorDialog.open (self, QObject?receiver, SLOT()SLOT()?member) ``` 這是一個重載函數。在打開的對話框并連接其[colorSelected](qcolordialog.html#colorSelected)（）信號到由指定的槽_receiver_和_member_。該信號會從插槽中斷開時，關閉對話框。此功能被引入Qt的4.5 。 ``` QColorDialog.open (self, callable?receiver) ``` ``` ColorDialogOptions QColorDialog.options (self) ``` [](index.htm) ``` QColor QColorDialog.selectedColor (self) ``` [ 返回用戶選擇通過單擊顏色**OK**或等效按鈕。 ](qcolor.html) [**Note:**這種顏色并非總是一樣的保持的顏色](qcolor.html)[currentColor](qcolordialog.html#currentColor-prop)因為用戶屬性終于可以選擇一個使用之前選擇不同的顏色。 ``` QColorDialog.setCurrentColor (self, QColor?color) ``` ``` QColorDialog.setCustomColor (int, int) ``` 設置在自定義顏色_index_到[QRgb](qcolor.html#QRgb-typedef) _color_值。 **Note:**此功能并不適用于本機顏色對話框上的Mac OS X平臺。如果您仍然需要使用此功能，請使用[QColorDialog.DontUseNativeDialog](qcolordialog.html#ColorDialogOption-enum)選項。 **See also** [customColor](qcolordialog.html#customColor)（）。 ``` QColorDialog.setOption (self, ColorDialogOption?option, bool?on?=?True) ``` 設置給定_option_被啟用，如果_on_是真的，否則，清除給定的_option_。 **See also** [options](qcolordialog.html#options-prop)和[testOption](qcolordialog.html#testOption)（）。 ``` QColorDialog.setOptions (self, ColorDialogOptions?options) ``` ``` QColorDialog.setStandardColor (int, int) ``` 設置標準色在_index_到[QRgb](qcolor.html#QRgb-typedef) _color_值。 **Note:**此功能并不適用于本機顏色對話框上的Mac OS X平臺。如果您仍然需要使用此功能，請使用[QColorDialog.DontUseNativeDialog](qcolordialog.html#ColorDialogOption-enum)選項。 ``` QColorDialog.setVisible (self, bool?visible) ``` 從重新實現[QWidget.setVisible](qwidget.html#visible-prop)（）。更改對話框的可見性。如果_visible_為真，則顯示的對話框，否則，它是隱藏的。 ``` bool QColorDialog.testOption (self, ColorDialogOption?option) ``` 返回True如果給定的_option_被啟用，否則返回False 。此功能被引入Qt的4.5 。 **See also** [options](qcolordialog.html#options-prop)和[setOption](qcolordialog.html#setOption)（）。 * * * ## Qt Signal Documentation ``` void colorSelected (const QColor&) ``` 這是該信號的默認超載。這個信號被發射的用戶點擊后剛**OK**選擇要使用的顏色。所選擇的顏色是由指定的_color_。 **See also** [color](index.htm)和[currentColorChanged](qcolordialog.html#currentColorChanged)（）。 ``` void currentColorChanged (const QColor&) ``` 這是該信號的默認超載。這個信號被發射時的對話在當前的顏色變化。當前顏色被指定_color_。 **See also** [color](index.htm)和[colorSelected](qcolordialog.html#colorSelected)（）。