VectorDrawable Classe

Definição

[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

Herança

Object

JavaObject

Object

Drawable

VectorDrawable

Atributos

RegisterAttribute

Comentários

Isso permite que você crie um gráfico de vetor XML desenhável.

<Observação forte>:</strong> Para otimizar o desempenho de redimensão, um cache de bitmap é criado para cada VectorDrawable. Portanto, fazer referência ao mesmo VectorDrawable significa compartilhar o mesmo cache de bitmap. Se essas referências não concordarem com o mesmo tamanho, o bitmap será recriado e redesenhado sempre que o tamanho for alterado. Em outras palavras, se um VectorDrawable for usado para tamanhos diferentes, será mais eficiente criar vários VectorDrawables, um para cada tamanho.

VectorDrawable pode ser definido em um arquivo XML com o <vector> elemento.

O vetor desenhável tem os seguintes elementos:

<dt><vector></dt><dl><dd>Usado para definir um vetor desenhável <dl><dt>android:name</dt><dd>Define o nome deste vetor desenhável.</dd><dt>android:width</dt><dd>Usado para definir a largura intrínseca do desenhável. Isso dá suporte a todas as unidades de dimensão, normalmente especificadas com dp.</dd><dt>android:height</dt><dd>Usado para definir a altura intrínseca do desenhável. Isso dá suporte a todas as unidades de dimensão, normalmente especificadas com dp.</dd><dt>android:viewportWidth</dt><dd>Usado para definir a largura do espaço do visor. Viewport é basicamente a tela virtual na qual os caminhos são desenhados.</dd><dt>android:viewportHeight</dt><dd>Usado para definir a altura do espaço do visor. Viewport é basicamente a tela virtual na qual os caminhos são desenhados.</dd><dt>android:tint</dt><dd>A cor a ser aplicada ao desenhável como uma tonalidade. Por padrão, nenhuma tonalidade é aplicada.</dd><dt>android:tintMode</dt><dd>O modo de mesclagem Porter-Duff para a cor da tonalidade. O padrão é src_in.</dd><dt>android:autoMirrored</dt><dd>Indica se o desenhável precisa ser espelhado quando sua direção de layout é RTL (da direita para a esquerda). O padrão é false.</dd><dt>android:alpha</dt><dd>A opacidade deste desenhável. O padrão é 1.0.</dd></dl></dd></dl>

<dl><dt><group></dt><dd>Define um grupo de caminhos ou subgrupos, além de informações de transformação. As transformações são definidas nas mesmas coordenadas que o visor. E as transformações são aplicadas na ordem de escala, giram e convertem. <dl><dt>android:name</dt><dd>Define o nome do grupo.</dd><dt>android:rotation</dt><dd>Os graus de rotação do grupo. O padrão é 0.</dd><dt>android:pivotX</dt><dd>A coordenada X do pivô para a escala e rotação do grupo. Isso é definido no espaço do visor. O padrão é 0.</dd><dt>android:pivotY</dt><dd>A coordenada Y do pivô para a escala e rotação do grupo. Isso é definido no espaço do visor. O padrão é 0.</dd><dt>android:scaleX</dt><dd>A quantidade de escala na Coordenada X. O padrão é 1.</dd><dt>android:scaleY</dt><dd>A quantidade de escala na coordenada Y. O padrão é 1.</dd><dt>android:translateX</dt><dd>A quantidade de tradução na coordenada X. Isso é definido no espaço do visor. O padrão é 0.</dd><dt>android:translateY</dt><dd>A quantidade de tradução na coordenada Y. Isso é definido no espaço do visor. O padrão é 0.</dd></dl></dd></dl>

<dl><dt><path></dt><dd>Define caminhos a serem desenhados. <dl><dt>android:name</dt><dd>Define o nome do caminho.</dd><dt>android:pathData</dt><dd>Define dados de caminho usando exatamente o mesmo formato que o atributo "d" nos dados de caminho do SVG. Isso é definido no espaço do visor.</dd><dt>android:fillColor</dt><dd>Especifica a cor usada para preencher o caminho. Pode ser uma cor ou, para o SDK 24+, uma lista de estado de cor ou uma cor de gradiente (Ver android.R.styleable#GradientColor e android.R.styleable#GradientColorItem). Se essa propriedade for animada, qualquer valor definido pela animação substituirá o valor original. Nenhum preenchimento de caminho será desenhado se essa propriedade não for especificada.</dd><dt>android:strokeColor</dt><dd>Especifica a cor usada para desenhar a estrutura de tópicos do caminho. Pode ser uma cor ou, para o SDK 24+, uma lista de estado de cor ou uma cor de gradiente (Ver android.R.styleable#GradientColor e android.R.styleable#GradientColorItem). Se essa propriedade for animada, qualquer valor definido pela animação substituirá o valor original. Nenhuma estrutura de tópicos de caminho será desenhada se essa propriedade não for especificada.</dd><dt>android:strokeWidth</dt><dd>A largura de um traço de caminho. O padrão é 0.</dd><dt>android:strokeAlpha</dt><dd>A opacidade de um traço de caminho. O padrão é 1.</dd><dt>android:fillAlpha</dt><dd>A opacidade com a qual preencher o caminho. O padrão é 1.</dd><dt>android:trimPathStart</dt><dd A fração do caminho a ser aparado>desde o início, no intervalo de 0 a 1. O padrão é 0.</dd><dt>android:trimPathEnd</dt><dd A fração do caminho a ser aparado>do final, no intervalo de 0 a 1. O padrão é 1.</dd><dt>android:trimPathOffset</dt><dd>Shift trim region (permite que a região mostrada inclua o início e o fim), no intervalo de 0 a 1. O padrão é 0.</dd><dt>android:strokeLineCap</dt><dd>Define a calota de linha para um caminho traçado: butt, round, square. O padrão é a bunda.</dd><dt>android:strokeLineJoin</dt><dd>Define o lineJoin para um caminho traçado: miter, round, bisel. O padrão é miter.</dd><dt>android:strokeMiterLimit</dt><dd>Define o limite do Miter para um caminho traçado. O padrão é 4.</dd><dt>android:fillType</dt><dd>For SDK 24+, define o fillType para um caminho. Os tipos podem ser "evenOdd" ou "nonZero". Eles se comportam da mesma forma que as propriedades de "regra de preenchimento" do SVG. O padrão não éZero. Para obter mais detalhes, consulte FillRuleProperty</dd></dl></dd>

</dl>

<dl><dt><clip-path></dt><dd>Define o caminho para ser o clipe atual. Observe que o caminho do clipe só se aplica ao grupo atual e seus filhos. <dl><dt>android:name</dt><dd>Define o nome do caminho do clipe.</dd><dd>Animatable: Não.</dd><dt>android:pathData</dt><dd>Defines clip path usando o mesmo formato que o atributo "d" nos dados de caminho do SVG.</dd><dd>Animatable: Sim.</dd></dl></dd></dl><li>Aqui está um VectorDrawable simples neste arquivo 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> Oferecemos suporte a 3 tipos de gradientes: android.graphics.LinearGradient, android.graphics.RadialGradientou android.graphics.SweepGradient.

E damos suporte a todos os três tipos de modos android.graphics.Shader.TileModede bloco: CLAMP, REPEAT, MIRROR.

Todos os atributos estão listados em android.R.styleable#GradientColor. Observe que atributos diferentes são relevantes para diferentes tipos de gradiente. <table border="2" align="center" cellpadding="5">thead<>tr<>th<LinearGradient>/th<><RadialGradient>/th<><SweepGradient/th SweepGradient>/th<>/tr<>/thead<>tr<>td<startColor >/td td<><startColor>/td td<>startColor</td><>/tr<>tr<>td<centerColor>/td td<><>centerColor</td><td>centerColor</td></tr><tr><td>endColor</td td><>endColor</td td><>endColor</td/td></tr><tr><td>type</td><td>type</td td><>type</td></tr><tr><td>tileMode</td td><>tileMode</td td><>tileMode</td></tr><td><>startX</td td><>centerX</td td><>centerX</td/td></tr><tr><td>startY</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>

Observe também que, se qualquer item android.R.styleable#GradientColorItem de cor for definido, startColor, centerColor e endColor serão ignorados.

Veja mais detalhes em android.R.styleable#GradientColor e android.R.styleable#GradientColorItem.

Aqui está um exemplo simples que define um gradiente linear.

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

E aqui está um exemplo simples que define um gradiente radial usando itens de cor.

<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 documentação para android.graphics.drawable.VectorDrawable.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.