VectorDrawable Klasse

Definition

[Android.Runtime.Register("android/graphics/drawable/VectorDrawable", DoNotGenerateAcw=true)]
public class VectorDrawable : Android.Graphics.Drawables.Drawable

[<Android.Runtime.Register("android/graphics/drawable/VectorDrawable", DoNotGenerateAcw=true)>]
type VectorDrawable = class
    inherit Drawable

Vererbung

Object

JavaObject

Object

Drawable

VectorDrawable

Attribute

RegisterAttribute

Hinweise

Auf diese Weise können Sie eine zeichnungsfähige Grafik basierend auf einer XML-Vektorgrafik erstellen.

<strong>Note:</strong> To optimize for the re-drawing performance, one bitmap cache is created for each VectorDrawable. Das Verweisen auf denselben VectorDrawable bedeutet daher, denselben Bitmapcache gemeinsam zu nutzen. Wenn sich diese Verweise nicht auf dieselbe Größe einigen, wird die Bitmap neu erstellt und jedes Mal neu gezeichnet, wenn die Größe geändert wird. Anders ausgedrückt: Wenn ein VectorDrawable für unterschiedliche Größen verwendet wird, ist es effizienter, mehrere VectorDrawables zu erstellen, eine für jede Größe.

VectorDrawable kann in einer XML-Datei mit dem <vector> Element definiert werden.

Der Vektor, der gezeichnet werden kann, weist die folgenden Elemente auf:

<dt><vector></dt><dl><dd>Wird verwendet, um einen Vektor drawable <dl><dt>android:name</dt><dd>Definiert den Namen dieses Vektors drawable.</dd><dt>android:width</dt><dd>Wird verwendet, um die systeminterne Breite der zeichnungsfähigen Zu definieren. Dies unterstützt alle Bemaßungseinheiten, die normalerweise mit dp angegeben sind.</dd><dt>android:height</dt><dd>Wird verwendet, um die systeminterne Höhe der Zeichnung zu definieren. Dies unterstützt alle Bemaßungseinheiten, die normalerweise mit dp angegeben sind.</dd><dt>android:viewportWidth</dt><dd>Wird verwendet, um die Breite des Viewportbereichs zu definieren. Viewport ist im Grunde der virtuelle Zeichenbereich, auf dem die Pfade gezeichnet werden.</dd><dt>android:viewportHeight</dt><dd>Wird verwendet, um die Höhe des Viewportbereichs zu definieren. Viewport ist im Grunde der virtuelle Zeichenbereich, auf dem die Pfade gezeichnet werden.</dd><dt>android:tint</dt><dd>Die Farbe, die als Farbton auf die Zeichnung angewendet werden soll. Standardmäßig wird kein Farbton angewendet.</dd><dt>android:tintMode</dt><dd>Der Porter-Duff Mischmodus für die Farbtonfarbe. Der Standardwert ist src_in.</dd><dt>android:autoMirrored</dt><dd>Gibt an, ob die Zeichnungsrichtung gespiegelt werden muss, wenn die Layoutrichtung RTL ist (von rechts nach links). Der Standardwert ist "false".</dd><dt>android:alpha</dt><dd>Die Deckkraft dieser zeichnungsfähigen. Der Standardwert ist 1.0.</dd></dl></dd></dl>

<dl><dt><group></dt><dd>Definiert eine Gruppe von Pfaden oder Untergruppen sowie Transformationsinformationen. Die Transformationen werden in denselben Koordinaten wie der Viewport definiert. Und die Transformationen werden in der Reihenfolge der Skalierung angewendet, drehen und dann übersetzen. <dl><dt>android:name</dt><dd>Definiert den Namen der Gruppe.</dd><dt>android:rotation</dt><dd>Die Drehungsgrade der Gruppe. Der Standardwert ist 0.</dd><dt>android:pivotX</dt><dd>Die X-Koordinate des Pivots für die Skalierung und Drehung der Gruppe. Dies wird im Viewportbereich definiert. Der Standardwert ist 0.</dd><dt>android:pivotY</dt><dd>Die Y-Koordinate des Pivots für die Skalierung und Drehung der Gruppe. Dies wird im Viewportbereich definiert. Der Standardwert ist 0.</dd><dt>android:scaleX</dt><dd>Die Skalierungsmenge auf der X-Koordinate. Der Standardwert ist 1.</dd><dt>android:scaleY</dt><dd>Die Skalierungsmenge auf der Y-Koordinate. Der Standardwert ist 1.</dd><dt>android:translateX</dt><dd>Die Übersetzungsmenge an der X-Koordinate. Dies wird im Viewportbereich definiert. Der Standardwert ist 0.</dd><dt>android:translateY</dt><dd>Die Übersetzungsmenge der Y-Koordinate. Dies wird im Viewportbereich definiert. Der Standardwert ist 0.</dd></dl></dd></dl>

<dl><dt><path></dt><dd>Definiert zu zeichnende Pfade. <dl><dt>android:name</dt><dd>Definiert den Namen des Pfads.</dd><dt>android:pathData</dt><dd>Definiert Pfaddaten mit demselben Format wie das Attribut "d" in den Pfaddaten des SVG. Dies wird im Viewportbereich definiert.</dd><dt>android:fillColor</dt><dd>Gibt die Farbe an, die zum Ausfüllen des Pfads verwendet wird. Kann eine Farbe oder, für SDK 24+, eine Farbzustandsliste oder eine Farbverlaufsfarbe (Siehe android.R.styleable#GradientColor und android.R.styleable#GradientColorItem). Wenn diese Eigenschaft animiert wird, überschreibt jeder von der Animation festgelegte Wert den ursprünglichen Wert. Wenn diese Eigenschaft nicht angegeben ist, wird keine Pfadfüllung gezeichnet.</dd><dt>android:strokeColor</dt><dd>Specifies the color used to draw the path outline. Kann eine Farbe oder, für SDK 24+, eine Farbzustandsliste oder eine Farbverlaufsfarbe (Siehe android.R.styleable#GradientColor und android.R.styleable#GradientColorItem). Wenn diese Eigenschaft animiert wird, überschreibt jeder von der Animation festgelegte Wert den ursprünglichen Wert. Es wird keine Pfadgliederung gezeichnet, wenn diese Eigenschaft nicht angegeben ist.</dd><dt>android:strokeWidth</dt><dd>Die Breite eines Pfadstrichs. Der Standardwert ist 0.</dd><dt>android:strokeAlpha</dt><dd>Die Deckkraft eines Pfadstrichs. Der Standardwert ist 1.</dd><dt>android:fillAlpha</dt><dd>Die Deckkraft, mit der der Pfad gefüllt werden soll. Der Standardwert ist 1.</dd><dt>android:trimPathStart</dt><dd>Der Bruchteil des Pfads, der vom Anfang entfernt werden soll, im Bereich von 0 bis 1. Der Standardwert ist 0.</dd><dt>android:trimPathEnd</dt><dd>Der Bruchteil des Pfads, der vom Ende gekürzt werden soll, im Bereich von 0 bis 1. Der Standardwert ist 1.</dd><dt>android:trimPathOffset</dt><dd>Shift Trim Region (ermöglicht gezeigte Region, den Anfang und Das Ende einzuschließen), im Bereich von 0 bis 1. Der Standardwert ist 0.</dd><dt>android:strokeLineCap</dt><dd>Legt die Linienlinie für einen Strichpfad fest: Butt, round, square. Der Standardwert ist "Butt".</dd><dt>android:strokeLineJoin</dt><dd>Legt den lineJoin für einen Strichpfad fest: Miter, round,bevel. Der Standardwert ist Miter.</dd><dt>android:strokeMiterLimit</dt><dd>Legt den Miter-Grenzwert für einen Strichpfad fest. Der Standardwert ist 4.</dd><dt>android:fillType</dt><dd>For SDK 24+, legt den fillType für einen Pfad fest. Die Typen können entweder "evenOdd" oder "nonZero" sein. Sie verhalten sich genauso wie die "Fill-rule"-Eigenschaften von SVG. Der Standardwert ist "nonZero". Weitere Details finden Sie unter FillRuleProperty</dd></dl></dd>

</dl>

<dl><dt><clip-path></dt><dd>Defines path to be the current clip. Beachten Sie, dass der Clippfad nur für die aktuelle Gruppe und die untergeordneten Elemente gelten. <dl><dt>android:name</dt><dd>Definiert den Namen des Clippfads.</dd><dd>Animatable : Nein.</dd><dt>android:pathData</dt><dd>Defines clip path using the same format as "d" attribute in the SVG's path data.</dd><dd>Animatable : Ja.</dd></dl/dd><></dl><li>Hier ist ein einfacher VectorDrawable in dieser vectordrawable.xml Datei.

<vector xmlns:android="http://schemas.android.com/apk/res/android"
                android:height="64dp"
                android:width="64dp"
                android:viewportHeight="600"
                android:viewportWidth="600" >
                <group
                    android:name="rotationGroup"
                    android:pivotX="300.0"
                    android:pivotY="300.0"
                    android:rotation="45.0" >
                    <path
                        android:name="v"
                        android:fillColor="#000000"
                        android:pathData="M300,70 l 0,-70 70,70 0,0 -70,70z" />
                </group>
            </vector>

</li><h4>Farbverlaufsunterstützung</h4> Wir unterstützen 3 Arten von Farbverläufen: android.graphics.LinearGradient, , android.graphics.RadialGradientoder android.graphics.SweepGradient.

Und wir unterstützen alle drei Arten von Kachelmodi android.graphics.Shader.TileMode: CLAMP, REPEAT, MIRROR.

Alle Attribute werden in android.R.styleable#GradientColoraufgeführt. Beachten Sie, dass unterschiedliche Attribute für unterschiedliche Farbverlaufstypen relevant sind. <table border="2" align="center" cellpadding="5">thead<>tr<>th<LinearGradient/th><>RadialGradient<>/th<>th<SweepGradient/th SweepGradient>/th<>/tr<>/thead<>tr<>td<startColor >/td td<><startColor>/td<>td startColor/td td<startColor>/td<>/tr<><>td<centerColor>/td<>td<>centerColor</td><td>centerColor</td></tr><><td>endColor</td td><>endColor</td td><>endColor</td></tr><tr><td>type</td><>type</td><>td type</td></tr><tr><td>tileMode</td td><td>tileMode</td t><>tileMode</td></tr><><td>startX</td><td>centerX</td td><>centerX</td/tr><td><><> startY</td td><>centerY</td><td>centerY</td><><>< td>endX</td><td gradientRadius/td td gradientRadius>/td<><td></td></tr><><td>endY</td td></td>< td td></td/td/td><></tr/table><>

Beachten Sie außerdem, dass startColor, centerColor und endColor ignoriert werden, wenn ein Farbelement android.R.styleable#GradientColorItem definiert ist.

Weitere Details finden Sie in android.R.styleable#GradientColor und android.R.styleable#GradientColorItem.

Hier ist ein einfaches Beispiel, das einen linearen Farbverlauf definiert.

<gradient xmlns:android="http://schemas.android.com/apk/res/android"
                android:startColor="?android:attr/colorPrimary"
                android:endColor="?android:attr/colorControlActivated"
                android:centerColor="#f00"
                android:startX="0"
                android:startY="0"
                android:endX="100"
                android:endY="100"
                android:type="linear">
            </gradient>

Und hier ist ein einfaches Beispiel, das einen radialen Farbverlauf mithilfe von Farbelementen definiert.

<gradient xmlns:android="http://schemas.android.com/apk/res/android"
                android:centerX="300"
                android:centerY="300"
                android:gradientRadius="100"
                android:type="radial">
                <item android:offset="0.1" android:color="#0ff"/>
                <item android:offset="0.4" android:color="#fff"/>
                <item android:offset="0.9" android:color="#ff0"/>
            </gradient>

Java Dokumentation für android.graphics.drawable.VectorDrawable.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.