نمایانگر بخشی از صفحه ساعت است که دقیقاً شامل یک عنصر طرحبندی متن است.
در Wear OS 4 معرفی شد.
نحو
<PartText x="integer" y="integer" width="integer" height="integer" pivotX="float" pivotY="float" angle="float-degrees" alpha="integer" name="string" scaleX="float" scaleY="float" renderMode="[SOURCE | MASK | ALL]" tintColor="argb-color | rgb-color"> <!-- Text-specific child elements. --> <Text> <!-- There must be raw text as the leaf inner element within a "PartText" element tree. --> <Font family="font" size="20" color="#00FFFF">Hello world </Font> <Font> <!-- Example of a text decoration element. --> <Outline> <!-- Example of a template with 2 string values. --> <Template>%s %s <Parameter expression="[MONTH_S]" /> <Parameter expression="[DAY]" /> </Template> </Outline> <!-- Example of a text formatting element. --> <Upper> <Template ... /> </Upper> <Template ... /> </Font> </Text> <!-- A "PartText" element can contain this "TextCircular" element instead of a "Text" element. --> <TextCircular centerX="180" centerY="180" direction="COUNTER_CLOCKWISE" endAngle="90" height="340" width="340" startAngle="270"> There must be raw text as the leaf inner element within a "PartText" element tree. <Font family="font" size="20" color="#00FFFF">Hello world </Font> <Font> Example of a text decoration element. <Outline> Example of a template with 2 string values. <Template>%s %s <Parameter expression="[MONTH_S]" /> <Parameter expression="[DAY]" /> </Template> </Outline> Example of a text formatting element. <Upper> <Template ... /> </Upper> <Template ... /> </Font> </TextCircular /> --> <!-- Child elements that are shared across all "Part" elements. --> <Localization .../> <Transform .../> <Variant .../> <Gyro .../> <Launch .../> <ScreenReader .../> </PartText>
صفات
عنصر PartText
دارای ویژگی های زیر است:
ویژگی های مورد نیاز
ویژگی های زیر مورد نیاز است:
-
x
،y
،width
،height
- مجموعه ای از اعداد صحیح که اندازه و موقعیت عنصر را مشخص می کند.
ویژگی های اختیاری
ویژگی های زیر اختیاری هستند:
-
pivotX
،pivotY
- یک نقطه محوری دو بعدی که عنصر به دور آن می چرخد. هر دو مقدار، اعداد ممیز شناور هستند که برای قرار گرفتن در محدوده $ [0، 1] $ مقیاس بندی شده اند.
-
angle
- تعدادی درجه، در جهت عقربه های ساعت، که عنصر باید حول نقطه محوری خود بچرخد.
-
alpha
- سطح شفافیتی که این عنصر باید داشته باشد را تنظیم کنید. مقدار
0
نشان می دهد که عنصر باید کاملا شفاف باشد. مقدار255
نشان می دهد که عنصر باید کاملاً مات باشد. -
name
- رشته ای که این عنصر را مشخص می کند. اگر نیاز به مراجعه به این عنصر از مکان دیگری در فایل صفحه ساعت خود دارید مفید است.
-
scaleX
- ضریب مقیاس افقی برای اعمال این عنصر.
-
scaleY
- ضریب مقیاس بندی عمودی برای اعمال این عنصر.
-
renderMode
- نوع حالت رندر عنصر. مقادیر ممکن عبارتند از:
SOURCE
(پیشفرض)،MASK
یاALL
. -
tintColor
- یک فیلتر رنگی رنگی را روی عنصر اعمال کنید. شما باید رنگ را با استفاده از فرمت ARGB (
#ff000000
= سیاه مات) یا فرمت RGB (#000000
= سیاه) مشخص کنید.
عناصر درونی
عنصر PartText
می تواند شامل عناصر داخلی زیر باشد. همه عناصر اختیاری هستند، با این تفاوت که Text
یا TextCircular
باید یکی از عناصر داخلی باشد. یک عنصر PartText
میتواند شامل تعداد نامحدودی از هر عنصر داخلی باشد - به جز Text
، TextCircular
، Localization
، Gyro
، Launch
و ScreenReader
که میتوانند حداکثر 1 بار ظاهر شوند.