VectorDrawable Classe

Définition

[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

Héritage

Object

JavaObject

Object

Drawable

VectorDrawable

Attributs

RegisterAttribute

Remarques

Cela vous permet de créer un dessinable basé sur un graphique vectoriel XML.

< >strong Remarque :</strong> To optimize for the re-drawing performance, one bitmap cache is created for each VectorDrawable. Par conséquent, faire référence au même VectorDrawable signifie partager le même cache bitmap. Si ces références ne sont pas d’accord sur la même taille, la bitmap est recréée et redessinée chaque fois que la taille est modifiée. En d’autres termes, si un VectorDrawable est utilisé pour différentes tailles, il est plus efficace de créer plusieurs VectorDrawables, un pour chaque taille.

VectorDrawable peut être défini dans un fichier XML avec l’élément <vector> .

Le vecteur pouvant être dessiné comporte les éléments suivants :

<dt><vector></dt><dl dd><>Utilisé pour définir un vecteur dl <dl><dt/dt>android:name< dd><>définit le nom de ce vecteur dessinable.</dd><dt/dt>android:width<>< dd>utilisé pour définir la largeur intrinsèque du dessinable. Cela prend en charge toutes les unités de dimension, normalement spécifiées avec dp.</dd><dt/dt>android:height<>< dd>utilisé pour définir la hauteur intrinsèque du dessinable. Cela prend en charge toutes les unités de dimension, normalement spécifiées avec dp.</dd><dt/dt>android:viewportWidth<>< dd>utilisé pour définir la largeur de l’espace de la fenêtre d’affichage. La fenêtre d’affichage est essentiellement le canevas virtuel sur lequel les chemins sont dessinés.</dd><dt/dt>android:viewportHeight<>< dd>utilisé pour définir la hauteur de l’espace de la fenêtre d’affichage. La fenêtre d’affichage est essentiellement le canevas virtuel sur lequel les chemins sont dessinés.</dd><dt/dt>android:tintdd<>< dd>la couleur à appliquer au dessinable sous forme de teinte. Par défaut, aucune teinte n’est appliquée.</dd><dt/dt>android:tintMode<>< dd dd>Le mode de fusion Porter-Duff pour la couleur de teinte. La valeur par défaut est src_in.</dd><dt/dt>android:autoMirrored<>< dd>indique si le dessinable doit être mis en miroir lorsque sa direction de disposition est RTL (droite à gauche). La valeur par défaut est false.</dd><dt/dt dd>android:alphadd<>< dd>l’opacité de ce dessinable. La valeur par défaut est 1.0.</dd></dl></dd></dl>

<dl><dt/dt><group><>< dd>Définit un groupe de chemins ou de sous-groupes, ainsi que des informations de transformation. Les transformations sont définies dans les mêmes coordonnées que la fenêtre d’affichage. Et les transformations sont appliquées dans l’ordre de mise à l’échelle, faire pivoter puis traduire. <dl><dt/dt>android:name<>< dd>Définit le nom du groupe.</dd><dt/dt>android:rotation<>< dd dd>Degrés de rotation du groupe. La valeur par défaut est 0.</dd><dt/dt>android:pivotX<>< dd>, coordonnée X du pivot pour l’échelle et la rotation du groupe. Cela est défini dans l’espace de la fenêtre d’affichage. La valeur par défaut est 0.</dd><dt/dt>android:pivotY<>< dd>, coordonnée Y du pivot pour l’échelle et la rotation du groupe. Cela est défini dans l’espace de la fenêtre d’affichage. La valeur par défaut est 0.</dd dt/dt dt><>android:scaleX< dd>la quantité d’échelle sur la coordonnée X.<> La valeur par défaut est 1.</dd dt/dt dt><>android:scaleY< dd>la quantité d’échelle sur la coordonnée Y.<> La valeur par défaut est 1.</dd dt/dt dt><>android:translateX< dd>La quantité de traduction sur la coordonnée X.<> Cela est défini dans l’espace de la fenêtre d’affichage. La valeur par défaut est 0.</dd dt/dt dd><>android:translateY< dd>la quantité de traduction sur la coordonnée Y.<> Cela est défini dans l’espace de la fenêtre d’affichage. La valeur par défaut est 0.</dd></dl></dd></dl>

<dl><dt/dt><path><>< dd>définit les chemins à dessiner. <dl><dt/dt>android:name<>< dd>Définit le nom du chemin d’accès.</dd><dt/dt>android:pathData<>< dd>définit les données de chemin d’accès au même format que l’attribut « d » dans les données de chemin d’accès du SVG. Cela est défini dans l’espace de la fenêtre d’affichage.</dd><dt/dt>android:fillColor<>< dd>Spécifie la couleur utilisée pour remplir le chemin d’accès. Peut être une couleur ou, pour le KIT SDK 24+, une liste d’états de couleur ou une couleur de dégradé (Voir android.R.styleable#GradientColor et android.R.styleable#GradientColorItem). Si cette propriété est animée, toute valeur définie par l’animation remplace la valeur d’origine. Aucun remplissage de chemin d’accès n’est dessiné si cette propriété n’est pas spécifiée.</dd><dt/dt>android:strokeColor<>< dd>spécifie la couleur utilisée pour dessiner le contour du chemin d’accès. Peut être une couleur ou, pour le KIT SDK 24+, une liste d’états de couleur ou une couleur de dégradé (Voir android.R.styleable#GradientColor et android.R.styleable#GradientColorItem). Si cette propriété est animée, toute valeur définie par l’animation remplace la valeur d’origine. Aucun plan de chemin d’accès n’est dessiné si cette propriété n’est pas spécifiée.</dd><dt/dt>android:strokeWidth<>< dd dd>La largeur d’un trait de chemin. La valeur par défaut est 0.</dd dt/dt dd><>android:strokeAlpha<> l’opacité d’un trait de chemin.<> La valeur par défaut est 1.</dd dt/dt dt><>android:fillAlpha< dd>L’opacité pour remplir le chemin d’accès.<> La valeur par défaut est 1.</dd><dt/dt>android:trimPathStartdd<>< dd>La fraction du chemin à découper du début, dans la plage comprise entre 0 et 1. La valeur par défaut est 0.</dd dt/dt dt><>android:trimPathEnd< dd>La fraction du chemin à découper de la fin, dans la plage comprise entre 0 et 1.<> La valeur par défaut est 1.</dd><dt/dt>android:trimPathOffsetdd<><> shift trim region (permet à la région montrée d’inclure le début et la fin), dans la plage comprise entre 0 et 1. La valeur par défaut est 0.</dd><dt/dt>android:strokeLineCap<>< dd>définit le trait de ligne d’un chemin tracé : butt, arrondi, carré. La valeur par défaut est butte.</dd><dt/dt>android:strokeLineJoin<>< dd>définit la ligneJoin d’un chemin tracé : miter,arrondi,biseau. La valeur par défaut est miter.</dd><dt/dt>android:strokeMiterLimit<>< dd>définit la limite de mitr pour un chemin tracé. La valeur par défaut est 4.</dd><dt/dt>android:fillType<>< dd>for SDK 24+, définit le fillType pour un chemin d’accès. Les types peuvent être « evenOdd » ou « nonZero ». Ils se comportent de la même façon que les propriétés de « règle de remplissage » de SVG. La valeur par défaut est différente de zéro. Pour plus d’informations, consultez FillRuleProperty</dd></dl></dd>

</dl>

<dl><dt/dt><clip-path>dd<><> définit le chemin d’accès à l’élément clip actuel. Notez que le chemin d’accès du clip s’applique uniquement au groupe actuel et à ses enfants. <dl><dt/dt>android:name<>< dd>Définit le nom du chemin d’accès du clip.</dd dd><>Animatable : Non.</dd><dt/dt>android:pathDatadd<><> définit le chemin d’accès du clip au même format que « d » dans les données de chemin d’accès svg.</dd dd><>Animatable : Oui.</dd/dl/dl/dl><><>< li>Voici un simple VectorDrawable dans ce fichier 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>Gradient support</h4> Nous prenons en charge 3 types de dégradés : android.graphics.LinearGradient, , android.graphics.RadialGradientou android.graphics.SweepGradient.

Et nous prenons en charge tous les 3 types de modes android.graphics.Shader.TileModede vignette : CLAMP, REPEAT, MIRROR.

Tous les attributs sont répertoriés dans android.R.styleable#GradientColor. Notez que différents attributs sont pertinents pour différents types de dégradés. <table border="2 » align="center » cellpadding="5">thead<>tr<>th<LinearGradient/th><>RadialGradient</th th><>SweepGradient<>/th<>/tr/thead<>tr<><> td<startColor >/td td<><startColor/><>td td startColor<>/td<> tr<><>td td<centerColor/td centerColor>/td<><>centerColor</><>td td centerColor</td></tr tr><><td>endColor</td><>td endColor/<><td td endColor></td/><tr tr><><>< td td type/><><td td type/td><>td type</td td td/td><><>< tr td>tileMode<><>/td<><td td>tileMode</td></tr tr><><td>startX</td td><>centerX</td><>td centerX</td></tr><><>td startY</td><>td centerY/td<><td centerY/td td centerY></td></tr tr><><td>endX</td><td>gradientRadius</td><td></td></tr tr><><td>endY</td></><td/td><></td/td></tr></table>

Notez également que si un élément android.R.styleable#GradientColorItem de couleur est défini, startColor, centerColor et endColor sont ignorés.

Pour plus d’informations, android.R.styleable#GradientColor voir et android.R.styleable#GradientColorItem.

Voici un exemple simple qui définit un dégradé linéaire.

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

Voici un exemple simple qui définit un dégradé radial à l’aide d’éléments de couleur.

<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 documentation pour android.graphics.drawable.VectorDrawable.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.