1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
|
// 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]
*/
|
