<KeyPosition>

يحدّد موضع العرض في لحظة معيّنة أثناء تسلسل الحركة. تُستخدم هذه السمة لضبط المسار الافتراضي للحركة.

على سبيل المثال، إذا كان كائن يبدأ من الزاوية العلوية اليسرى وينتهي بالزاوية السفلية اليمنى، فإن تسلسل الحركة الافتراضي ينقل الكائن مائلاً لأسفل الشاشة. عند إضافة عنصر <KeyPosition> واحد أو أكثر، يمكنك تشويه المسار.

بناء الجملة

<KeyPosition
    motion:motionTarget="@id/targetPath"
    motion:framePosition="percentage"
    motion:keyPositionType="type"
    motion:percentX="xOffset"
  motion:percentY="yOffset"
/>

السمات

motion:motionTarget
الاطّلاع على من يتم التحكّم في حركته من خلال جهاز <KeyPosition> هذا.
motion:framePosition
عدد صحيح من 1 إلى 99 يحدّد وقت وصول العرض في تسلسل الحركة إلى النقطة التي تحدّدها السمة <KeyPosition>. على سبيل المثال، إذا كانت قيمة framePosition هي 25، يصل العرض إلى النقطة المحددة ربع الطريق خلال الحركة.
motion:percentX، motion:percentY
حدد الموضع الذي يصل إليه العرض. تحدّد السمة keyPositionType كيفية تفسير هذه القيم.
motion:keyPositionType
يحدد كيفية تفسير القيمتين percentX وpercentY. في ما يلي الإعدادات المحتمَلة:
  • parentRelative

    • تم تحديد percentX وpercentY بالنسبة إلى العرض الأصلي. س هو المحور الأفقي، ويتراوح من 0 للجانب الأيسر إلى 1 للجانب الأيمن. ص هو المحور الرأسي، حيث يمثل 0 الأعلى و1 يمثل الأسفل.

    على سبيل المثال، إذا كنت تريد أن يصل عرض الاستهداف إلى نقطة في منتصف الجانب الأيسر من طريقة العرض الرئيسية، اضبط percentX على 1 وpercentY على 0.5.

  • deltaRelative

    • يتم تحديد percentX وpercentY بالنسبة إلى المسافة التي يتحركها العرض على مدار تسلسل الحركة بالكامل. س هو المحور الأفقي وص هو المحور الرأسي. وفي كلتا الحالتين، يمثل الرقم 0 موضع بداية العرض في هذا المحور والرقم 1 هو الموضع النهائي.

    لنفترض أن العرض المستهدف يتحرك بمقدار 100 بكسل مستقل الكثافة و100 بكسل مستقل الكثافة إلى اليمين، ولكنك تريد أن ينخفض حجم العرض بمقدار 40 بكسل مستقل الكثافة في الربع الأول من الحركة، ثم القوس مرة أخرى. اضبط framePosition على 25 وkeyPositionType على deltaRelative وpercentY على -0.4.

  • pathRelative

    • والمحور السيني هو الاتجاه الذي يتحرك فيه العرض المستهدف على مدار المسار، حيث يمثل الرقم 0 موضع البداية والرقم 1 هو الموضع النهائي. ويكون المحور ص عموديًا على المحور س، مع وجود قيم موجبة على يسار المسار وقيم سالبة إلى اليمين. إذًا، يكون الموضع الأولي للعرض هو (0,0) والموضع النهائي هو (1,0). وفي حال ضبط قيمة percentY غير صفرية، سيتم انحدار العرض في اتجاه واحد أو اتجاه آخر.

    لنفترض أنك تريد أن يشغل العرض نصف تسلسل الحركة لتغطية 10% من المسافة الإجمالية، ثم سرعته لتغطية 90% المتبقية. اضبط framePosition على 50 وkeyPositionType على pathRelative وpercentX على 0.1. تظل قيمة percentY 0.

مضمنة في