VectorDrawable クラス

定義

[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

継承

Object

JavaObject

Object

Drawable

VectorDrawable

属性

RegisterAttribute

注釈

これにより、XML ベクター グラフィックに基づいて描画可能な図形を作成できます。

<strong>Note:</strong> 再描画のパフォーマンスを最適化するために、VectorDrawable ごとに 1 つのビットマップ キャッシュが作成されます。 したがって、同じ VectorDrawable を参照することは、同じビットマップ キャッシュを共有することを意味します。 これらの参照が同じサイズで一致しない場合、ビットマップは再作成され、サイズが変更されるたびに再描画されます。 つまり、VectorDrawable をさまざまなサイズに使用する場合、サイズごとに 1 つずつ、複数の VectorDrawable を作成する方が効率的です。

VectorDrawable は、 <vector> 要素を使用して XML ファイルで定義できます。

ベクター描画可能には、次の要素があります。

<dt><vector></dt><dl><dd>ベクター描画可能な <dl><dt>android:name</dt><dd>このベクターの名前を定義するために使用します drawable.</dd><dt>android:width</dt><dd> drawable の組み込み幅を定義するために使用されます。 これにより、通常は dp.< で指定されているすべての寸法単位がサポートされます。/dd><dt>android:height</dt><dd>描画可能な組み込みの高さを定義するために使用されます。 これにより、通常は dp.< で指定されているすべての寸法単位がサポートされます。/dd><dt>android:viewportWidth</dt><dd>ビューポート空間の幅を定義するために使用されます。 ビューポートは基本的に、パスが描画される仮想キャンバス</dd><dt>android:viewportHeight</dt><dd>ビューポート空間の高さを定義するために使用されます。 ビューポートは基本的に、パスが描画される仮想キャンバス</dd><dt>android:tint</dt><dd>描画可能な色を濃淡として適用します。 既定では、濃淡は適用されません。</dd><dt>android:tintMode</dt><dd>濃淡の色の Porter-Duff ブレンド モード。 既定値は src_in.</dd><dt>android:autoMirrored</dt><dd>レイアウト方向が RTL (右から左) のときに描画可能オブジェクトをミラー化する必要があるかどうかを示します。 既定値は false.</dd><dt>android:alpha</dt><dd>この描画可能な不透明度。 既定値は 1.0.</dd></dl></dd></dl>

<dl><dt><group></dt><dd>パスまたはサブグループのグループと変換情報を定義します。 変換はビューポートと同じ座標で定義されます。 変換はスケールの順序で適用され、回転してから平行移動されます。 <dl><dt>android:name</dt><dd> group.< の名前を定義します。/dd><dt>android:rotation</dt><dd>グループの回転角度。 既定値は 0.</dd><dt>android:pivotX</dt><dd>グループのスケールと回転のピボットの X 座標。 これはビューポート空間で定義されます。 既定値は 0.</dd><dt>android:pivotY</dt><dd>グループのスケールと回転のピボットの Y 座標。 これはビューポート空間で定義されます。 既定値は 0.</dd><dt>android:scaleX</dt><dd> X 座標のスケールの量。 既定値は 1.</dd><dt>android:scaleY</dt><dd>Y 座標のスケールの量。 既定値は 1.</dd><dt>android:translateX</dt><dd> X 座標の翻訳量。 これはビューポート空間で定義されます。 既定値は 0.</dd><dt>android:translateY</dt><dd>Y 座標の翻訳量。 これはビューポート空間で定義されます。 既定値は 0.</dd></dl></dd></dl>

<dl><dt><path></dt><dd>描画するDefines パス。 <dl><dt>android:name</dt><dd>パスの名前を定義します</dd><dt>android:pathData</dt><dd>SVG のパス データ内の "d" 属性とまったく同じ形式を使用してパス データを定義します。 これはビューポート空間で定義されます。</dd><dt>android:fillColor</dt><dd>パスの塗りつぶしに使用する色を指定します。 色、または SDK 24 以降の場合は、色の状態リストまたはグラデーションの色を指定できます ( android.R.styleable#GradientColor と android.R.styleable#GradientColorItemを参照)。 このプロパティがアニメーション化されている場合、アニメーションによって設定された値は元の値をオーバーライドします。 このプロパティが指定されていない場合、パスの塗りつぶしは描画されません。</dd><dt>android:strokeColor</dt><dd>パスアウトラインの描画に使用する色を指定します。 色、または SDK 24 以降の場合は、色の状態リストまたはグラデーションの色を指定できます ( android.R.styleable#GradientColor と android.R.styleable#GradientColorItemを参照)。 このプロパティがアニメーション化されている場合、アニメーションによって設定された値は元の値をオーバーライドします。 このプロパティが指定されていない場合、パス アウトラインは描画されません。</dd><dt>android:strokeWidth</dt><dd>パス ストロークの幅。 既定値は 0.</dd><dt>android:strokeAlpha</dt><dd>パス ストロークの不透明度。 既定値は 1.</dd><dt>android:fillAlpha</dt><dd>パスを塗りつぶす不透明度。 既定値は 1.</dd><dt>android:trimPathStart</dt><dd>0 から 1 の範囲で、最初からトリミングするパスの比率。 既定値は 0.</dd><dt>android:trimPathEnd</dt><dd>末尾からトリミングするパスの比率 (0 から 1 の範囲)。 既定値は 1.</dd><dt>android:trimPathOffset</dt><dd>シフト トリミング領域 (表示される領域に開始と終了を含めることができます) を 0 から 1 の範囲で指定します。 既定値は 0.</dd><dt>android:strokeLineCap</dt><dd>突き合わせ、丸い、正方形のストロークパスのラインキャップを設定します。 既定値は butt.</dd><dt>android:strokeLineJoin</dt><dd>ストロークされたパスの lineJoin を設定します。 既定値は miter.</dd><dt>android:strokeMiterLimit</dt><dd>ストロークパスのマイター制限を設定します。 既定値は 4.</dd><dt>android:fillType</dt><dd> SDK 24 以降では、パスの fillType を設定します。 型には、"evenOdd" または "nonZero" のいずれかを指定できます。 これらは SVG の "fill-rule" プロパティと同じように動作します。 既定値は nonZero です。 詳細については、「 FillRuleProperty</dd></dl></dd」を参照してください。>

</dl>

<dl><dt><clip-path></dt><dd>現在のクリップへの定義パス。 クリップ パスは、現在のグループとその子にのみ適用されることに注意してください。 <dl><dt>android:name</dt><dd>クリップ パスの名前を定義します。</dd><dd>Animatable : No.</dd><dt>android:pathData</dt><dd>SVG のパス データの "d" 属性と同じ形式を使用してクリップ パスを定義します</dd><dd>Animatable : Yes.</dd></dl></dd></dl><li>Here は、この vectordrawable.xml ファイル内の単純な VectorDrawable です。

<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 サポート</h4>android.graphics.LinearGradient、 android.graphics.RadialGradient、または android.graphics.SweepGradientの 3 種類のグラデーションがサポートされています。

また、、CLAMP、REPEAT、MIRROR の 3 種類のタイル モードをすべてサポートしています。

すべての属性は、 android.R.styleable#GradientColorに一覧表示されます。 異なる属性は、異なる種類のグラデーションに関連します。 <table border="2" align="center" cellpadding="5"><thead><tr><th>LinearGradient</th><th>RadialGradient</th><th>SweepGradient</th></tr></thead><tr><td>startColor </td><td>startColor</td><startColor>startColor</td></tr><tr><td>centerColor</td><td>centerColor</td><td>centerColor</td></tr><tr><td>endColor</td><td>endColor</td><td>endColor</td></tr><tr><td>type</td><td>type</td><type>/td<></tr><tr><>tileMode</td><td>tileMode</td><tdd>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>gradientRadius</td><td></td></tr><tr><td>endY</td><td></td><></td></tr></table>

また、 android.R.styleable#GradientColorItem の色項目が定義されている場合、startColor、centerColor、endColor は無視されることに注意してください。

詳細については、 android.R.styleable#GradientColor と android.R.styleable#GradientColorItemを参照してください。

線形グラデーションを定義する簡単な例を次に示します。

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

色項目を使用して放射状グラデーションを定義する簡単な例を次に示します。

<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ドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。