comp • gb.qt4 • paint • dash

Paint.Dash (gb.qt4)

Static Property Dash As Float[]

Returns or sets the dash pattern to be used by Paint.Stroke.

A dash pattern is specified by dashes, an array of positive values. Each value provides the length of alternate "on" and "off" portions of the stroke.

  • If the number of dashes is 0 dashing is disabled.

  • If the number of dashes is 1 a symmetric pattern is assumed with alternating on and off portions of the size specified by the single value in dashes.

Each "on" segment will have caps applied as if the segment were a separate sub-path. In particular, it is valid to use an "on" length of 0.0 with Paint.LineCapRound or Paint.LineCapSquare in order to distributed dots or squares along a path.

The length values are in line width units. For example, if the line width is 10 pixels, then a dash set to 3.0 is 30 pixels long.

See also