Указание точек на границе

• В следующем примере кисть градиента контура строится на основе контура в форме звезды. В коде устанавливается свойство CenterColor, что определяет цвет в центре звезды как красный. Затем устанавливается свойство SurroundColors, чтобы определить различные цвета (представленные в массиве colors) для отдельных точек, которые хранятся в массиве points. Последняя инструкция кода осуществляет заливку контура в форме звезды с помощью кисти градиента контура.

----------

• The following example draws a path gradient without a GraphicsPath object in the code. The particular PathGradientBrush constructor in the example receives an array of points but does not require a GraphicsPath object. Also, note that the PathGradientBrush is used to fill a rectangle, not a path. The rectangle is larger than the closed path used to define the brush, so some of the rectangle is not painted by the brush. The following illustration shows the rectangle (dotted line) and the portion of the rectangle painted by the path gradient brush.

• В следующем примере выполняется рисование градиента контура без использования в коде объекта GraphicsPath. Используемый в примере конструктор PathGradientBrush получает массив точек и не нуждается в объекте GraphicsPath. Кроме того, следует обратить внимание, что кисть PathGradientBrush используется для заливки прямоугольника, а не контура. Прямоугольник больше, чем замкнутый контур, используемый для задания кисти, поэтому часть прямоугольника не закрашивается этой кистью. На следующем рисунке показаны прямоугольник (пунктирная линия) и его часть, закрашенная с помощью кисти градиента контура.

----------

To customize a path gradient

• One way to customize a path gradient brush is to set its FocusScales property. The focus scales specify an inner path that lies inside the main path. The center color is displayed everywhere inside that inner path rather than only at the center point.

The following example creates a path gradient brush based on an elliptical path. The code sets the boundary color to blue, sets the center color to aqua, and then uses the path gradient brush to fill the elliptical path.

Next, the code sets the focus scales of the path gradient brush. The x focus scale is set to 0.3, and the y focus scale is set to 0.8. The code calls the TranslateTransform method of a Graphics object so that the subsequent call to FillPath fills an ellipse that sits to the right of the first ellipse.

To see the effect of the focus scales, imagine a small ellipse that shares its center with the main ellipse. The small (inner) ellipse is the main ellipse scaled (about its center) horizontally by a factor of 0.3 and vertically by a factor of 0.8. As you move from the boundary of the outer ellipse to the boundary of the inner ellipse, the color changes gradually from blue to aqua. As you move from the boundary of the inner ellipse to the shared center, the color remains aqua.

The following illustration shows the output of the following code. The ellipse on the left is aqua only at the center point. The ellipse on the right is aqua everywhere inside the inner path.