VectorDrawable Clase

Definición

[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

Herencia

Object

JavaObject

Object

Drawable

VectorDrawable

Atributos

RegisterAttribute

Comentarios

Esto le permite crear un gráfico dibujable basado en un gráfico vectorial XML.

<nota fuerte>:</strong> Para optimizar el rendimiento de nuevo dibujo, se crea una caché de mapa de bits para cada VectorDrawable. Por lo tanto, hacer referencia al mismo VectorDrawable significa compartir la misma caché de mapa de bits. Si estas referencias no están de acuerdo con el mismo tamaño, se volverá a crear el mapa de bits y se volverá a dibujar cada vez que se cambie el tamaño. En otras palabras, si se usa un VectorDrawable para diferentes tamaños, es más eficaz crear varios VectorDrawables, uno para cada tamaño.

VectorDrawable se puede definir en un archivo XML con el <vector> elemento .

El vector dibujable tiene los siguientes elementos:

<dt><vector></dt><dl dd><>Se usa para definir un vector drawable <dl><dt>android:name</dt><dd>Define el nombre de este vector dibujable.</dd><dt>android:width</dt><dd>Se usa para definir el ancho intrínseco del dibujable. Esto admite todas las unidades de dimensión, normalmente especificadas con dp.</dd><dt>android:height</dt><dd>Se usa para definir el alto intrínseco del dibujable. Esto admite todas las unidades de dimensión, normalmente especificadas con dp.</dd><dt>android:viewportWidth</dt><dd>Se usa para definir el ancho del espacio de ventanilla. Viewport es básicamente el lienzo virtual en el que se dibujan las rutas de acceso.</dd><dt>android:viewportHeight</dt><dd>Se usa para definir el alto del espacio de ventanilla. Viewport es básicamente el lienzo virtual en el que se dibujan las rutas de acceso.</dd><dt>android:tint</dt><dd>El color que se va a aplicar al dibujable como un tono. De forma predeterminada, no se aplica ningún tono.</dd><dt>android:tintMode</dt><dd>El modo de mezcla Porter-Duff para el color de tono. El valor predeterminado es src_in.</dd><dt>android:autoMirrored</dt><dd>Indica si el dibujable debe reflejarse cuando su dirección de diseño es RTL (de derecha a izquierda). El valor predeterminado es false.</dd><dt>android:alpha</dt><dd>La opacidad de este dibujable. El valor predeterminado es 1.0.</dd></dl></dd></dl>

<dl><dt><group></dt><dd>Define un grupo de rutas de acceso o subgrupos, además de información de transformación. Las transformaciones se definen en las mismas coordenadas que la ventanilla. Y las transformaciones se aplican en el orden de escala, girar y luego traducir. <dl><dt>android:name</dt><dd>Define el nombre del grupo.</dd><dt>android:rotation</dt><dd>Los grados de rotación del grupo. El valor predeterminado es 0.</dd><dt>android:pivotX</dt><dd>Coordenada X del pivote para la escala y rotación del grupo. Esto se define en el espacio de ventanilla. El valor predeterminado es 0.</dd><dt>android:pivotY</dt><dd>Coordenada Y del pivote para la escala y rotación del grupo. Esto se define en el espacio de ventanilla. El valor predeterminado es 0.</dd><dt>android:scaleX</dt><dd>La cantidad de escala en la coordenada X. El valor predeterminado es 1.</dd><dt>android:scaleY</dt><dd>La cantidad de escala en la coordenada Y. El valor predeterminado es 1.</dd><dt>android:translateX</dt><dd>La cantidad de traducción en la coordenada X. Esto se define en el espacio de ventanilla. El valor predeterminado es 0.</dd><dt>android:translateY</dt><dd>La cantidad de traducción en la coordenada Y. Esto se define en el espacio de ventanilla. El valor predeterminado es 0.</dd></dl></dd></dl>

<dl><dt><path></dt><dd>Define las rutas de acceso que se van a dibujar. <dl><dt>android:name</dt><dd>Define el nombre de la ruta de acceso.</dd><dt>android:pathData</dt><dd>Define los datos de ruta de acceso con exactamente el mismo formato que el atributo "d" en los datos de ruta de acceso de SVG. Esto se define en el espacio de ventanilla.</dd><dt>android:fillColor</dt><dd>Especifica el color usado para rellenar la ruta de acceso. Puede ser un color o, para SDK 24+, una lista de estados de color o un color degradado (vea android.R.styleable#GradientColor y android.R.styleable#GradientColorItem). Si esta propiedad está animada, cualquier valor establecido por la animación invalidará el valor original. No se dibuja ningún relleno de ruta de acceso si no se especifica esta propiedad.</dd><dt>android:strokeColor</dt><dd>Especifica el color usado para dibujar el contorno de la ruta de acceso. Puede ser un color o, para SDK 24+, una lista de estados de color o un color degradado (vea android.R.styleable#GradientColor y android.R.styleable#GradientColorItem). Si esta propiedad está animada, cualquier valor establecido por la animación invalidará el valor original. No se dibuja ningún esquema de ruta de acceso si no se especifica esta propiedad.</dd><dt>android:strokeWidth</dt><dd>Ancho de un trazo de ruta de acceso. El valor predeterminado es 0.</dd><dt>android:strokeAlpha</dt><dd>La opacidad de un trazo de ruta de acceso. El valor predeterminado es 1.</dd><dt>android:fillAlpha</dt><dd>Opacidad con la que rellenar la ruta de acceso. El valor predeterminado es 1.</dd><dt>android:trimPathStart</dt><dd>La fracción de la ruta de acceso que se va a recortar desde el principio, en el intervalo comprendido entre 0 y 1. El valor predeterminado es 0.</dd><dt>android:trimPathEnd</dt><dd>La fracción de la ruta de acceso que se va a recortar desde el final, en el intervalo comprendido entre 0 y 1. El valor predeterminado es 1.</dd><dt>android:trimPathOffset</dt><dd>Región de recorte mayús (permite que la región mostrada incluya el inicio y el final), en el intervalo comprendido entre 0 y 1. El valor predeterminado es 0.</dd><dt>android:strokeLineCap</dt><dd>Establece el linecap para una ruta de acceso trazos: butt, round, square. El valor predeterminado es butt.</dd><dt>android:strokeLineJoin</dt><dd>Establece la líneaJoin para una ruta de acceso trazo: miter,round,bevel. El valor predeterminado es miter.</dd><dt>android:strokeMiterLimit</dt><dd>Establece el límite miter para una ruta de acceso trazos. El valor predeterminado es 4.</dd><dt>android:fillType</dt><dd>Para SDK 24+, establece fillType para una ruta de acceso. Los tipos pueden ser "evenOdd" o "nonZero". Se comportan igual que las propiedades "fill-rule" de SVG. El valor predeterminado es distinto de Cero. Para obtener más información, consulte FillRuleProperty</dd></dl></dd>

</Dl>

<dl><dt><clip-path></dt><dd>Define la ruta de acceso para que sea el clip actual. Tenga en cuenta que la ruta de acceso del clip solo se aplica al grupo actual y a sus elementos secundarios. <dl><dt>android:name</dt><dd>Define el nombre de la ruta de acceso del clip.</dd dd><>Animatable : No.</dd><dt>android:pathData</dt><dd>Define la ruta de acceso del clip con el mismo formato que el atributo "d" en los datos de ruta de acceso de SVG.</dd dd><>Animatable : Sí.</dd></dl></dd></dl><li>Este es un vectordrawable simple en este archivo vectordrawable.xml.

<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>Compatibilidad con degradado</h4> Se admiten 3 tipos de degradados: android.graphics.LinearGradient, android.graphics.RadialGradiento android.graphics.SweepGradient.

Y se admiten todos los tres tipos de modos android.graphics.Shader.TileModede mosaico: CLAMP, REPEAT, MIRROR.

Todos los atributos se enumeran en android.R.styleable#GradientColor. Tenga en cuenta que los distintos atributos son relevantes para diferentes tipos de degradado. <table border="2" align="center" cellpadding="5">thead<>tr<>th<LinearGradient>/th<><RadialGradient/th><th>SweepGradient<>/th<>/tr/thead<>tr<> td<><startColor >/td<>td td<startColor>/td td td<>startColor</td><> tr td<><><centerColor>/td td<>td<>centerColor</td td><>centerColor</td></tr tr><><td>endColor</td><td td>< endColor/td td><>endColor</td></tr tr><td><td>type<>/td<>td<td><td>type</td td>< tr tr><><td>tileMode</td td><>< td td><>tileMode</td></tr tr><td><>startX</td td><>centerX</td td><>centerX</td></tr tr td><><>startY</td td><>centerY</td td><>centerY</td>< tr tr td><><>endX</td td td><gradientRadius>/td<><td></td></tr tr><td><>endY</td td><></td><td/td></td></tr></table>

Tenga en cuenta también que si se define algún elemento android.R.styleable#GradientColorItem de color, se omitirá startColor, centerColor y endColor.

Vea más detalles en android.R.styleable#GradientColor y android.R.styleable#GradientColorItem.

Este es un ejemplo sencillo que define un degradado lineal.

<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>

Y este es un ejemplo sencillo que define un degradado radial mediante elementos de color.

<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 documentación para android.graphics.drawable.VectorDrawable.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.