- Qt 6.12
- Qt Graphs
- QML Types
- QtGraphs
- Custom3DLabel
- Qt Graphs | Commercial or GPLv3

# Custom3DLabel QML Type

Adds a custom label to a graph. More...

Import Statement: | `import QtGraphs`
In C++: | QCustom3DLabel
Inherits: | Custom3DItem

- List of all members, including inherited members
- Custom3DLabel is part of Qt Graphs QML Types for 3D.

## Properties

- backgroundColor : color
- backgroundVisible : bool
- borderVisible : bool
- facingCamera : bool
- font : font
- text : string
- textColor : color

## Signals

- backgroundColorChanged(color color)
- backgroundEnabledChanged(bool enabled)
- borderEnabledChanged(bool enabled)
- facingCameraChanged(bool enabled)
- fontChanged(font font)
- textChanged(string text)
- textColorChanged(color color)

## Detailed Description

The text, font, position, scaling, rotation, and colors of a custom label can be set. In addition, the visibility of the borders and background of the label can be toggled. Colors, borders, and background are determined by the active theme unless set explicitly.

Note: In scaling, the z-coordinate has no effect. Setting the same x- and y-coordinates retains the original font dimensions.

## Property Documentation

### backgroundColor : color

The color for the label background, if enabled. Defaults to `"gray"`.

See also backgroundVisible.

### backgroundVisible : bool

Defines whether the label background is visible. If set to `false`, backgroundColor has no effect. Defaults to `true`.

### borderVisible : bool

Defines whether label borders are visible. Defaults to `true`.

### facingCamera : bool

Defines whether the label will always face the camera. Defaults to `false`. If set to `true`, rotation has no effect.

### font : font

The font to be used for the label. Defaults to `Font {family: "Arial"; pointSize: 20}`. Special formatting (for example, outlined) is not supported.

### text : string

The text for the label. Rich text is not supported.

### textColor : color

The color for the label text. Also affects label border, if enabled. Defaults to `"white"`.

See also borderVisible.

## Signal Documentation

### backgroundColorChanged(color color)

This signal is emitted when backgroundColor changes to color.

Note: The corresponding handler is `onBackgroundColorChanged`.

### backgroundEnabledChanged(bool enabled)

This signal is emitted when backgroundEnabled changes to enabled.

Note: The corresponding handler is `onBackgroundEnabledChanged`.

### borderEnabledChanged(bool enabled)

This signal is emitted when borderEnabled changes to enabled.

Note: The corresponding handler is `onBorderEnabledChanged`.

### facingCameraChanged(bool enabled)

This signal is emitted when facingCamera changes to enabled.

Note: The corresponding handler is `onFacingCameraChanged`.

### fontChanged(font font)

This signal is emitted when font changes to font.

Note: The corresponding handler is `onFontChanged`.

### textChanged(string text)

This signal is emitted when text changes to text.

Note: The corresponding handler is `onTextChanged`.

### textColorChanged(color color)

This signal is emitted when textColor changes to color.

Note: The corresponding handler is `onTextColorChanged`.