Home · All Classes · Modules  · QSS HELP  · QSS 案例 · VER007 HOME

QPalette Class Reference
^{[QtGui module]}

该QPalette类包含的颜色组每个插件的状态。More...

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（）和setBrush（ ） 。颜色组中包含的一组颜色绘制自己使用的小工具。我们建议小部件使用颜色组的角色从调色板中，如“前台”和“基地” ，而不是字面的颜色，如“红色”或“绿松石” 。色彩的角色列举和定义的ColorRole文档。

我们强烈建议您使用当前样式的默认调色板（通过返回QApplication.palette（））和修改是必要的。这是由Qt的部件进行绘制，当他们。

要修改调用函数的颜色组setColor（）和setBrush（ ） ，这取决于你是否想要一个纯粹的颜色或像素图的图案。

也有相应color（）和brush（ ） getter方法​​和常用的便利函数来获得ColorRole对于当前ColorGroup：window（ ）windowText（ ）base（）等

您可以使用拷贝构造函数和测试，看看如果两个调色板拷贝调色板identical using isCopyOf（ ） 。

QPalette是通过使用优化implicit sharing，所以它是非常有效的传递QPalette对象作为参数。

Warning:有些样式不使用调色板的所有图纸，举例来说，如果他们利用原生主题引擎。这对于在Windows XP中， Windows Vista和Mac OS X的风格的情况下。

Type Documentation

QPalette.ColorGroup

QPalette.ColorRole

该ColorRole枚举定义了当前的图形用户界面中使用的不同象征意义的颜色角色。

中央角色是：

有大多用于三维斜角和阴影效果一些色彩的角色。所有这些通常是衍生自Window以及在依赖于该关系的方式使用。例如，按钮依赖于它，使斜面看起来有吸引力，和Motif滚动条依赖于Mid是从稍微不同的Window。

选定的（标记）的项目有两个作用：

有相关的超链接两种颜色的作用：

请注意，我们不使用Link和LinkVisited呈现在Qt的富文本时，那角色，我们建议您使用CSS和QTextDocument.setDefaultStyleSheet（ ）函数来改变链接的外观。例如：

     QTextBrowser browser;
     QColor linkColor(Qt.red);
     QString sheet = QString.fromLatin1("a { text-decoration: underline; color: %1 }").arg(linkColor.name());
     browser.document()->setDefaultStyleSheet(sheet);

Method Documentation

QPalette.__init__ (self)

构造一个使用应用程序的默认调色板调色板对象。

See also QApplication.setPalette（）和QApplication.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。

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。

QBrush QPalette.alternateBase (self)

返回当前颜色组的备用基地刷。

See also ColorRole和brush（ ） 。

QBrush QPalette.background (self)

QBrush QPalette.base (self)

返回当前颜色组的基本刷。

See also ColorRole和brush（ ） 。

QBrush QPalette.brightText (self)

返回当前颜色组的光明前景文本刷。

See also ColorRole和brush（ ） 。

QBrush QPalette.brush (self, ColorGroup cg, ColorRole cr)

返回刷中指定的颜色group中，用于给定的颜色role。

See also color（ ）setBrush（）和ColorRole。

QBrush QPalette.brush (self, ColorRole cr)

这是一个重载函数。

返回该已被设置为给定的彩色的画笔role在当前的ColorGroup。

See also color（ ）setBrush（）和ColorRole。

QBrush QPalette.button (self)

返回当前颜色组的按钮刷。

See also ColorRole和brush（ ） 。

QBrush QPalette.buttonText (self)

返回当前颜色组的按钮文本前景刷。

See also ColorRole和brush（ ） 。

int QPalette.cacheKey (self)

返回一个数字，用于标识此内容QPalette对象。不同QPalette对象可以具有相同的密钥，如果它们指的是相同的内容。

该cacheKey （ ）会改变，当调色板被改变。

QColor QPalette.color (self, ColorGroup cg, ColorRole cr)

返回颜色中指定的颜色group中，用于给定的颜色role。

See also brush（ ）setColor（）和ColorRole。

QColor QPalette.color (self, ColorRole cr)

这是一个重载函数。

返回该已被设置为给定的颜色的颜色role在当前的ColorGroup。

See also brush（）和ColorRole。

ColorGroup QPalette.currentColorGroup (self)

返回调色板的当前颜色组。

See also setCurrentColorGroup（ ） 。

QBrush QPalette.dark (self)

返回当前颜色组的暗刷。

See also ColorRole和brush（ ） 。

QBrush QPalette.foreground (self)

QBrush QPalette.highlight (self)

返回当前颜色组的重头戏刷。

See also ColorRole和brush（ ） 。

QBrush QPalette.highlightedText (self)

返回当前颜色组的高亮文本刷。

See also ColorRole和brush（ ） 。

bool QPalette.isBrushSet (self, ColorGroup cg, ColorRole cr)

返回True如果ColorGroup cg和ColorRole cr已经在此之前的调色板设置，否则返回False 。

这个函数中引入了Qt 4.2中。

See also setBrush（ ） 。

bool QPalette.isCopyOf (self, QPalette p)

返回True如果这个调色板，p是彼此的副本，即其中一人被创建为其他既不其后修改的副本，否则返回False 。这比平等更严格的。

See also operator=（）和operator==（ ） 。

bool QPalette.isEqual (self, ColorGroup cr1, ColorGroup cr2)

返回True （通常很快） ，如果色组cg1等于cg2否则返回False 。

QBrush QPalette.light (self)

返回当前颜色组的光刷。

See also ColorRole和brush（ ） 。

QBrush QPalette.link (self)

返回当前颜色组的未访问过的链接文字笔刷。

See also ColorRole和brush（ ） 。

QBrush QPalette.linkVisited (self)

返回当前颜色组的访问链接文本刷。

See also ColorRole和brush（ ） 。

QBrush QPalette.mid (self)

返回当前颜色组的中间刷。

See also ColorRole和brush（ ） 。

QBrush QPalette.midlight (self)

返回当前颜色组的midlight刷。

See also ColorRole和brush（ ） 。

QPalette QPalette.resolve (self, QPalette)

返回一个新的QPalette具有从属性复制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（ ）setColor（）和ColorRole。

QPalette.setBrush (self, ColorRole acr, QBrush abrush)

这是一个重载函数。

设置刷子中指定的颜色group中，用于给定的颜色role，以brush。

See also brush（ ）setColor（）和ColorRole。

QPalette.setColor (self, ColorGroup acg, ColorRole acr, QColor acolor)

设置颜色中指定的颜色group中，用于给定的颜色role到指定的固color。

See also setBrush（ ）color（）和ColorRole。

QPalette.setColor (self, ColorRole acr, QColor acolor)

这是一个重载函数。

设置用于给定的颜色的颜色role，所有的颜色组，到指定的固color。

See also brush（ ）setColor（）和ColorRole。

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。

QPalette.setCurrentColorGroup (self, ColorGroup cg)

调色板的当前颜色组设置为cg。

See also currentColorGroup（ ） 。

QBrush QPalette.shadow (self)

返回当前颜色组的眼影刷。

See also ColorRole和brush（ ） 。

QBrush QPalette.text (self)

返回当前颜色组的文本前景刷。

See also ColorRole和brush（ ） 。

QBrush QPalette.toolTipBase (self)

返回当前颜色组的刀尖基地刷。这个刷子是由QToolTip和QWhatsThis。

Note:工具提示使用的颜色不活动组QPalette，因为工具提示未激活的窗口。

此功能被引入Qt的4.4 。

See also ColorRole和brush（ ） 。

QBrush QPalette.toolTipText (self)

返回当前颜色组的工具提示文本刷。这个刷子是由QToolTip和QWhatsThis。

Note:工具提示使用的颜色不活动组QPalette，因为工具提示未激活的窗口。

此功能被引入Qt的4.4 。

See also ColorRole和brush（ ） 。

QBrush QPalette.window (self)

返回当前颜色组的窗口（一般背景）刷。

See also ColorRole和brush（ ） 。

QBrush QPalette.windowText (self)

返回当前颜色组的窗口文本（一般前台）刷。

See also ColorRole和brush（ ） 。

bool QPalette.__eq__ (self, QPalette p)

bool QPalette.__ne__ (self, QPalette p)