TextOptions interface

الحزمة:

azure-maps-control

الخيارات المستخدمة لتخصيص النص في SymbolLayer

Extends

Options

الخصائص

allowOverlap	يحدد ما إذا كان النص سيكون مرئيا إذا تصادم مع رموز أخرى. إذا كان صحيحا، فسيكون النص مرئيا حتى إذا تصادم مع الرموز الأخرى التي تم رسمها مسبقا. افتراضي false.
anchor	تحديد أي جزء من الأيقونة يتم وضعه الأقرب إلى موضع ارتساء الأيقونات على الخريطة. '"center": يتم وضع مركز الأيقونة الأقرب إلى المرساة. "اليسار": يتم وضع الجانب الأيسر من الأيقونة الأقرب إلى نقطة الارتساء. "اليمين": يتم وضع الجانب الأيمن من الأيقونة الأقرب إلى نقطة الارتساء. "أعلى": يتم وضع الجزء العلوي من الأيقونة الأقرب إلى نقطة الارتساء. "أسفل": يتم وضع الجزء السفلي من الأيقونة الأقرب إلى نقطة الارتساء. "أعلى اليسار": يتم وضع الزاوية العلوية اليمنى من الأيقونة الأقرب إلى المرساة. "أعلى اليمين": يتم وضع الزاوية العلوية اليسرى من الأيقونة الأقرب إلى نقطة الارتساء. "أسفل اليسار": يتم وضع الزاوية السفلية اليمنى من الأيقونة الأقرب إلى المرساة. "أسفل اليمين": يتم وضع الزاوية السفلية اليسرى من الأيقونة الأقرب إلى المرساة. الافتراضي "توسيط".
color	لون النص. افتراضي "#000000".
font	مكدس الخط المراد استخدامه لعرض النص. القيم المحتملة: و و و و و "SegoeUi-Light"و "SegoeUi-Regular"و "SegoeUi-SemiLight""SegoeUi-SemiBold"و "SegoeUi-SymbolRegular"و"StandardCondensedSegoeUi-Bold""StandardCondensedSegoeUi-Light""StandardFont-Light""StandardFont-Bold""StandardFont-Regular""StandardFontCondensed-Black""StandardFontCondensed-Regular""StandardFontCondensed-Light""StandardFontCondensed-Bold""StandardFont-Black""StandardCondensedSegoeUi-Regular""StandardCondensedSegoeUi-Black". "SegoeUi-Bold""SegoeFrutigerHelveticaMYingHei-Regular""SegoeFrutigerHelveticaMYingHei-Medium""SegoeFrutigerHelveticaMYingHei-Bold" افتراضي ["StandardFont-Regular"].
haloBlur	مسافة تلاشي الهالو نحو الخارج بالبكسل. يجب أن يكون رقما أكبر أو يساوي 0. افتراضي 0.
haloColor	لون هالة النص، مما يساعده على تمييزه عن الخلفيات. افتراضي "rgba(0,0,0,0)".
haloWidth	مسافة الهالة إلى المخطط التفصيلي للخط بالبكسل. يجب أن يكون رقما أكبر أو يساوي 0. الحد الأقصى لعرض هالة النص هو 1/4 من حجم الخط. افتراضي 0.
ignorePlacement	يحدد ما إذا كان يسمح للرموز الأخرى بالاصطدام بالنص. إذا كان صحيحا، يمكن أن تكون الرموز الأخرى مرئية حتى إذا تصادمت مع النص. افتراضي false.
justify	خيارات تبرير النص. "auto": تتم محاذاة النص نحو موضع الارتساء. '"اليسار": تتم محاذاة النص إلى اليسار. "توسيط": يتم توسيط النص. '"right": تتم محاذاة النص إلى اليمين. الافتراضي '"center"".
offset	تحديد مسافة إزاحة الأيقونة من ارتسائها في ems. تشير القيم الموجبة إلى اليمين وللأسفل، بينما تشير القيم السالبة إلى اليسار والأعلى. افتراضي [0, 0].
opacity	رقم بين 0 و1 يشير إلى التعتام الذي سيتم رسم النص عنده. افتراضي 1.
optional	تحديد ما إذا كان يمكن إخفاء النص إذا كان متداخلا مع رمز آخر. إذا كان صحيحا، فسيتم عرض الأيقونات بدون النص المقابل لها عندما يتصادم النص مع رموز أخرى ولا تظهر الأيقونة. افتراضي false.
padding	حجم المنطقة الإضافية حول مربع إحاطة النص المستخدم للكشف عن تضاربات الرموز. افتراضي 2.
pitchAlignment	تحديد اتجاه النص عند عرض الخريطة. ''auto': يطابق تلقائيا قيمة 'rotationAlignment'. "الخريطة": تتم محاذاة النص إلى مستوى الخريطة. "منفذ العرض": تتم محاذاة النص إلى مستوى منفذ العرض. الافتراضي: "تلقائي""
radialOffset	إزاحة شعاعية للنص، في اتجاه ارتساء الرمز. مفيدة في تركيبة مع variableAnchor، والتي افتراضيا لاستخدام ثنائي الأبعاد offset إذا كان موجودا. افتراضي: 0
rotation	مقدار تدوير النص باتجاه عقارب الساعة بالدرجات. الافتراضي 0
rotationAlignment	بالاقتران مع placement خاصية SymbolLayerOptions، يحدد سلوك الاستدارة للالرموز الفردية التي تشكل النص. ''auto': عند تعيين 'placement' إلى ''point'، يكون هذا مكافئا ل ''map'. عند تعيين "الموضع" إلى "سطر"، يكون هذا مكافئا ل ""الخريطة". "الخريطة": عند تعيين "الموضع" إلى "نقطة"، يقوم بمحاذاة النص شرقا وغربا. عند تعيين "الموضع" إلى "سطر"، يقوم بمحاذاة محاور النص x مع السطر. "منفذ العرض": ينتج الرموز التي تتم محاذاة محاور x الخاصة بها مع المحور س لمنفذ العرض، بغض النظر عن قيمة "الموضع". الافتراضي: "تلقائي""
size	حجم الخط بالبكسل. يجب أن يكون رقما أكبر أو يساوي 0. افتراضي 16.
textField	تحديد اسم خاصية على الميزات التي يجب استخدامها لتسمية نصية.
variableAnchor	قائمة مواقع الارتساء المحتملة، لزيادة فرصة وضع تسميات ذات أولوية عالية على الخريطة. سيحاول العارض وضع التسمية في كل موقع، بالترتيب، قبل الانتقال إلى التسمية التالية. استخدم justify: "auto" لاختيار مبرر النص استنادا إلى موضع الارتساء. لتطبيق إزاحة، استخدم radialOffset الخيارات ثنائية الأبعاد offset أو . '"center": يتم وضع مركز الأيقونة الأقرب إلى نقطة الارتساء. "يسار": يتم وضع الجانب الأيسر من الأيقونة الأقرب إلى نقطة الارتساء. '"right": يتم وضع الجانب الأيمن من الأيقونة الأقرب إلى نقطة الارتساء. "أعلى": يتم وضع أعلى الأيقونة الأقرب إلى نقطة الارتساء. "أسفل": يتم وضع الجزء السفلي من الأيقونة الأقرب إلى نقطة الارتساء. "أعلى اليسار": يتم وضع الزاوية العلوية اليمنى من الأيقونة الأقرب إلى نقطة الارتساء. "أعلى اليمين": يتم وضع الزاوية العلوية اليسرى من الأيقونة الأقرب إلى نقطة الارتساء. "أسفل اليسار": يتم وضع الزاوية السفلية اليمنى من الأيقونة الأقرب إلى نقطة الارتساء. "أسفل اليمين": يتم وضع الزاوية السفلية اليسرى من الأيقونة الأقرب إلى نقطة الارتساء. الافتراضي: "غير معرف"

تفاصيل الخاصية

allowOverlap

يحدد ما إذا كان النص سيكون مرئيا إذا تصادم مع رموز أخرى. إذا كان صحيحا، فسيكون النص مرئيا حتى إذا تصادم مع الرموز الأخرى التي تم رسمها مسبقا. افتراضي false.

allowOverlap?: boolean

قيمة الخاصية

boolean

anchor

تحديد أي جزء من الأيقونة يتم وضعه الأقرب إلى موضع ارتساء الأيقونات على الخريطة.

'"center": يتم وضع مركز الأيقونة الأقرب إلى المرساة.

"اليسار": يتم وضع الجانب الأيسر من الأيقونة الأقرب إلى نقطة الارتساء.

"اليمين": يتم وضع الجانب الأيمن من الأيقونة الأقرب إلى نقطة الارتساء.

"أعلى": يتم وضع الجزء العلوي من الأيقونة الأقرب إلى نقطة الارتساء.

"أسفل": يتم وضع الجزء السفلي من الأيقونة الأقرب إلى نقطة الارتساء.

"أعلى اليسار": يتم وضع الزاوية العلوية اليمنى من الأيقونة الأقرب إلى المرساة.

"أعلى اليمين": يتم وضع الزاوية العلوية اليسرى من الأيقونة الأقرب إلى نقطة الارتساء.

"أسفل اليسار": يتم وضع الزاوية السفلية اليمنى من الأيقونة الأقرب إلى المرساة.

"أسفل اليمين": يتم وضع الزاوية السفلية اليسرى من الأيقونة الأقرب إلى المرساة.

الافتراضي "توسيط".

anchor?: PositionAnchor | DataDrivenPropertyValueSpecification<PositionAnchor>

قيمة الخاصية

PositionAnchor | DataDrivenPropertyValueSpecification<PositionAnchor>

color

لون النص. افتراضي "#000000".

color?: string | DataDrivenPropertyValueSpecification<string>

قيمة الخاصية

string | DataDrivenPropertyValueSpecification<string>

font

مكدس الخط المراد استخدامه لعرض النص. القيم المحتملة: و و و و و "SegoeUi-Light"و "SegoeUi-Regular"و "SegoeUi-SemiLight""SegoeUi-SemiBold"و "SegoeUi-SymbolRegular"و"StandardCondensedSegoeUi-Bold""StandardCondensedSegoeUi-Light""StandardFont-Light""StandardFont-Bold""StandardFont-Regular""StandardFontCondensed-Black""StandardFontCondensed-Regular""StandardFontCondensed-Light""StandardFontCondensed-Bold""StandardFont-Black""StandardCondensedSegoeUi-Regular""StandardCondensedSegoeUi-Black". "SegoeUi-Bold""SegoeFrutigerHelveticaMYingHei-Regular""SegoeFrutigerHelveticaMYingHei-Medium""SegoeFrutigerHelveticaMYingHei-Bold" افتراضي ["StandardFont-Regular"].

font?: string[] | DataDrivenPropertyValueSpecification<string[]>

قيمة الخاصية

string[] | DataDrivenPropertyValueSpecification<string[]>

haloBlur

مسافة تلاشي الهالو نحو الخارج بالبكسل. يجب أن يكون رقما أكبر أو يساوي 0. افتراضي 0.

haloBlur?: number | DataDrivenPropertyValueSpecification<number>

قيمة الخاصية

number | DataDrivenPropertyValueSpecification<number>

haloColor

لون هالة النص، مما يساعده على تمييزه عن الخلفيات. افتراضي "rgba(0,0,0,0)".

haloColor?: string | DataDrivenPropertyValueSpecification<string>

قيمة الخاصية

string | DataDrivenPropertyValueSpecification<string>

haloWidth

مسافة الهالة إلى المخطط التفصيلي للخط بالبكسل. يجب أن يكون رقما أكبر أو يساوي 0. الحد الأقصى لعرض هالة النص هو 1/4 من حجم الخط. افتراضي 0.

haloWidth?: number | DataDrivenPropertyValueSpecification<number>

قيمة الخاصية

number | DataDrivenPropertyValueSpecification<number>

ignorePlacement

يحدد ما إذا كان يسمح للرموز الأخرى بالاصطدام بالنص. إذا كان صحيحا، يمكن أن تكون الرموز الأخرى مرئية حتى إذا تصادمت مع النص. افتراضي false.

ignorePlacement?: boolean

قيمة الخاصية

boolean

justify

خيارات تبرير النص.

"auto": تتم محاذاة النص نحو موضع الارتساء.

'"اليسار": تتم محاذاة النص إلى اليسار.

"توسيط": يتم توسيط النص.

'"right": تتم محاذاة النص إلى اليمين. الافتراضي '"center"".

justify?: "auto" | "left" | "center" | "right"

قيمة الخاصية

"auto" | "left" | "center" | "right"

offset

تحديد مسافة إزاحة الأيقونة من ارتسائها في ems. تشير القيم الموجبة إلى اليمين وللأسفل، بينما تشير القيم السالبة إلى اليسار والأعلى. افتراضي [0, 0].

offset?: Pixel | DataDrivenPropertyValueSpecification<Pixel>

قيمة الخاصية

Pixel | DataDrivenPropertyValueSpecification<Pixel>

opacity

رقم بين 0 و1 يشير إلى التعتام الذي سيتم رسم النص عنده. افتراضي 1.

opacity?: number | DataDrivenPropertyValueSpecification<number>

قيمة الخاصية

number | DataDrivenPropertyValueSpecification<number>

optional

تحديد ما إذا كان يمكن إخفاء النص إذا كان متداخلا مع رمز آخر. إذا كان صحيحا، فسيتم عرض الأيقونات بدون النص المقابل لها عندما يتصادم النص مع رموز أخرى ولا تظهر الأيقونة. افتراضي false.

optional?: boolean

قيمة الخاصية

boolean

padding

حجم المنطقة الإضافية حول مربع إحاطة النص المستخدم للكشف عن تضاربات الرموز. افتراضي 2.

padding?: number | PropertyValueSpecification<number>

قيمة الخاصية

number | PropertyValueSpecification<number>

pitchAlignment

تحديد اتجاه النص عند عرض الخريطة.

''auto': يطابق تلقائيا قيمة 'rotationAlignment'.

"الخريطة": تتم محاذاة النص إلى مستوى الخريطة.

"منفذ العرض": تتم محاذاة النص إلى مستوى منفذ العرض.

الافتراضي: "تلقائي""

pitchAlignment?: "auto" | "map" | "viewport"

قيمة الخاصية

"auto" | "map" | "viewport"

radialOffset

إزاحة شعاعية للنص، في اتجاه ارتساء الرمز. مفيدة في تركيبة مع variableAnchor، والتي افتراضيا لاستخدام ثنائي الأبعاد offset إذا كان موجودا. افتراضي: 0

radialOffset?: number | DataDrivenPropertyValueSpecification<number>

قيمة الخاصية

number | DataDrivenPropertyValueSpecification<number>

rotation

مقدار تدوير النص باتجاه عقارب الساعة بالدرجات. الافتراضي 0

rotation?: number | DataDrivenPropertyValueSpecification<number>

قيمة الخاصية

number | DataDrivenPropertyValueSpecification<number>

rotationAlignment

بالاقتران مع placement خاصية SymbolLayerOptions، يحدد سلوك الاستدارة للالرموز الفردية التي تشكل النص.

''auto': عند تعيين 'placement' إلى ''point'، يكون هذا مكافئا ل ''map'. عند تعيين "الموضع" إلى "سطر"، يكون هذا مكافئا ل ""الخريطة".

"الخريطة": عند تعيين "الموضع" إلى "نقطة"، يقوم بمحاذاة النص شرقا وغربا. عند تعيين "الموضع" إلى "سطر"، يقوم بمحاذاة محاور النص x مع السطر.

"منفذ العرض": ينتج الرموز التي تتم محاذاة محاور x الخاصة بها مع المحور س لمنفذ العرض، بغض النظر عن قيمة "الموضع".

الافتراضي: "تلقائي""

rotationAlignment?: "auto" | "map" | "viewport"

قيمة الخاصية

"auto" | "map" | "viewport"

size

حجم الخط بالبكسل. يجب أن يكون رقما أكبر أو يساوي 0. افتراضي 16.

size?: number | DataDrivenPropertyValueSpecification<number>

قيمة الخاصية

number | DataDrivenPropertyValueSpecification<number>

textField

تحديد اسم خاصية على الميزات التي يجب استخدامها لتسمية نصية.

textField?: string | DataDrivenPropertyValueSpecification<string>

قيمة الخاصية

string | DataDrivenPropertyValueSpecification<string>

variableAnchor

قائمة مواقع الارتساء المحتملة، لزيادة فرصة وضع تسميات ذات أولوية عالية على الخريطة. سيحاول العارض وضع التسمية في كل موقع، بالترتيب، قبل الانتقال إلى التسمية التالية. استخدم justify: "auto" لاختيار مبرر النص استنادا إلى موضع الارتساء. لتطبيق إزاحة، استخدم radialOffset الخيارات ثنائية الأبعاد offset أو .

'"center": يتم وضع مركز الأيقونة الأقرب إلى نقطة الارتساء.

"يسار": يتم وضع الجانب الأيسر من الأيقونة الأقرب إلى نقطة الارتساء.

'"right": يتم وضع الجانب الأيمن من الأيقونة الأقرب إلى نقطة الارتساء.

"أعلى": يتم وضع أعلى الأيقونة الأقرب إلى نقطة الارتساء.

"أسفل": يتم وضع الجزء السفلي من الأيقونة الأقرب إلى نقطة الارتساء.

"أعلى اليسار": يتم وضع الزاوية العلوية اليمنى من الأيقونة الأقرب إلى نقطة الارتساء.

"أعلى اليمين": يتم وضع الزاوية العلوية اليسرى من الأيقونة الأقرب إلى نقطة الارتساء.

"أسفل اليسار": يتم وضع الزاوية السفلية اليمنى من الأيقونة الأقرب إلى نقطة الارتساء.

"أسفل اليمين": يتم وضع الزاوية السفلية اليسرى من الأيقونة الأقرب إلى نقطة الارتساء.

الافتراضي: "غير معرف"

variableAnchor?: PositionAnchor[]

قيمة الخاصية

PositionAnchor[]