matplotlib.artist.setp#

matplotlib.artist.setp(obj, *args, file=None, **kwargs)[源代码][源代码]#

在一个 Artist 上设置一个或多个属性，或列出允许的值。

参数:
obj : Artist 或 Artist 的列表艺术家或艺术家列表

正在设置或查询其属性的艺术家。设置属性时，所有艺术家都会受到影响；查询允许的值时，仅查询序列中的第一个实例。

例如，可以通过一次调用使两行变粗并变为红色：

>>> x = arange(0, 1, 0.01)
>>> lines = plot(x, sin(2*pi*x), x, sin(4*pi*x))
>>> setp(lines, linewidth=2, color='r')
文件 : 类文件对象, 默认: sys.stdout类文件对象，默认：

当被要求列出允许的值时，setp 将其输出写入何处。

>>> with open('output.log') as file:
...     setp(line, file=file)

默认值 None 表示 sys.stdout。

*args, **kwargs

要设置的属性。支持以下组合：

  • 将线条的线型设置为虚线：

    >>> line, = plot([1, 2, 3])
>>> setp(line, linestyle='--')

  • 一次设置多个属性：

    >>> setp(line, linewidth=2, color='r')

  • 列出线条样式的允许值：

    >>> setp(line, 'linestyle')
linestyle: {'-', '--', '-.', ':', '', (offset, on-off-seq), ...}

  • 列出所有可以设置的属性及其允许的值：

    >>> setp(line)
agg_filter: a filter function, ...
[long output listing omitted]

setp 也支持 MATLAB 风格的字符串/值对。例如，以下两者是等价的：

>>> setp(lines, 'linewidth', 2, 'color', 'r')  # MATLAB style
>>> setp(lines, linewidth=2, color='r')        # Python style

参见

getp
On this page