matplotlib.axes.Axes.text#

Axes.text(x, y, s, fontdict=None, **kwargs)[source]#

向坐标系中添加文本。

在数据坐标系中，将文本 s 添加到坐标系中位于 x, y 的位置，默认 horizontalalignment 为 left，verticalalignment 为 baseline。详见文本对齐。

参数:

x, yfloat: 放置文本的位置。默认情况下，这是数据坐标。可以使用 transform 参数更改坐标系。
sstr: 文本内容。
fontdictdict, 默认值: None: 不建议使用

不建议使用 fontdict。参数应作为独立的关键字参数或使用字典解包 text(..., **fontdict) 传递。

一个用于覆盖默认文本属性的字典。如果 fontdict 为 None，则默认值由 rcParams 确定。

返回:

文本: 创建的 Text 实例。

其他参数:

**kwargsText 属性。

其他杂项文本参数。

属性	描述
`agg_filter`	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量
`alpha`	浮点数或 None
`animated`	布尔值
`antialiased`	布尔值
`backgroundcolor`	color
`bbox`	包含 `patches.FancyBboxPatch` 属性的字典
`clip_box`	未知
`clip_on`	未知
`clip_path`	未知
`color` 或 `c`	color
`figure`	`Figure` 或 `SubFigure`
`fontfamily` 或 `family` 或 `fontname`	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
`fontproperties` 或 `font` 或 `font_properties`	`font_manager.FontProperties` 或 `str` 或 `pathlib.Path`
`fontsize` 或 `size`	float 或 {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
`fontstretch` 或 `stretch`	{0-1000 范围内的数值, 'ultra-condensed', 'extra-condensed', 'condensed', 'semi-condensed', 'normal', 'semi-expanded', 'expanded', 'extra-expanded', 'ultra-expanded'}
`fontstyle` 或 `style`	{'normal', 'italic', 'oblique'}
`fontvariant` 或 `variant`	{'normal', 'small-caps'}
`fontweight` 或 `weight`	{0-1000 范围内的数值, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', 'extra bold', 'black'}
`gid`	str
`horizontalalignment` 或 `ha`	{'left', 'center', 'right'}
`in_layout`	布尔值
`label`	object
`linespacing`	float (字体大小的倍数)
`math_fontfamily`	str
`mouseover`	布尔值
`multialignment` 或 `ma`	{'left', 'right', 'center'}
`parse_math`	布尔值
`path_effects`	`AbstractPathEffect` 列表
`picker`	None 或布尔值或浮点数或可调用对象
`position`	(浮点数, 浮点数)
`rasterized`	布尔值
`rotation`	float 或 {'vertical', 'horizontal'}
`rotation_mode`	{None, 'default', 'anchor'}
`sketch_params`	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
`snap`	布尔值或 None
`text`	object
`transform`	`变换`
`transform_rotates_text`	布尔值
`url`	str
`usetex`	bool, 默认值: `rcParams["text.usetex"]` (默认值: `False`)
`verticalalignment` 或 `va`	{'baseline', 'bottom', 'center', 'center_baseline', 'top'}
`visible`	布尔值
`wrap`	布尔值
`x`	浮点数
`y`	浮点数
`zorder`	浮点数

示例

可以使用单独的关键字参数覆盖任何给定参数

>>> text(x, y, s, fontsize=12)

默认变换指定文本使用数据坐标，或者，您可以指定文本使用轴坐标（(0, 0) 是左下角，(1, 1) 是右上角）。下面的示例将文本放置在坐标系的中心

>>> text(0.5, 0.5, 'matplotlib', horizontalalignment='center',
...      verticalalignment='center', transform=ax.transAxes)

您可以使用关键字参数 bbox 在文本实例周围放置一个矩形框（例如，设置背景颜色）。bbox 是 Rectangle 属性的字典。例如

matplotlib.axes.Axes.text#

使用 matplotlib.axes.Axes.text 的示例#

使用 `matplotlib.axes.Axes.text` 的示例#