ShapeElement

java.lang.Object
- ohos.agp.components.element.Element
- - ohos.agp.components.element.ShapeElement

```
public class ShapeElement
extends Element
```
Provides an Element instance with a color gradient, which is usually used for component backgrounds.

从以下版本开始:

1

嵌套类概要

嵌套类
限定符和类型	类	说明
`static class`	`ShapeElement.Orientation`	Indicates the direction of the gradient effect relative to the element object's bounds.
`static class`	`ShapeElement.RadiusType`	Indicates the type of the processed value for the radius.

从类继承的嵌套类/接口 ohos.agp.components.element.Element
Element.ConstantState, Element.OnBoundsChangeListener, Element.OnChangeListener, Element.OnLayoutDirectionChangeListener, Element.OnRankChangeListener

字段概要

字段
限定符和类型	字段	说明
`static int`	`ARC`	Indicates that the `ShapeElement` object is in the shape of arc.
`static int`	`CORNER_END_BOTTOM_X`	Indicates the relative corner radius ID for the `end_bottom_x` tag.
`static int`	`CORNER_END_BOTTOM_Y`	Indicates the relative corner radius ID for the `end_bottom_y` tag.
`static int`	`CORNER_END_TOP_X`	Indicates the relative corner radius ID for the `end_top_x` tag.
`static int`	`CORNER_END_TOP_Y`	Indicates the relative corner radius ID for the `end_top_y` tag.
`static int`	`CORNER_LEFT_BOTTOM_X`	Indicates the corner radius ID for the `left_bottom_x` tag.
`static int`	`CORNER_LEFT_BOTTOM_Y`	Indicates the corner radius ID for the `left_bottom_y` tag.
`static int`	`CORNER_LEFT_TOP_X`	Indicates the relative corner radius ID for the `start_top_x` tag.
`static int`	`CORNER_LEFT_TOP_Y`	Indicates the relative corner radius ID for the `start_top_y` tag.
`static int`	`CORNER_RADIUS_ARRAY_SIZE`	Indicates the corner radius array size.
`static int`	`CORNER_RIGHT_BOTTOM_X`	Indicates the corner radius ID for the `right_bottom_x` tag.
`static int`	`CORNER_RIGHT_BOTTOM_Y`	Indicates the corner radius ID for the `right_bottom_y` tag.
`static int`	`CORNER_RIGHT_TOP_X`	Indicates the corner radius ID for the `right_top_x` tag.
`static int`	`CORNER_RIGHT_TOP_Y`	Indicates the corner radius ID for the `right_top_y` tag.
`static int`	`CORNER_START_BOTTOM_X`	Indicates the relative corner radius ID for the `start_bottom_x` tag.
`static int`	`CORNER_START_BOTTOM_Y`	Indicates the relative corner radius ID for the `start_bottom_y` tag.
`static int`	`CORNER_START_TOP_X`	Indicates the relative corner radius id for `start_top_x` tag.
`static int`	`CORNER_START_TOP_Y`	Indicates the relative corner radius id for `start_top_y` tag.
`static int`	`LINE`	Indicates a line.
`static int`	`LINEAR_GRADIENT_SHADER_TYPE`	Indicates that the shader is of the linear type.
`Path`	`mPath`	已过时。 Please use `getPath()` method to obtain path. This member will became a private in next version.
`static int`	`OVAL`	Indicates an oval, which can be displayed as an oval or a circle according to the width and height of the component.
`static int`	`PATH`	Indicates that the `ShapeElement` object is in a shape drawn along a particular path.
`static int`	`RADIAL_GRADIENT_SHADER_TYPE`	Indicates that the shader is of the radial type.
`static int`	`RECTANGLE`	Indicates a rectangle, for which the corner radius can be set.
`static int`	`RING`	Indicates that this `ShapeElement` is in the shape of a ring.
`static int`	`SWEEP_GRADIENT_SHADER_TYPE`	Indicates that the shader is of the sweep type.

从类继承的字段 ohos.agp.components.element.Element
ALPHA_DEFAULT, ALPHA_MAX, ALPHA_MIN, DEFAULT_BOUNDS_RECT, MAX_RANK, MIN_RANK

构造器概要

构造器
构造器	说明
`ShapeElement()`	Default constructor creates transparent element.
`ShapeElement(RgbColor color)`	A constructor used to create a `ShapeElement` with the specified color.
`ShapeElement(ShapeElement.Orientation orientation, RgbColor[] colors)`	A constructor used to create a `ShapeElement` based on the specified gradient orientation and array of colors.
`ShapeElement(Context context, int xmlId)`	A constructor used to create a `ShapeElement` instance based on the specified XML resource.

方法概要

所有方法实例方法具体方法已过时的方法
限定符和类型	方法	说明
`Arc`	`getArc()`	Obtains the arc attributes of a `ShapeElement` object in the shape of `ARC`.
`float[]`	`getCornerRadii()`	Obtains the four corner's radius.
`float[]`	`getCornerRadiiResolved()`	Obtains the resolved values of the four corners' radii.
`float`	`getCornerRadius()`	Obtains the corner radius.
`float[]`	`getDashPathEffectIntervals()`	Obtains the dash path effect intervals.
`float`	`getDashPathEffectPhase()`	Obtains the dash path effect phase.
`ShapeElement.Orientation`	`getGradientOrientation()`	Obtains the gradient direction defined in this element object.
`ShapeElement.Orientation`	`getOrientation()`	已过时。 Use `getGradientOrientation()` instead.
`Path`	`getPath()`	Obtains the path.
`RgbColor[]`	`getRgbColors()`	Obtains the color filled in this `ShapeElement` object.
`int`	`getRingRadius()`	Obtains the inner radius of this shape element.
`float`	`getRingRadiusProportion()`	Obtains the inner radius proportion of this shape element.
`int`	`getRingThickness()`	Obtains the ring thickness of this shape element.
`float`	`getRingThicknessProportion()`	Obtains the ring thickness proportion of this shape element.
`float[]`	`getShaderCenter()`	Obtains the center point position of the shader based on the proportion to this shape element's width and height.
`float`	`getShaderRadius()`	Obtains the gradient radius of this shape element.
`ShapeElement.RadiusType`	`getShaderRadiusType()`	Obtains the gradient radius type of this shape element.
`float[]`	`getShaderStops()`	Obtains shader points for this shape element.
`int`	`getShaderType()`	Obtains the shader type.
`int`	`getShape()`	Obtains the shape of this `ShapeElement` object.
`Paint.StrokeCap`	`getStrokeCap()`	Obtains the stroke cap, which specifies the shape of each drawing point of a stroke.
`RgbColor`	`getStrokeColor()`	已过时。 Use `getStrokeColors()` instead.
`RgbColor[]`	`getStrokeColors()`	Obtains the stroke colors of this shape element.
`ShapeElement.Orientation`	`getStrokeOrientation()`	Obtains the gradient direction defined for the stroke of this shape element.
`float[]`	`getStrokeShaderCenter()`	Obtains the center point position of the stroke shader based on the proportion to this shape element's width and height.
`float`	`getStrokeShaderRadius()`	Obtains the gradient radius for the stroke.
`ShapeElement.RadiusType`	`getStrokeShaderRadiusType()`	Obtains the gradient radius type for the stroke.
`int`	`getStrokeShaderType()`	Obtains the stroke shader type of this shape element.
`float[]`	`getStrokeStops()`	Obtains the stroke shader points of this shape element.
`int`	`getStrokeWidth()`	Obtains the stroke width of this `ShapeElement` object.
`boolean`	`isSectorEnabled()`	Checks whether an arc shape supports sector drawing (the space between the arc start and end points is filled).
`boolean`	`isStrokeCapEnabled()`	Checks whether the `StrokeCap` option is enabled for this shape element.
`Element`	`makeUnique()`	Make this element unique.
`void`	`setArc(Arc arc)`	Sets the arc attributes of a `ShapeElement` object in the shape of `ARC`.
`void`	`setCornerRadiiArray(float[] radii)`	Sets the each corner's radius.
`void`	`setCornerRadiiArray(float[] radii, boolean relative)`	Sets the relative radius for each corner.
`void`	`setCornerRadius(float radius)`	Sets the corner radius.
`void`	`setDashPathEffectValues(float[] intervals, float phase)`	Adds dash path effect intervals and phase for this element.
`void`	`setGradientOrientation(ShapeElement.Orientation orientation)`	Sets the direction of the gradient effect for this element object.
`void`	`setOrientation(ShapeElement.Orientation orientation)`	已过时。 Use `setGradientOrientation(ohos.agp.components.element.ShapeElement.Orientation)` instead.
`void`	`setPadding(int left, int top, int right, int bottom)`	Sets the padding for this shape element.
`void`	`setPaddingRtl(int start, int top, int end, int bottom)`	Sets the relative padding for this shape element.
`void`	`setPath(Path path)`	Sets the path.
`void`	`setRgbColor(RgbColor color)`	Sets the color for filling a `ShapeElement` object.
`void`	`setRgbColors(RgbColor[] colors)`	Sets the colors for filling a `ShapeElement` object with gradient effect.
`void`	`setRingRadius(int radius)`	Sets the inner radius for this shape element.
`void`	`setRingRadiusProportion(float radiusProportion)`	Sets the inner radius proportion for this shape element.
`void`	`setRingThickness(int thickness)`	Sets the ring thickness for this shape element.
`void`	`setRingThicknessProportion(float thicknessProportion)`	Sets the ring thickness proportion for this shape element.
`void`	`setSectorEnabled(boolean enable)`	Sets whether to enable an arc shape to support sector drawing (to fill the space between the arc start and end points).
`void`	`setShaderCenter(float x, float y)`	Sets the center point position of the gradient based on the proportion to this shape element's width and height.
`void`	`setShaderRadius(float radius, ShapeElement.RadiusType type)`	Sets a gradient radius.
`void`	`setShaderStops(float[] points)`	Sets shader points for this shape element.
`void`	`setShaderType(int type)`	Sets the shader type.
`void`	`setShape(int shape)`	Sets the shape.
`void`	`setShapeSize(int width, int height)`	Sets the size for this shape element.
`void`	`setStroke(int width, RgbColor color)`	Sets the border width and color.
`void`	`setStroke(int width, RgbColor[] colors)`	Sets the stroke width and gradient colors for this shape element.
`void`	`setStroke(int width, RgbColor[] colors, float dashSize, float dashSpace)`	Sets the stroke width and gradient colors with dashes for this shape element.
`void`	`setStroke(int width, RgbColor color, float dashSize, float dashSpace)`	Sets the stroke width and color with dashes for this shape element.
`void`	`setStrokeCap(Paint.StrokeCap cap)`	Sets the stroke cap, which specifies the shape of each drawing point of a stroke.
`void`	`setStrokeCapEnabled(boolean enable)`	Enables or disables the `StrokeCap` option for this shape element.
`void`	`setStrokeOrientation(ShapeElement.Orientation orientation)`	Sets the gradient direction for the stroke of this shape element.
`void`	`setStrokeShaderCenter(float x, float y)`	Sets the center point position of the stroke shader based on the proportion to this shape element's width and height.
`void`	`setStrokeShaderRadius(float radius, ShapeElement.RadiusType type)`	Sets the gradient radius for the stroke.
`void`	`setStrokeShaderType(int type)`	Sets the stroke shader type for this shape element.
`void`	`setStrokeStops(float[] points)`	Sets the stroke shader points for this shape element.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - ARC
```
public static final int ARC
```
    Indicates that the ShapeElement object is in the shape of arc.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    常量字段值
  - CORNER_END_BOTTOM_X
```
public static final int CORNER_END_BOTTOM_X
```
    Indicates the relative corner radius ID for the end_bottom_x tag.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - CORNER_END_BOTTOM_Y
```
public static final int CORNER_END_BOTTOM_Y
```
    Indicates the relative corner radius ID for the end_bottom_y tag.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - CORNER_END_TOP_X
```
public static final int CORNER_END_TOP_X
```
    Indicates the relative corner radius ID for the end_top_x tag.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - CORNER_END_TOP_Y
```
public static final int CORNER_END_TOP_Y
```
    Indicates the relative corner radius ID for the end_top_y tag.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - CORNER_LEFT_BOTTOM_X
```
public static final int CORNER_LEFT_BOTTOM_X
```
    Indicates the corner radius ID for the left_bottom_x tag.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - CORNER_LEFT_BOTTOM_Y
```
public static final int CORNER_LEFT_BOTTOM_Y
```
    Indicates the corner radius ID for the left_bottom_y tag.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - CORNER_LEFT_TOP_X
```
public static final int CORNER_LEFT_TOP_X
```
    Indicates the relative corner radius ID for the start_top_x tag.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - CORNER_LEFT_TOP_Y
```
public static final int CORNER_LEFT_TOP_Y
```
    Indicates the relative corner radius ID for the start_top_y tag.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - CORNER_RADIUS_ARRAY_SIZE
```
public static final int CORNER_RADIUS_ARRAY_SIZE
```
    Indicates the corner radius array size.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - CORNER_RIGHT_BOTTOM_X
```
public static final int CORNER_RIGHT_BOTTOM_X
```
    Indicates the corner radius ID for the right_bottom_x tag.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - CORNER_RIGHT_BOTTOM_Y
```
public static final int CORNER_RIGHT_BOTTOM_Y
```
    Indicates the corner radius ID for the right_bottom_y tag.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - CORNER_RIGHT_TOP_X
```
public static final int CORNER_RIGHT_TOP_X
```
    Indicates the corner radius ID for the right_top_x tag.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - CORNER_RIGHT_TOP_Y
```
public static final int CORNER_RIGHT_TOP_Y
```
    Indicates the corner radius ID for the right_top_y tag.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - CORNER_START_BOTTOM_X
```
public static final int CORNER_START_BOTTOM_X
```
    Indicates the relative corner radius ID for the start_bottom_x tag.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - CORNER_START_BOTTOM_Y
```
public static final int CORNER_START_BOTTOM_Y
```
    Indicates the relative corner radius ID for the start_bottom_y tag.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - CORNER_START_TOP_X
```
public static final int CORNER_START_TOP_X
```
    Indicates the relative corner radius id for start_top_x tag.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - CORNER_START_TOP_Y
```
public static final int CORNER_START_TOP_Y
```
    Indicates the relative corner radius id for start_top_y tag.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - LINE
```
public static final int LINE
```
    Indicates a line.
    
    另请参阅:
    
    常量字段值
  - LINEAR_GRADIENT_SHADER_TYPE
```
public static final int LINEAR_GRADIENT_SHADER_TYPE
```
    Indicates that the shader is of the linear type.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    常量字段值
  - OVAL
```
public static final int OVAL
```
    Indicates an oval, which can be displayed as an oval or a circle according to the width and height of the component.
    
    另请参阅:
    
    常量字段值
  - PATH
```
public static final int PATH
```
    Indicates that the ShapeElement object is in a shape drawn along a particular path.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    常量字段值
  - RADIAL_GRADIENT_SHADER_TYPE
```
public static final int RADIAL_GRADIENT_SHADER_TYPE
```
    Indicates that the shader is of the radial type.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    常量字段值
  - RECTANGLE
```
public static final int RECTANGLE
```
    Indicates a rectangle, for which the corner radius can be set.
    
    另请参阅:
    
    常量字段值
  - RING
```
public static final int RING
```
    Indicates that this ShapeElement is in the shape of a ring.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    常量字段值
  - SWEEP_GRADIENT_SHADER_TYPE
```
public static final int SWEEP_GRADIENT_SHADER_TYPE
```
    Indicates that the shader is of the sweep type.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    常量字段值
  - mPath
```
@Deprecated
public Path mPath
```
    已过时。 Please use getPath() method to obtain path. This member will became a private in next version.
    
    Indicates a path, for a ShapeElement shape PATH.
    
    另请参阅:
    
    setShape(int)
- 构造器详细资料
  - ShapeElement
```
public ShapeElement()
```
    Default constructor creates transparent element.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    ShapeElement(RgbColor), ShapeElement(Orientation, RgbColor[])
  - ShapeElement
```
public ShapeElement(RgbColor color)
```
    A constructor used to create a ShapeElement with the specified color.
    
    参数:
    
    color - Indicates the color.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    ShapeElement(), ShapeElement(Orientation, RgbColor[])
  - ShapeElement
```
public ShapeElement(ShapeElement.Orientation orientation,
                    RgbColor[] colors)
```
    A constructor used to create a ShapeElement based on the specified gradient orientation and array of colors.
    
    参数:
    
    orientation - Indicates the direction (angle) of the gradient.
    
    colors - Indicates the colors for filling the shape element.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    ShapeElement(), ShapeElement(RgbColor)
  - ShapeElement
```
public ShapeElement(Context context,
                    int xmlId)
```
    A constructor used to create a ShapeElement instance based on the specified XML resource.
    
    参数:
    
    context - Indicates the application context.
    
    xmlId - Indicates the ID of the XML resource.
    
    抛出:
    
    ElementScatterException - Throws this exception if the context value is null.
    
    从以下版本开始:
    
    3
- 方法详细资料
  - setRingRadiusProportion
```
public void setRingRadiusProportion(float radiusProportion)
```
    Sets the inner radius proportion for this shape element.
    When a radius is set, the radius proportion does not take effect.
    
    Calling this method to change the properties will affect all shape element instances loaded from the same resource. Call makeUnique() before calling this method.
    
    参数:
    
    radiusProportion - Indicates the inner radius proportion to set. The default value is 3.0. The value must be positive.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the radiusProportion value is invalid.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    getRingRadiusProportion(), setRingRadius(int), getRingRadius(), makeUnique()
  - getRingRadiusProportion
```
public float getRingRadiusProportion()
```
    Obtains the inner radius proportion of this shape element.
    
    返回:
    
    Returns the inner radius proportion. If a custom value is not specified, the default value will be returned.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setRingRadiusProportion(float)
  - setRingRadius
```
public void setRingRadius(int radius)
```
    Sets the inner radius for this shape element.
    When a radius is set, the radius proportion does not take effect.
    
    Calling this method to change the properties will affect all shape element instances loaded from the same resource. Call makeUnique() before calling this method.
    
    参数:
    
    radius - Indicates the inner radius to set. The value must be positive or 0. If the value is 0, the radius proportion will be used.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the radius value is less than 0.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    getRingRadius(), setRingRadiusProportion(float), getRingRadiusProportion(), makeUnique()
  - getRingRadius
```
public int getRingRadius()
```
    Obtains the inner radius of this shape element.
    
    返回:
    
    Returns the inner radius. If a custom value is not specified, the default value (0) will be returned.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setRingRadius(int)
  - setRingThicknessProportion
```
public void setRingThicknessProportion(float thicknessProportion)
```
    Sets the ring thickness proportion for this shape element.
    When a thickness is set, the thickness proportion does not take effect.
    
    Calling this method to change the properties will affect all shape element instances loaded from the same resource. Call makeUnique() before calling this method.
    
    参数:
    
    thicknessProportion - Indicates the ring thickness proportion to set. The default value is 9.0f. The value must be positive.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the thicknessProportion value is invalid.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    getRingThicknessProportion(), setRingThickness(int), getRingThickness(), makeUnique()
  - getRingThicknessProportion
```
public float getRingThicknessProportion()
```
    Obtains the ring thickness proportion of this shape element.
    
    返回:
    
    Returns the ring thickness proportion. If a custom value is not specified, the default value will be returned.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setRingThicknessProportion(float)
  - setRingThickness
```
public void setRingThickness(int thickness)
```
    Sets the ring thickness for this shape element.
    When a thickness is set, the thickness proportion does not take effect.
    
    Calling this method to change the properties will affect all shape element instances loaded from the same resource. Call makeUnique() before calling this method.
    
    参数:
    
    thickness - Indicates the ring thickness to set. The value must be positive or 0. If the value is 0, the ring thickness proportion will be used.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the thickness value is invalid.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    getRingThickness(), setRingThicknessProportion(float), getRingThicknessProportion(), makeUnique()
  - getRingThickness
```
public int getRingThickness()
```
    Obtains the ring thickness of this shape element.
    
    返回:
    
    Returns the ring thickness. If a custom value is not specified, the default value (0) will be returned.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setRingThicknessProportion(float)
  - setShape
```
public void setShape(int shape)
```
    Sets the shape.
    Note: be careful with the changing this property because it will affect all instances of an element loaded from the same resource. Please invoke makeUnique() before changing this property.
    
    参数:
    
    shape - Indicates the shape, which can be RECTANGLE, OVAL, LINE, ARC, PATH or RING.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the shape value isn't RECTANGLE, OVAL, LINE, ARC, PATH or RING.
    
    另请参阅:
    
    getPath(), makeUnique()
  - getShape
```
public int getShape()
```
    Obtains the shape of this ShapeElement object.
    
    返回:
    
    Returns the integer that represents the shape.
    
    另请参阅:
    
    setShape(int)
  - setShapeSize
```
public void setShapeSize(int width,
                         int height)
```
    Sets the size for this shape element.
    Calling this method to change the properties will affect all shape element instances loaded from the same resource. Call makeUnique() before calling this method.
    
    参数:
    
    width - Indicates the width of the shape element. The value must be positive or -1, which means that the shape width is the same as the container width.
    
    height - Indicates the height of the shape element. The value must be positive or -1, which means that the shape height is the same as the container height.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the width or height value is invalid.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    makeUnique()
  - setPadding
```
public void setPadding(int left,
                       int top,
                       int right,
                       int bottom)
```
    Sets the padding for this shape element.
    Calling this method to change the properties will affect all shape element instances loaded from the same resource. Call makeUnique() before calling this method.
    
    参数:
    
    left - Indicates the left padding to set. The value must be positive or 0.
    
    top - Indicates the top padding to set. The value must be positive or 0.
    
    right - Indicates the right padding to set. The value must be positive or 0.
    
    bottom - Indicates the bottom padding to set. The value must be positive or 0.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if any of the passed values is invalid.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setPaddingRtl(int, int, int, int), makeUnique()
  - setPaddingRtl
```
public void setPaddingRtl(int start,
                          int top,
                          int end,
                          int bottom)
```
    Sets the relative padding for this shape element.
    Calling this method to change the properties will affect all shape element instances loaded from the same resource. Call makeUnique() before calling this method.
    
    参数:
    
    start - Indicates the start padding to set. The value must be positive or 0.
    
    top - Indicates the top padding to set. The value must be positive or 0.
    
    end - Indicates the end padding to set. The value must be positive or 0.
    
    bottom - Indicates the bottom padding to set. The value must be positive or 0.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if any of the passed values is invalid.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setPadding(int, int, int, int), makeUnique()
  - setRgbColor
```
public void setRgbColor(RgbColor color)
```
    Sets the color for filling a ShapeElement object.
    This method does not take effect if the shape of the ShapeElement instance is LINE. Use the setRgbColors(ohos.agp.colors.RgbColor[]) method to achieve gradient effect.
    
    Note: be careful with the changing this property because it will affect all instances of an element loaded from the same resource. Please invoke makeUnique() before changing this property.
    
    参数:
    
    color - Indicates the color value. The value null means transparent color.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    setRgbColors(RgbColor[]), getRgbColors(), makeUnique(), RgbPalette
  - setRgbColors
```
public void setRgbColors(RgbColor[] colors)
```
    Sets the colors for filling a ShapeElement object with gradient effect.
    This method does not take effect if the shape of the ShapeElement object is LINE. You can call setRgbColor(ohos.agp.colors.RgbColor) to apply a single color to a ShapeElement object.
    
    Note: For set this property in XML use attribute ohos:colors with next inner parameters: 1.#AARRGGBB - RgbColor in hex type. For example: ohos:colors = "#FFFFFFFF" 2.#RRGGBB - RgbColor in hex type where alpha for color will 0xFF. For example: ohos:colors = "#FFFFFF" 3.name_of_color - value from RgbPalette. For example: ohos:colors = "red, green, blue" 4.color:name_of_color - multiple color from user json file in resource where color: indicates that the color is in the resources and name_of_color is name of color in user json file. For example:
```
     <shape>
         <solid ohos:colors="color:dark_violet, green, #FF0000FF, ..., color:canary_yellow"/>
      </shape>
 
```
    Note: If write incorrect color program throw IllegalArgumentException
    Note: be careful with the changing this property because it will affect all instances of an element loaded from the same resource. Please invoke makeUnique() before changing this property.
    参数:
    
    colors - Indicates the colors for filling the shape element object.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    setRgbColor(RgbColor), getRgbColors(), makeUnique(), RgbPalette
  - getRgbColors
```
public RgbColor[] getRgbColors()
```
    Obtains the color filled in this ShapeElement object.
    
    返回:
    
    Returns the array of color gradients; returns an element if a pure color is set.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    setRgbColors(RgbColor[]), setRgbColor(RgbColor)
  - setStroke
```
public void setStroke(int width,
                      RgbColor color)
```
    Sets the border width and color.
    Note: be careful with the changing this property because it will affect all instances of an element loaded from the same resource. Please invoke makeUnique() before changing this property.
    
    Note: For set this property in XML use attribute ohos:colors with next inner parameters: 1.#AARRGGBB - RgbColor in hex type. For example: ohos:colors = "#FFFFFFFF" 2.#RRGGBB - RgbColor in hex type where alpha for color will 0xFF. For example: ohos:colors = "#FFFFFF" 3.name_of_color - value from RgbPalette. For example: ohos:colors = "red, green, blue" 4.color:name_of_color - multiple color from user json file in resource where color: indicates that the color is in the resources and name_of_color is name of color in user json file. For example:
```
     <shape>
         <stroke ohos:colors="color:dark_violet, green, #FF0000FF, ..., color:canary_yellow"/>
      </shape>
 
```
    Note: If write incorrect color program throw IllegalArgumentException
    参数:
    
    width - Indicates the border width. The value must be positive or 0. Value 0 means no stroke. Invalide values are ignored.
    
    color - Indicates the border color. The value null means transparent border.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    setStroke(int, RgbColor[]), setStroke(int, RgbColor, float, float), setStroke(int, RgbColor[], float, float), getStrokeColors(), getStrokeWidth(), makeUnique(), RgbPalette
  - setStroke
```
public void setStroke(int width,
                      RgbColor[] colors)
```
    Sets the stroke width and gradient colors for this shape element.
    Calling this method to change the properties will affect all shape element instances loaded from the same resource. Call makeUnique() before calling this method.
    
    参数:
    
    width - Indicates the stroke width to set. The value must be positive or 0. No stroke is drawn when the value is 0. Nothing happens when an invalid value is passed.
    
    colors - Indicates the stroke gradient colors to set. A transparent stroke is drawn when the value is null.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setStroke(int, RgbColor[]), setStroke(int, RgbColor, float, float), setStroke(int, RgbColor[], float, float), getStrokeColors(), getStrokeWidth(), makeUnique()
  - setStroke
```
public void setStroke(int width,
                      RgbColor color,
                      float dashSize,
                      float dashSpace)
```
    Sets the stroke width and color with dashes for this shape element.
    The dash usage is equivalent to setDashPathEffectValues(float[],float) with the dash path effect intervals (specified by dashSize and dashSpace) and the phase 0 as input parameters.
    Calling this method to change the properties will affect all shape element instances loaded from the same resource. Call makeUnique() before calling this method.
    
    参数:
    
    width - Indicates the stroke width to set. The value must be positive or 0. No stroke is drawn when the value is 0. Nothing happens when an invalid value is passed.
    
    color - Indicates the stroke color to set. A transparent stroke is drawn when the value is null.
    
    dashSize - Indicates the length of each dash, in pixels. The value must be positive or 0. No dash is drawn when the value is 0 or negative.
    
    dashSpace - Indicates the gap between two adjacent dashes, in pixels. The value must be positive. No dash is drawn when the value is 0 or negative.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setStroke(int, RgbColor), setStroke(int, RgbColor[]), setStroke(int, RgbColor[], float, float), setStrokeCap(Paint.StrokeCap), getStrokeColors(), getStrokeWidth(), setDashPathEffectValues(float[], float), makeUnique()
  - setStroke
```
public void setStroke(int width,
                      RgbColor[] colors,
                      float dashSize,
                      float dashSpace)
```
    Sets the stroke width and gradient colors with dashes for this shape element.
    The dash usage is equivalent to setDashPathEffectValues(float[],float) with the dash path effect intervals (specified by dashSize and dashSpace) and the phase 0 as input parameters.
    Calling this method to change the properties will affect all shape element instances loaded from the same resource. Call makeUnique() before calling this method.
    
    参数:
    
    width - Indicates the stroke width to set. The value must be positive or 0. No stroke is drawn when the value is 0. Nothing happens when an invalid value is passed.
    
    colors - Indicates the stroke colors to set. The value null means a transparent stroke.
    
    dashSize - Indicates the length of each dash, in pixels. The value must be positive or 0. No dash is drawn when the value is 0 or negative.
    
    dashSpace - Indicates the gap between two adjacent dashes, in pixels. The value must be positive. No dash is drawn when the value is 0 or negative.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setStroke(int, RgbColor), setStroke(int, RgbColor[]), setStroke(int, RgbColor, float, float), getStrokeColors(), getStrokeWidth(), setDashPathEffectValues(float[], float), makeUnique()
  - getStrokeWidth
```
public int getStrokeWidth()
```
    Obtains the stroke width of this ShapeElement object.
    
    返回:
    
    Returns the stroke width, in pixels.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    setStroke(int, RgbColor)
  - getStrokeColor
```
@Deprecated
public RgbColor getStrokeColor()
```
    已过时。 Use getStrokeColors() instead.
    
    Obtains the color of the stroke.
    
    返回:
    
    Returns the stroke color.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    setStroke(int, RgbColor)
  - getStrokeColors
```
public RgbColor[] getStrokeColors()
```
    Obtains the stroke colors of this shape element.
    
    返回:
    
    Returns the stroke color array.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setStroke(int, RgbColor), setStroke(int, RgbColor[]), setStroke(int, RgbColor, float, float), setStroke(int, RgbColor[], float, float)
  - setStrokeCap
```
public void setStrokeCap(Paint.StrokeCap cap)
```
    Sets the stroke cap, which specifies the shape of each drawing point of a stroke.
    Calling this method to change the properties will affect all shape element instances loaded from the same resource. Call makeUnique() before calling this method.
    
    参数:
    
    cap - Indicates the stroke cap to set. The value cannot be null.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the cap value is invalid.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    getStrokeCap(), setStrokeCapEnabled(boolean), isStrokeCapEnabled()
  - getStrokeCap
```
public Paint.StrokeCap getStrokeCap()
```
    Obtains the stroke cap, which specifies the shape of each drawing point of a stroke.
    
    返回:
    
    Returns the stroke cap.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setStrokeCap(Paint.StrokeCap), setStrokeCapEnabled(boolean), isStrokeCapEnabled()
  - setStrokeCapEnabled
```
public void setStrokeCapEnabled(boolean enable)
```
    Enables or disables the StrokeCap option for this shape element.
    Enable the StrokeCap option if you want to draw stroke caps.
    
    Calling this method to change the properties will affect all shape element instances loaded from the same resource. Call makeUnique() before calling this method.
    
    参数:
    
    enable - Specifies whether to enable the StrokeCap option. The value true means to enable the option, and false means the opposite. The default value is false.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setStrokeCap(Paint.StrokeCap), isStrokeCapEnabled()
  - isStrokeCapEnabled
```
public boolean isStrokeCapEnabled()
```
    Checks whether the StrokeCap option is enabled for this shape element.
    
    返回:
    
    Returns true if the StrokeCap option is enabled; returns false otherwise.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setStrokeCapEnabled(boolean)
  - setStrokeStops
```
public void setStrokeStops(float[] points)
```
    Sets the stroke shader points for this shape element.
    Colors are distributed evenly between the start and end points, which are 0.0f and 1.0f, respectively. Intermediate values must be strictly increasing.
    
    Calling this method to change the properties will affect all shape element instances loaded from the same resource. Call makeUnique() before calling this method.
    
    参数:
    
    points - Indicates the points where gradient colors are drawn. The value of each point ranges from 0.0f to 1.0f.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the points value is invalid.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    getStrokeStops(), makeUnique()
  - getStrokeStops
```
public float[] getStrokeStops()
```
    Obtains the stroke shader points of this shape element.
    Colors are distributed evenly between the start and end points, which are 0.0f and 1.0f, respectively. Intermediate values must be strictly increasing.
    
    返回:
    
    Returns the points between 0.0f and 1.0f.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setStrokeStops(float[])
  - setStrokeShaderType
```
public void setStrokeShaderType(int type)
```
    Sets the stroke shader type for this shape element.
    Calling this method to change the properties will affect all shape element instances loaded from the same resource. Call makeUnique() before calling this method.
    
    参数:
    
    type - Indicates the stroke shader type to set, which can be LINEAR_GRADIENT_SHADER_TYPE, RADIAL_GRADIENT_SHADER_TYPE, or SWEEP_GRADIENT_SHADER_TYPE. The default value is LINEAR_GRADIENT_SHADER_TYPE.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the type value is invalid.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    getStrokeShaderType(), makeUnique()
  - getStrokeShaderType
```
public int getStrokeShaderType()
```
    Obtains the stroke shader type of this shape element.
    
    返回:
    
    Returns the stroke shader type.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setStrokeShaderType(int)
  - setStrokeOrientation
```
public void setStrokeOrientation(ShapeElement.Orientation orientation)
```
    Sets the gradient direction for the stroke of this shape element.
    Calling this method to change the properties will affect all shape element instances loaded from the same resource. Call makeUnique() before calling this method.
    
    参数:
    
    orientation - Indicates the direction (angle) to specify for the gradient.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    getStrokeOrientation(), makeUnique()
  - getStrokeOrientation
```
public ShapeElement.Orientation getStrokeOrientation()
```
    Obtains the gradient direction defined for the stroke of this shape element.
    
    返回:
    
    Returns the gradient direction of the stroke.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setStrokeOrientation(Orientation)
  - setStrokeShaderCenter
```
public void setStrokeShaderCenter(float x,
                                  float y)
```
    Sets the center point position of the stroke shader based on the proportion to this shape element's width and height.
    Calling this method to change the properties will affect all shape element instances loaded from the same resource. Call makeUnique() before calling this method.
    
    This method works only when the stroke shader type is RADIAL_GRADIENT_SHADER_TYPE or SWEEP_GRADIENT_SHADER_TYPE.
    
    参数:
    
    x - Indicates the x-position of the shader point based on the proportion to the width. The default value is 0.5. The value must be positive or 0.0f.
    
    y - Indicates the y-position of the shader point based on the proportion to the height. The default value is 0.5. The value must be positive or 0.0f.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the x or y value is invalid.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    getStrokeShaderCenter(), makeUnique()
  - getStrokeShaderCenter
```
public float[] getStrokeShaderCenter()
```
    Obtains the center point position of the stroke shader based on the proportion to this shape element's width and height.
    
    返回:
    
    Returns the float array where the first element is the x-position and the second element is the y-position.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setStrokeShaderCenter(float, float)
  - setStrokeShaderRadius
```
public void setStrokeShaderRadius(float radius,
                                  ShapeElement.RadiusType type)
```
    Sets the gradient radius for the stroke.
    This method works only when the shader type is RADIAL_GRADIENT_SHADER_TYPE.
    
    Calling this method to change the properties will affect all shape element instances loaded from the same resource. Call makeUnique() before calling this method.
    
    参数:
    
    radius - Indicates the radius of the gradient to set. The value must be positive or 0.0f.
    
    type - Indicates the radius value type. If the value is RadiusType#FRACTION, the radius is a proportion to the element size (minimum of width and height). If the value is RadiusType#PIXELS, the radius is a value in pixels.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the radius or type value is invalid.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    getStrokeShaderRadius(), getStrokeShaderRadiusType(), makeUnique()
  - getStrokeShaderRadius
```
public float getStrokeShaderRadius()
```
    Obtains the gradient radius for the stroke.
    The radius is valid only when the shader type is RADIAL_GRADIENT_SHADER_TYPE.
    
    返回:
    
    Returns the radius of the gradient.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setStrokeShaderRadius(float, RadiusType)
  - getStrokeShaderRadiusType
```
public ShapeElement.RadiusType getStrokeShaderRadiusType()
```
    Obtains the gradient radius type for the stroke.
    The radius is valid only when the shader type is RADIAL_GRADIENT_SHADER_TYPE.
    
    返回:
    
    Returns the radius type of the gradient.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setStrokeShaderRadius(float, RadiusType)
  - setCornerRadius
```
public void setCornerRadius(float radius)
```
    Sets the corner radius. This parameter is valid only when the shape is RECTANGLE.
    Note: be careful with the changing this property because it will affect all instances of an element loaded from the same resource. Please invoke makeUnique() before changing this property.
    
    参数:
    
    radius - Indicates the radius. If this parameter is set to a value greater than 0, the rectangle is a rounded rectangle. If the value is less than 0, the setting is invalid.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the radius value is invalid.
    
    另请参阅:
    
    getCornerRadius(), makeUnique()
  - getCornerRadius
```
public float getCornerRadius()
```
    Obtains the corner radius.
    
    返回:
    
    Returns the radius, in floating number.
    
    另请参阅:
    
    setCornerRadius(float)
  - setCornerRadiiArray
```
public void setCornerRadiiArray(float[] radii)
```
    Sets the each corner's radius. This parameter is valid only when the shape is RECTANGLE.
    Note: be careful with the changing this property because it will affect all instances of an element loaded from the same resource. Please invoke makeUnique() before changing this property.
    
    参数:
    
    radii - Indicates the radius array of four corners. If the array's length is not equal to 8, the setting is invalid. Each pair of radius means one corner's x-axis radius and y-axis radius. The values in array must be positive or 0.0f.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the radii array length isn't 8.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    getCornerRadii(), makeUnique()
  - setCornerRadiiArray
```
public void setCornerRadiiArray(float[] radii,
                                boolean relative)
```
    Sets the relative radius for each corner. This method is valid only when the shape is RECTANGLE.
    Calling this method to change the properties will affect all shape element instances loaded from the same resource. Call makeUnique() before calling this method.
    
    参数:
    
    radii - Indicates the relative radius array of four corners. If the array's length is not equal to 8, the setting is invalid. Each pair of radii means the x-axis radius and y-axis radius of a corner. The values in the array must be positive or 0.0f.
    
    relative - Specifies whether to use the relative radius. The value true means to use the relative radius, and false means the opposite.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the array length of radii is not CORNER_RADIUS_ARRAY_SIZE.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setCornerRadiiArray(float[]), getCornerRadii(), getCornerRadiiResolved(), makeUnique()
  - getCornerRadii
```
public float[] getCornerRadii()
```
    Obtains the four corner's radius.
    
    返回:
    
    Returns the radii, in floating array numbers.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    setCornerRadiiArray(float[]), setCornerRadiiArray(float[], boolean), getCornerRadiiResolved()
  - getCornerRadiiResolved
```
public float[] getCornerRadiiResolved()
```
    Obtains the resolved values of the four corners' radii.
    
    返回:
    
    Returns the radii, in a floating array.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setCornerRadiiArray(float[], boolean)
  - setShaderType
```
public void setShaderType(int type)
```
    Sets the shader type.
    Note: be careful with the changing this property because it will affect all instances of an element loaded from the same resource. Please invoke makeUnique() before changing this property.
    
    参数:
    
    type - Indicates the shader type, which can be LINEAR_GRADIENT_SHADER_TYPE, RADIAL_GRADIENT_SHADER_TYPE, or SWEEP_GRADIENT_SHADER_TYPE. The default value is LINEAR_GRADIENT_SHADER_TYPE.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the type value is invalid.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    getShaderType(), makeUnique()
  - getShaderType
```
public int getShaderType()
```
    Obtains the shader type.
    
    返回:
    
    Returns the shader type.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    setShaderType(int)
  - setShaderStops
```
public void setShaderStops(float[] points)
```
    Sets shader points for this shape element.
    Colors are distributed evenly between the start and end points, which are 0.0f and 1.0f, respectively. Intermediate values must be strictly increasing.
    
    Calling this method to change the properties will affect all shape element instances loaded from the same resource. Call makeUnique() before calling this method.
    
    参数:
    
    points - Indicates the points to draw shade colors. The value ranges from 0.0f to 1.0f.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    getShaderStops(), makeUnique()
  - getShaderStops
```
public float[] getShaderStops()
```
    Obtains shader points for this shape element.
    Colors are distributed evenly between the start and end points, which are 0.0f and 1.0f, respectively. Intermediate values must be strictly increasing.
    
    返回:
    
    Returns the points between 0.0f and 1.0f.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    getShaderStops()
  - setArc
```
public void setArc(Arc arc)
```
    Sets the arc attributes of a ShapeElement object in the shape of ARC.
    Note: be careful with the changing this property because it will affect all instances of an element loaded from the same resource. Please invoke makeUnique() before changing this property.
    
    参数:
    
    arc - Indicates the arc attributes to set.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the arc value is null.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    getArc(), makeUnique()
  - getArc
```
public Arc getArc()
```
    Obtains the arc attributes of a ShapeElement object in the shape of ARC.
    
    返回:
    
    Returns the arc.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    setArc(Arc), setSectorEnabled(boolean)
  - setSectorEnabled
```
public void setSectorEnabled(boolean enable)
```
    Sets whether to enable an arc shape to support sector drawing (to fill the space between the arc start and end points).
    This parameter is valid only when the shape type is ARC.
    
    Calling this method to change the properties will affect all shape element instances loaded from the same resource. Call makeUnique() before calling this method.
    
    参数:
    
    enable - Specifies whether to support sector drawing for an arc shape. The value true means to support sector drawing, and false means the opposite. The default value is false.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    isSectorEnabled(), setArc(Arc), makeUnique()
  - isSectorEnabled
```
public boolean isSectorEnabled()
```
    Checks whether an arc shape supports sector drawing (the space between the arc start and end points is filled).
    
    返回:
    
    Returns true if sector drawing is supported; returns false otherwise.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setSectorEnabled(boolean)
  - setGradientOrientation
```
public void setGradientOrientation(ShapeElement.Orientation orientation)
```
    Sets the direction of the gradient effect for this element object.
    Note: be careful with the changing this property because it will affect all instances of an element loaded from the same resource. Please invoke makeUnique() before changing this property.
    
    参数:
    
    orientation - Indicates the direction (angle) to specify for the gradient effect of this element object.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    getGradientOrientation(), makeUnique()
  - getGradientOrientation
```
public ShapeElement.Orientation getGradientOrientation()
```
    Obtains the gradient direction defined in this element object.
    
    返回:
    
    Returns the gradient direction of this element object.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    setGradientOrientation(Orientation)
  - setOrientation
```
@Deprecated
public void setOrientation(ShapeElement.Orientation orientation)
```
    已过时。 Use setGradientOrientation(ohos.agp.components.element.ShapeElement.Orientation) instead.
    
    Sets the direction of the gradient effect for this element object.
    Note: be careful with the changing this property because it will affect all instances of an element loaded from the same resource. Please invoke makeUnique() before changing this property.
    
    参数:
    
    orientation - Indicates the direction (angle) to specify for the gradient effect of this element object.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    getOrientation(), makeUnique()
  - getOrientation
```
@Deprecated
public ShapeElement.Orientation getOrientation()
```
    已过时。 Use getGradientOrientation() instead.
    
    Obtains the gradient direction defined in this element object.
    
    返回:
    
    Returns the gradient direction of this element object.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    setOrientation(Orientation)
  - setPath
```
public void setPath(Path path)
```
    Sets the path. This parameter is valid only when the shape is PATH.
    
    参数:
    
    path - Indicates the path.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the path value is null.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    getPath()
  - getPath
```
public Path getPath()
```
    Obtains the path.
    
    返回:
    
    Returns the path.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    setPath(Path)
  - setDashPathEffectValues
```
public void setDashPathEffectValues(float[] intervals,
                                    float phase)
```
    Adds dash path effect intervals and phase for this element.
    Note: be careful with the changing this property because it will affect all instances of an element loaded from the same resource. Please invoke makeUnique() before changing this property.
    
    参数:
    
    intervals - Indicates the dash path effect value array to set. The array items are in pairs: The even and odd indices of these values specify the number of pixels to draw and the number of blank pixels, respectively. Each interval value must be positive or 0.0f.
    
    phase - Indicates the dash path effect phase.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the intervals values are invalid.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    getDashPathEffectIntervals(), getDashPathEffectPhase(), makeUnique()
  - getDashPathEffectIntervals
```
public float[] getDashPathEffectIntervals()
```
    Obtains the dash path effect intervals.
    The intervals are in pairs. The even and odd indices of these values specify the number of pixels to draw and the number of blank pixels, respectively.
    
    返回:
    
    Returns the dash path effect intervals.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setDashPathEffectValues(float[], float)
  - getDashPathEffectPhase
```
public float getDashPathEffectPhase()
```
    Obtains the dash path effect phase.
    
    返回:
    
    Returns the dash path effect phase.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setDashPathEffectValues(float[], float)
  - setShaderCenter
```
public void setShaderCenter(float x,
                            float y)
```
    Sets the center point position of the gradient based on the proportion to this shape element's width and height.
    Calling this method to change the properties will affect all shape element instances loaded from the same resource. Call makeUnique() before calling this method.
    
    This method works only when the stroke shader type is RADIAL_GRADIENT_SHADER_TYPE or SWEEP_GRADIENT_SHADER_TYPE.
    
    参数:
    
    x - Indicates the x-position of the gradient point based on the proportion to the width. The default value is 0.5. The value must be positive or 0.0f.
    
    y - Indicates the y-position of the gradient point based on the proportion to the height. The default value is 0.5. The value must be positive or 0.0f.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the x or y value is invalid.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    getShaderCenter(), makeUnique()
  - getShaderCenter
```
public float[] getShaderCenter()
```
    Obtains the center point position of the shader based on the proportion to this shape element's width and height.
    
    返回:
    
    Returns the float array where the first element is the x-position and the second element is the y-position.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setShaderCenter(float, float)
  - setShaderRadius
```
public void setShaderRadius(float radius,
                            ShapeElement.RadiusType type)
```
    Sets a gradient radius.
    This method can be used only when the shader type is RADIAL_GRADIENT_SHADER_TYPE.
    
    Calling this method to change the properties will affect all shape element instances loaded from the same resource. Call makeUnique() before calling this method.
    
    参数:
    
    radius - Indicates the radius of the gradient to set. The value must be positive or 0.0f.
    
    type - Indicates the radius value type. If the value is RadiusType#FRACTION, the radius is a proportion to the element size (minimum of width and height). If the value is RadiusType#PIXELS, the radius is a value in pixels.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the radius value is invalid or type is null.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    getShaderRadius(), getShaderRadiusType(), makeUnique(), ShapeElement.RadiusType
  - getShaderRadius
```
public float getShaderRadius()
```
    Obtains the gradient radius of this shape element.
    The radius is valid only when the shader type is RADIAL_GRADIENT_SHADER_TYPE.
    
    返回:
    
    Returns the radius of the gradient.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setShaderRadius(float, RadiusType), getShaderRadiusType()
  - getShaderRadiusType
```
public ShapeElement.RadiusType getShaderRadiusType()
```
    Obtains the gradient radius type of this shape element.
    The radius is valid only when the shader type is RADIAL_GRADIENT_SHADER_TYPE.
    
    返回:
    
    Returns the radius type of the gradient.
    
    从以下版本开始:
    
    7
    
    另请参阅:
    
    setShaderRadius(float, RadiusType), getShaderRadius()
  - makeUnique
```
public Element makeUnique()
```
    Make this element unique. A unique element is guaranteed to not share its properties values with any other elements.
    
    从以下版本开始:
    
    7

类 ShapeElement

嵌套类概要

从类继承的嵌套类/接口 ohos.agp.components.element.Element

字段概要

从类继承的字段 ohos.agp.components.element.Element

构造器概要

方法概要

从类继承的方法 ohos.agp.components.element.Element

从类继承的方法 java.lang.Object

字段详细资料

ARC

CORNER_END_BOTTOM_X

CORNER_END_BOTTOM_Y

CORNER_END_TOP_X

CORNER_END_TOP_Y

CORNER_LEFT_BOTTOM_X

CORNER_LEFT_BOTTOM_Y

CORNER_LEFT_TOP_X

CORNER_LEFT_TOP_Y

CORNER_RADIUS_ARRAY_SIZE

CORNER_RIGHT_BOTTOM_X

CORNER_RIGHT_BOTTOM_Y

CORNER_RIGHT_TOP_X

CORNER_RIGHT_TOP_Y

CORNER_START_BOTTOM_X

CORNER_START_BOTTOM_Y

CORNER_START_TOP_X

CORNER_START_TOP_Y

LINE

LINEAR_GRADIENT_SHADER_TYPE

OVAL

PATH

RADIAL_GRADIENT_SHADER_TYPE

RECTANGLE

RING

SWEEP_GRADIENT_SHADER_TYPE

mPath

构造器详细资料

ShapeElement

ShapeElement

ShapeElement

ShapeElement

方法详细资料

setRingRadiusProportion

getRingRadiusProportion

setRingRadius

getRingRadius

setRingThicknessProportion

getRingThicknessProportion

setRingThickness

getRingThickness

setShape

getShape

setShapeSize

setPadding

setPaddingRtl

setRgbColor

setRgbColors

getRgbColors

setStroke

setStroke

setStroke

setStroke

getStrokeWidth

getStrokeColor

getStrokeColors

setStrokeCap

getStrokeCap

setStrokeCapEnabled

isStrokeCapEnabled

setStrokeStops

getStrokeStops

setStrokeShaderType

getStrokeShaderType

setStrokeOrientation

getStrokeOrientation

setStrokeShaderCenter

getStrokeShaderCenter

setStrokeShaderRadius

getStrokeShaderRadius