Digital Artifex
163 lines
4.7 KiB
Plaintext
163 lines
4.7 KiB
Plaintext
// Copyright (C) 2024 The Qt Company Ltd.
|
|
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
|
|
|
|
/*!
|
|
|
|
//! [component-radius]
|
|
|
|
The radius used to draw rounded corners.
|
|
The default value is \1.
|
|
If radius is non-zero, the corners will be rounded, otherwise they will be sharp.
|
|
|
|
//! [component-radius]
|
|
|
|
//! [component-fillColor]
|
|
|
|
The \1 fill color.
|
|
|
|
A \1 can be filled with a \c solid color or with any of the \c linear, \c radial, or
|
|
\c conical gradients.
|
|
|
|
When set to \c transparent, no filling occurs.
|
|
|
|
The default value is \c white.
|
|
//! [component-fillColor]
|
|
|
|
//! [component-gradient]
|
|
|
|
The gradient of the \1 fill color.
|
|
|
|
By default, no gradient is enabled and the value is null. In this case, the fill uses a solid
|
|
color based on the value of \l fillColor.
|
|
|
|
When set, \l fillColor is ignored and filling is done using one of the \l ShapeGradient
|
|
subtypes.
|
|
//! [component-gradient]
|
|
|
|
//! [component-joinStyle]
|
|
|
|
The join style is used to connect two border line segments.
|
|
|
|
\value ShapePath.MiterJoin
|
|
The outer edges of the lines are extended to meet at an angle, and
|
|
this area is filled.
|
|
\value ShapePath.BevelJoin
|
|
The triangular notch between the two lines is filled.
|
|
This is the default value.
|
|
\value ShapePath.RoundJoin
|
|
A circular arc between the two lines is filled.
|
|
|
|
\sa Qt::PenJoinStyle
|
|
//! [component-joinStyle]
|
|
|
|
//! [component-capStyle]
|
|
|
|
The cap style defines how the end points of lines are drawn using QPainter. The cap style
|
|
only applies to lines with width 1 or greater. The cap style can be \c square, \c flat, or
|
|
\c round.
|
|
|
|
The default is \l Qt::SquareCap
|
|
|
|
\sa QPen::capStyle()
|
|
|
|
//! [component-capStyle]
|
|
|
|
//! [component-strokeStyle]
|
|
|
|
The style of the \1 stroke.
|
|
|
|
When set to \c None, no stroke is drawn.
|
|
|
|
The stroke can be set to have a \c Solid, \c Dash, \c Dot, \c {Dash Dot}, or \c {Dash Dot Dot}
|
|
pattern.
|
|
|
|
The default value is \c Solid.
|
|
|
|
//! [component-strokeStyle]
|
|
|
|
//! [component-strokeWidth]
|
|
|
|
The width of the border of the \1.
|
|
The default value is 4.
|
|
A width of 1 creates a thin line. For no line, use a negative value or a transparent color.
|
|
|
|
\note The width of the \1's border does not affect the geometry of the \1 itself or its
|
|
position relative to other items if anchors are used.
|
|
|
|
The border is rendered within the \1's boundaries.
|
|
|
|
//! [component-strokeWidth]
|
|
|
|
//! [component-strokeColor]
|
|
|
|
The color used to draw the border of the \1.
|
|
When set to \c transparent, no line is drawn.
|
|
The default value is \c red.
|
|
|
|
\sa QColor
|
|
|
|
//! [component-strokeColor]
|
|
|
|
//! [component-dashPattern]
|
|
|
|
The dash pattern of the \1 border specified as the dashes and the gaps between them.
|
|
|
|
The dash pattern is specified in units of the pen's width. That is, a dash with the length 5
|
|
and width 10 is 50 pixels long.
|
|
|
|
Each dash is also subject to cap styles, and therefore a dash of 1 with square cap set will
|
|
extend 0.5 pixels out in each direction resulting in a total width of 2.
|
|
|
|
The default value is (4, 2), meaning a dash of 4 * \l strokeWidth pixels followed by a space
|
|
of 2 * \l strokeWidth pixels.
|
|
|
|
\sa QPen::setDashPattern()
|
|
|
|
//! [component-dashPattern]
|
|
|
|
//! [component-dashOffset]
|
|
|
|
The starting point of the dash pattern for the \1 border.
|
|
|
|
The offset is measured in terms of the units used to specify the dash pattern. For example, a
|
|
pattern where each stroke is four units long, followed by a gap of two units, will begin with
|
|
the stroke when drawn as a line. However, if the dash offset is set to 4.0, any line drawn will
|
|
begin with the gap. Values of the offset up to 4.0 will cause part of the stroke to be drawn
|
|
first, and values of the offset between 4.0 and 6.0 will cause the line to begin with part of
|
|
the gap.
|
|
|
|
The default value is 0.
|
|
|
|
\sa QPen::setDashOffset()
|
|
|
|
//! [component-dashOffset]
|
|
|
|
//! [component-borderMode]
|
|
|
|
It defines where the border is drawn.
|
|
|
|
\value Border.Inside
|
|
The border is drawn along the inside edge of the item and does not
|
|
affect the item width.
|
|
This is the default value.
|
|
\value Border.Middle
|
|
The border is drawn over the edge of the item and does not
|
|
affect the item width.
|
|
\value Border.Outside
|
|
The border is drawn along the outside edge of the item and increases
|
|
the item width by the value of \l strokeWidth.
|
|
|
|
The default value is 0, which sets the border along the inside edge of the \l Item.
|
|
|
|
\sa strokeWidth
|
|
|
|
//! [component-borderMode]
|
|
|
|
//! [component-adjustBorderRadius]
|
|
|
|
It defines how the border radius is calculated for the corners.
|
|
|
|
//! [component-adjustBorderRadius]
|
|
|
|
*/
|