QPalette Class Reference · PyQt4 中文文檔

# QPalette Class Reference ## [[QtGui](index.htm) module] 該QPalette類包含的顏色組每個插件的狀態。[More...](#details) ### Types * `enum ColorGroup { Active, Disabled, Inactive, NColorGroups, ..., Normal }` * `enum ColorRole { WindowText, Foreground, Button, Light, ..., NoRole }` ### Methods * `__init__ (self)` * `__init__ (self, QColor?button)` * `__init__ (self, Qt.GlobalColor?button)` * `__init__ (self, QColor?button, QColor?background)` * `__init__ (self, QBrush?foreground, QBrush?button, QBrush?light, QBrush?dark, QBrush?mid, QBrush?text, QBrush?bright_text, QBrush?base, QBrush?background)` * `__init__ (self, QColor?foreground, QColor?background, QColor?light, QColor?dark, QColor?mid, QColor?text, QColor?base)` * `__init__ (self, QPalette?palette)` * `__init__ (self, QVariant?variant)` * `QBrush alternateBase (self)` * `QBrush background (self)` * `QBrush base (self)` * `QBrush brightText (self)` * `QBrush brush (self, ColorGroup?cg, ColorRole?cr)` * `QBrush brush (self, ColorRole?cr)` * `QBrush button (self)` * `QBrush buttonText (self)` * `int cacheKey (self)` * `QColor color (self, ColorGroup?cg, ColorRole?cr)` * `QColor color (self, ColorRole?cr)` * `ColorGroup currentColorGroup (self)` * `QBrush dark (self)` * `QBrush foreground (self)` * `QBrush highlight (self)` * `QBrush highlightedText (self)` * `bool isBrushSet (self, ColorGroup?cg, ColorRole?cr)` * `bool isCopyOf (self, QPalette?p)` * `bool isEqual (self, ColorGroup?cr1, ColorGroup?cr2)` * `QBrush light (self)` * `QBrush link (self)` * `QBrush linkVisited (self)` * `QBrush mid (self)` * `QBrush midlight (self)` * `QPalette resolve (self, QPalette)` * `int resolve (self)` * `resolve (self, int?mask)` * `int serialNumber (self)` * `setBrush (self, ColorGroup?cg, ColorRole?cr, QBrush?brush)` * `setBrush (self, ColorRole?acr, QBrush?abrush)` * `setColor (self, ColorGroup?acg, ColorRole?acr, QColor?acolor)` * `setColor (self, ColorRole?acr, QColor?acolor)` * `setColorGroup (self, ColorGroup?cr, QBrush?foreground, QBrush?button, QBrush?light, QBrush?dark, QBrush?mid, QBrush?text, QBrush?bright_text, QBrush?base, QBrush?background)` * `setCurrentColorGroup (self, ColorGroup?cg)` * `QBrush shadow (self)` * `QBrush text (self)` * `QBrush toolTipBase (self)` * `QBrush toolTipText (self)` * `QBrush window (self)` * `QBrush windowText (self)` ### Special Methods * `bool __eq__ (self, QPalette?p)` * `bool __ne__ (self, QPalette?p)` * * * ## Detailed Description 該QPalette類包含的顏色組每個插件的狀態。調色板由三個顏色組：_Active_，_Disabled_和_Inactive_。 Qt中的所有部件包含一個調色板，用自己的調色板畫出自己。這使得用戶界面易于配置和更容易保持一致。如果您創建一個新的widget ，我們強烈建議您使用的顏色在調色板中，而非硬編碼特定的顏色。色組： * The Active group is used for the window that has keyboard focus. * The Inactive group is used for other windows. * The Disabled group is used for widgets (not windows) that are disabled for some reason. 活動和非活動窗口可以包含禁用的部件。（殘疾人士使用的部件通常被稱為_inaccessible_ or _grayed out_。）在大多數款式，活動和非活動看起來是一樣的。顏色和畫筆可以在任何一個調色板中的顏色組與被設置為特定的角色[setColor](qpalette.html#setColor)（）和[setBrush](qpalette.html#setBrush)（）。顏色組中包含的一組顏色繪制自己使用的小工具。我們建議小部件使用顏色組的角色從調色板中，如“前臺”和“基地” ，而不是字面的顏色，如“紅色”或“綠松石” 。色彩的角色列舉和定義的[ColorRole](qpalette.html#ColorRole-enum)文檔。我們強烈建議您使用當前樣式的默認調色板（通過返回[QApplication.palette](qapplication.html#palette)（））和修改是必要的。這是由Qt的部件進行繪制，當他們。要修改調用函數的顏色組[setColor](qpalette.html#setColor)（）和[setBrush](qpalette.html#setBrush)（），這取決于你是否想要一個純粹的顏色或像素圖的圖案。也有相應[color](qpalette.html#color)（）和[brush](qpalette.html#brush)（） getter方法??和常用的便利函數來獲得[ColorRole](qpalette.html#ColorRole-enum)對于當前[ColorGroup](qpalette.html#ColorGroup-enum)：[window](qpalette.html#window)（）[windowText](qpalette.html#windowText)（）[base](qpalette.html#base)（）等您可以使用拷貝構造函數和測試，看看如果兩個調色板拷貝調色板_identical_ using [isCopyOf](qpalette.html#isCopyOf)（）。 QPalette是通過使用優化[implicit sharing](index.htm)，所以它是非常有效的傳遞QPalette對象作為參數。 **Warning:**有些樣式不使用調色板的所有圖紙，舉例來說，如果他們利用原生主題引擎。這對于在Windows XP中， Windows Vista和Mac OS X的風格的情況下。 * * * ## Type Documentation ``` QPalette.ColorGroup ``` | Constant | Value | Description | | --- | --- | --- | | `QPalette.Disabled` | `1` | ? | | `QPalette.Active` | `0` | ? | | `QPalette.Inactive` | `2` | ? | | `QPalette.Normal` | `Active` | 同義詞活躍 | ``` QPalette.ColorRole ``` ![Color Roles](https://img.kancloud.cn/81/cf/81cf7522fd5a790f3ba4e80f1200d0dc_750x202.png) 該ColorRole枚舉定義了當前的圖形用戶界面中使用的不同象征意義的顏色角色。中央角色是： | Constant | Value | Description | | --- | --- | --- | | `QPalette.Window` | `10` | 一般的背景色。 | | `QPalette.Background` | `Window` | 這個值是過時的。使用Window來代替。 | | `QPalette.WindowText` | `0` | 一般的前景色。 | | `QPalette.Foreground` | `WindowText` | 這個值是過時的。使用代替WindowText的。 | | `QPalette.Base` | `9` | 大多采用作為背景色的文本輸入窗口小部件，但也可以用于其他繪畫 - 如組合框的背景下拉列表和工具欄的句柄。它通常是白色或其它淺色。 | | `QPalette.AlternateBase` | `16` | 作為與交替行的顏色欣賞到備用背景色（見[QAbstractItemView.setAlternatingRowColors](qabstractitemview.html#alternatingRowColors-prop)（））。 | | `QPalette.ToolTipBase` | `18` | 用作背景顏色[QToolTip](qtooltip.html)和[QWhatsThis](qwhatsthis.html)。工具提示使用的顏色不活動組[QPalette](qpalette.html)，因為工具提示未激活的窗口。 | | `QPalette.ToolTipText` | `19` | 作為前景色[QToolTip](qtooltip.html)和[QWhatsThis](qwhatsthis.html)。工具提示使用的顏色不活動組[QPalette](qpalette.html)，因為工具提示未激活的窗口。 | | `QPalette.Text` | `6` | 所使用的前景色`Base`。這通常是一樣的`WindowText`，在這種情況下，它必須提供良好的對比度`Window`和`Base`。 | | `QPalette.Button` | `1` | 一般按鈕的背景顏色。這樣的背景可以從不同的`Window`因為有些款式需要不同的背景顏色的按鈕。 | | `QPalette.ButtonText` | `8` | 與使用的前景色`Button`顏色。 | | `QPalette.BrightText` | `7` | 文本顏色是從非常不同`WindowText`，并與對比以及如`Dark`。通常用于需要繪制文本的地方`Text` or `WindowText`將得到較差的對比度，例如在壓制的按鈕。請注意，文本顏色，可用于東西不僅僅是文字等;文字顏色_usually_用于文本，但它是相當普遍使用的文字顏色角色的線條，圖標等 | 有大多用于三維斜角和陰影效果一些色彩的角色。所有這些通常是衍生自`Window`以及在依賴于該關系的方式使用。例如，按鈕依賴于它，使斜面看起來有吸引力，和Motif滾動條依賴于`Mid`是從稍微不同的`Window`。 | Constant | Value | Description | | --- | --- | --- | | `QPalette.Light` | `2` | 比打火機`Button`顏色。 | | `QPalette.Midlight` | `3` | 之間`Button`和`Light`。 | | `QPalette.Dark` | `4` | 比較深`Button`。 | | `QPalette.Mid` | `5` | 之間`Button`和`Dark`。 | | `QPalette.Shadow` | `11` | 一個非常暗的顏色。默認情況下，陰影顏色[Qt.black](qt.html#GlobalColor-enum)。 | 選定的（標記）的項目有兩個作用： | Constant | Value | Description | | --- | --- | --- | | `QPalette.Highlight` | `12` | 顏色以指示所選項目或當前項目。默認情況下，突出顯示顏色[Qt.darkBlue](qt.html#GlobalColor-enum)。 | | `QPalette.HighlightedText` | `13` | 與對比的文字顏色`Highlight`。默認情況下，突出顯示的文本顏色為[Qt.white](qt.html#GlobalColor-enum)。 | 有相關的超鏈接兩種顏色的作用： | Constant | Value | Description | | --- | --- | --- | | `QPalette.Link` | `14` | 用于未訪問過的超鏈接的文本顏色。默認情況下，鏈接顏色是[Qt.blue](qt.html#GlobalColor-enum)。 | | `QPalette.LinkVisited` | `15` | 用于已訪問的超鏈接的文本顏色。默認情況下， linkvisited顏色[Qt.magenta](qt.html#GlobalColor-enum)。 | 請注意，我們不使用`Link`和`LinkVisited`呈現在Qt的富文本時，那角色，我們建議您使用CSS和[QTextDocument.setDefaultStyleSheet](qtextdocument.html#defaultStyleSheet-prop)（）函數來改變鏈接的外觀。例如： ``` [QTextBrowser](qtextbrowser.html) browser; [QColor](qcolor.html) linkColor([Qt](qt.html).red); [QString](qstring.html) sheet = [QString](qstring.html).fromLatin1("a { text-decoration: underline; color: %1 }").arg(linkColor.name()); browser.document()->setDefaultStyleSheet(sheet); ``` | Constant | Value | Description | | --- | --- | --- | | `QPalette.NoRole` | `17` | 沒有作用;此特殊的作用通常被用來表示一個作用還沒有被分配。 | * * * ## Method Documentation ``` QPalette.__init__ (self) ``` 構造一個使用應用程序的默認調色板調色板對象。 **See also** [QApplication.setPalette](qapplication.html#setPalette)（）和[QApplication.palette](qapplication.html#palette)（）。 ``` QPalette.__init__ (self, QColor?button) ``` 構造一個調色板從_button_顏色。其他顏色的自動計算，在此基礎上的色彩。`Window`將按鈕的顏色為好。 ``` QPalette.__init__ (self, Qt.GlobalColor?button) ``` 構造一個調色板從_button_顏色。其他顏色的自動計算，在此基礎上的色彩。`Window`將按鈕的顏色為好。 ``` QPalette.__init__ (self, QColor?button, QColor?background) ``` 構造一個調色板從_button_顏色和_window_。其他顏色的自動計算，根據這些顏色。 ``` QPalette.__init__ (self, QBrush?foreground, QBrush?button, QBrush?light, QBrush?dark, QBrush?mid, QBrush?text, QBrush?bright_text, QBrush?base, QBrush?background) ``` 構造一個調色板。您可以通過其中的畫筆，像素圖或純顏色_windowText_，_button_，_light_，_dark_，_mid_，_text_，_bright_text_，_base_和_window_。 **See also** [QBrush](qbrush.html)。 ``` QPalette.__init__ (self, QColor?foreground, QColor?background, QColor?light, QColor?dark, QColor?mid, QColor?text, QColor?base) ``` ``` QPalette.__init__ (self, QPalette?palette) ``` ``` QPalette.__init__ (self, QVariant?variant) ``` 構造的副本_p_。這個構造函數是快的感謝[implicit sharing](index.htm)。 ``` QBrush QPalette.alternateBase (self) ``` [ 返回當前顏色組的備用基地刷。 ](qbrush.html) [**See also**](qbrush.html) [ColorRole](qpalette.html#ColorRole-enum)和[brush](qpalette.html#brush)（）。 ``` QBrush QPalette.background (self) ``` [](qbrush.html) ``` QBrush QPalette.base (self) ``` [ 返回當前顏色組的基本刷。 ](qbrush.html) [**See also**](qbrush.html) [ColorRole](qpalette.html#ColorRole-enum)和[brush](qpalette.html#brush)（）。 ``` QBrush QPalette.brightText (self) ``` [ 返回當前顏色組的光明前景文本刷。 ](qbrush.html) [**See also**](qbrush.html) [ColorRole](qpalette.html#ColorRole-enum)和[brush](qpalette.html#brush)（）。 ``` QBrush QPalette.brush (self, ColorGroup?cg, ColorRole?cr) ``` [ 返回刷中指定的顏色_group_中，用于給定的顏色_role_。 ](qbrush.html) [**See also**](qbrush.html) [color](qpalette.html#color)（）[setBrush](qpalette.html#setBrush)（）和[ColorRole](qpalette.html#ColorRole-enum)。 ``` QBrush QPalette.brush (self, ColorRole?cr) ``` [ 這是一個重載函數。 ](qbrush.html) [返回該已被設置為給定的彩色的畫筆_role_在當前的](qbrush.html)[ColorGroup](qpalette.html#ColorGroup-enum)。 **See also** [color](qpalette.html#color)（）[setBrush](qpalette.html#setBrush)（）和[ColorRole](qpalette.html#ColorRole-enum)。 ``` QBrush QPalette.button (self) ``` [ 返回當前顏色組的按鈕刷。 ](qbrush.html) [**See also**](qbrush.html) [ColorRole](qpalette.html#ColorRole-enum)和[brush](qpalette.html#brush)（）。 ``` QBrush QPalette.buttonText (self) ``` [ 返回當前顏色組的按鈕文本前景刷。 ](qbrush.html) [**See also**](qbrush.html) [ColorRole](qpalette.html#ColorRole-enum)和[brush](qpalette.html#brush)（）。 ``` int QPalette.cacheKey (self) ``` 返回一個數字，用于標識此內容[QPalette](qpalette.html)對象。不同[QPalette](qpalette.html)對象可以具有相同的密鑰，如果它們指的是相同的內容。該cacheKey （）會改變，當調色板被改變。 ``` QColor QPalette.color (self, ColorGroup?cg, ColorRole?cr) ``` [ 返回顏色中指定的顏色_group_中，用于給定的顏色_role_。 ](qcolor.html) [**See also**](qcolor.html) [brush](qpalette.html#brush)（）[setColor](qpalette.html#setColor)（）和[ColorRole](qpalette.html#ColorRole-enum)。 ``` QColor QPalette.color (self, ColorRole?cr) ``` [ 這是一個重載函數。 ](qcolor.html) [返回該已被設置為給定的顏色的顏色_role_在當前的](qcolor.html)[ColorGroup](qpalette.html#ColorGroup-enum)。 **See also** [brush](qpalette.html#brush)（）和[ColorRole](qpalette.html#ColorRole-enum)。 ``` ColorGroup QPalette.currentColorGroup (self) ``` [ 返回調色板的當前顏色組。 ](qpalette.html#ColorGroup-enum) [**See also**](qpalette.html#ColorGroup-enum) [setCurrentColorGroup](qpalette.html#setCurrentColorGroup)（）。 ``` QBrush QPalette.dark (self) ``` [ 返回當前顏色組的暗刷。 ](qbrush.html) [**See also**](qbrush.html) [ColorRole](qpalette.html#ColorRole-enum)和[brush](qpalette.html#brush)（）。 ``` QBrush QPalette.foreground (self) ``` [](qbrush.html) ``` QBrush QPalette.highlight (self) ``` [ 返回當前顏色組的重頭戲刷。 ](qbrush.html) [**See also**](qbrush.html) [ColorRole](qpalette.html#ColorRole-enum)和[brush](qpalette.html#brush)（）。 ``` QBrush QPalette.highlightedText (self) ``` [ 返回當前顏色組的高亮文本刷。 ](qbrush.html) [**See also**](qbrush.html) [ColorRole](qpalette.html#ColorRole-enum)和[brush](qpalette.html#brush)（）。 ``` bool QPalette.isBrushSet (self, ColorGroup?cg, ColorRole?cr) ``` 返回True如果[ColorGroup](qpalette.html#ColorGroup-enum) _cg_和[ColorRole](qpalette.html#ColorRole-enum) _cr_已經在此之前的調色板設置，否則返回False 。這個函數中引入了Qt 4.2中。 **See also** [setBrush](qpalette.html#setBrush)（）。 ``` bool QPalette.isCopyOf (self, QPalette?p) ``` 返回True如果這個調色板，_p_是彼此的副本，即其中一人被創建為其他既不其后修改的副本，否則返回False 。這比平等更嚴格的。 **See also** [operator=](qpalette.html#operator-eq)（）和[operator==](qpalette.html#operator-eq-eq)（）。 ``` bool QPalette.isEqual (self, ColorGroup?cr1, ColorGroup?cr2) ``` 返回True （通常很快），如果色組_cg1_等于_cg2_否則返回False 。 ``` QBrush QPalette.light (self) ``` [ 返回當前顏色組的光刷。 ](qbrush.html) [**See also**](qbrush.html) [ColorRole](qpalette.html#ColorRole-enum)和[brush](qpalette.html#brush)（）。 ``` QBrush QPalette.link (self) ``` [ 返回當前顏色組的未訪問過的鏈接文字筆刷。 ](qbrush.html) [**See also**](qbrush.html) [ColorRole](qpalette.html#ColorRole-enum)和[brush](qpalette.html#brush)（）。 ``` QBrush QPalette.linkVisited (self) ``` [ 返回當前顏色組的訪問鏈接文本刷。 ](qbrush.html) [**See also**](qbrush.html) [ColorRole](qpalette.html#ColorRole-enum)和[brush](qpalette.html#brush)（）。 ``` QBrush QPalette.mid (self) ``` [ 返回當前顏色組的中間刷。 ](qbrush.html) [**See also**](qbrush.html) [ColorRole](qpalette.html#ColorRole-enum)和[brush](qpalette.html#brush)（）。 ``` QBrush QPalette.midlight (self) ``` [ 返回當前顏色組的midlight刷。 ](qbrush.html) [**See also**](qbrush.html) [ColorRole](qpalette.html#ColorRole-enum)和[brush](qpalette.html#brush)（）。 ``` QPalette QPalette.resolve (self, QPalette) ``` [](qpalette.html) [返回一個新的](qpalette.html)[QPalette](qpalette.html)具有從屬性復制_other_。 ``` int QPalette.resolve (self) ``` ``` QPalette.resolve (self, int?mask) ``` ``` int QPalette.serialNumber (self) ``` ``` QPalette.setBrush (self, ColorGroup?cg, ColorRole?cr, QBrush?brush) ``` 設置刷子對于給定的顏色_role_到指定的_brush_在調色板中的所有組。 **See also** [brush](qpalette.html#brush)（）[setColor](qpalette.html#setColor)（）和[ColorRole](qpalette.html#ColorRole-enum)。 ``` QPalette.setBrush (self, ColorRole?acr, QBrush?abrush) ``` 這是一個重載函數。設置刷子中指定的顏色_group_中，用于給定的顏色_role_，以_brush_。 **See also** [brush](qpalette.html#brush)（）[setColor](qpalette.html#setColor)（）和[ColorRole](qpalette.html#ColorRole-enum)。 ``` QPalette.setColor (self, ColorGroup?acg, ColorRole?acr, QColor?acolor) ``` 設置顏色中指定的顏色_group_中，用于給定的顏色_role_到指定的固_color_。 **See also** [setBrush](qpalette.html#setBrush)（）[color](qpalette.html#color)（）和[ColorRole](qpalette.html#ColorRole-enum)。 ``` QPalette.setColor (self, ColorRole?acr, QColor?acolor) ``` 這是一個重載函數。設置用于給定的顏色的顏色_role_，所有的顏色組，到指定的固_color_。 **See also** [brush](qpalette.html#brush)（）[setColor](qpalette.html#setColor)（）和[ColorRole](qpalette.html#ColorRole-enum)。 ``` QPalette.setColorGroup (self, ColorGroup?cr, QBrush?foreground, QBrush?button, QBrush?light, QBrush?dark, QBrush?mid, QBrush?text, QBrush?bright_text, QBrush?base, QBrush?background) ``` 設置的組_cg_。您可以通過其中的畫筆，像素圖或純顏色_windowText_，_button_，_light_，_dark_，_mid_，_text_，_bright_text_，_base_和_window_。 **See also** [QBrush](qbrush.html)。 ``` QPalette.setCurrentColorGroup (self, ColorGroup?cg) ``` 調色板的當前顏色組設置為_cg_。 **See also** [currentColorGroup](qpalette.html#currentColorGroup)（）。 ``` QBrush QPalette.shadow (self) ``` [ 返回當前顏色組的眼影刷。 ](qbrush.html) [**See also**](qbrush.html) [ColorRole](qpalette.html#ColorRole-enum)和[brush](qpalette.html#brush)（）。 ``` QBrush QPalette.text (self) ``` [ 返回當前顏色組的文本前景刷。 ](qbrush.html) [**See also**](qbrush.html) [ColorRole](qpalette.html#ColorRole-enum)和[brush](qpalette.html#brush)（）。 ``` QBrush QPalette.toolTipBase (self) ``` [](qbrush.html) [返回當前顏色組的刀尖基地刷。這個刷子是由](qbrush.html)[QToolTip](qtooltip.html)和[QWhatsThis](qwhatsthis.html)。 **Note:**工具提示使用的顏色不活動組[QPalette](qpalette.html)，因為工具提示未激活的窗口。此功能被引入Qt的4.4 。 **See also** [ColorRole](qpalette.html#ColorRole-enum)和[brush](qpalette.html#brush)（）。 ``` QBrush QPalette.toolTipText (self) ``` [](qbrush.html) [返回當前顏色組的工具提示文本刷。這個刷子是由](qbrush.html)[QToolTip](qtooltip.html)和[QWhatsThis](qwhatsthis.html)。 **Note:**工具提示使用的顏色不活動組[QPalette](qpalette.html)，因為工具提示未激活的窗口。此功能被引入Qt的4.4 。 **See also** [ColorRole](qpalette.html#ColorRole-enum)和[brush](qpalette.html#brush)（）。 ``` QBrush QPalette.window (self) ``` [ 返回當前顏色組的窗口（一般背景）刷。 ](qbrush.html) [**See also**](qbrush.html) [ColorRole](qpalette.html#ColorRole-enum)和[brush](qpalette.html#brush)（）。 ``` QBrush QPalette.windowText (self) ``` [ 返回當前顏色組的窗口文本（一般前臺）刷。 ](qbrush.html) [**See also**](qbrush.html) [ColorRole](qpalette.html#ColorRole-enum)和[brush](qpalette.html#brush)（）。 ``` bool QPalette.__eq__ (self, QPalette?p) ``` ``` bool QPalette.__ne__ (self, QPalette?p) ```