استخدام عنصر تحكم إدخال العنوان لإدخال العناوين بسهولة
قد يكون إدخال العناوين أمرًا معرقلاً ومليئًا بالأخطاء وبالتحديد في تطبيقات الأجهزة المحمولة. استخدم عنصر تحكم إدخال العنوان لتسهيل إدخال العناوين. يستخدم عنصر التحكم منطقًا غامضًا لاقتراح التطابقات المحتملة عند الكتابة. حدد العنوان الذي تريده لإدخال عنوان دقيق بسرعة وسهولة.
يعرض عنصر التحكم العنوان كبيانات مهيكلة. يمكن أن يستخرج تطبيقك معلومات مثل المدينة والشارع والبلدة وحتى إحداثيات خط الطول والعرض. وتكون البيانات بتنسيق مألوف للعديد من الإعدادات المحلية وتنسيقات العناوين الدولية.
المتطلبات
قم أن تتمكن من استخدام عنصر التحكم، تحتاج إلى تمكين الميزات الموقع الجيوفضائي للبيئة. تأكد أيضًا من مراجعة المتطلبات الأساسية لاستخدام عناصر تحكم الموضع الجيوفضائي. راجع جدول الخصوصية والأمان لمزيد من التفاصيل حول استخدام بيانات عنصر تحكم إدخال العنوان.
إضافة عنصر تحكم إدخال العنوان إلى تطبيقك
مع فتح تطبيقك للتحرير في Power Apps Studio:
- افتح علامة التبويب إدراج، ثم قم بتوسيع الإدخال.
- حدد إدخال العنوان لوضع مربع إدخال عنوان في شاشة التطبيق، أو اسحب عنصر التحكم إلى الشاشة لتحديد موضعه بطريقة أكثر دقة. يجب إدخال ثلاثة أحرف على الأقل تتضمن رقمًا واحدًا لعنصر التحكم إدخال العنوان.
تعيين نصف قطر بحث افتراضي
سيبحث عنصر التحكم افتراضياً حول موقع المستخدم. يمكنك تنقيح منطقة البحث الافتراضية للمساعدة في تضييق النتائج الأولية.
- في علامة التبويب الخصائص لعنصر تحكم إدخال العنوان، قم بتشغيل خاصية Search within radius.
- قم بإدخال خط الطول وخط العرض ونصف القطر بالأمتار.
سيبدأ عنصر التحكم عملية البحث عند خط العرض والطول المُعطى، إلى المسافة المحددة.
استخدام عنصر تحكم الخريطة مع عنصر تحكم إدخال العنوان
يمكنك إضافة زر إلى تطبيقك لحفظ العناوين التي تم إدخالها كمجموعة بيانات. يمكنك بعد ذلك استرداد هذه العناوين وعرضها في عنصر التحكم الخريطة.
أضف عنصر تحكم الخريطة وعنصر تحكم إدخال العنوان إلى تطبيقك.
قم بإدراج عنصر تحكم الزر وضعه.
قم بتغيير خاصية OnSelect لعنصر تحكم الزر إلى الآتي: (تلميح: انسخ الصيغة والصقها في شريط الصيغة أو في علامة تبويب خصائص متقدمة، أيهما تفضل.) =======
قم بإدخال خط الطول وخط العرض ونصف القطر (بالأمتار).
سيبدأ عنصر التحكم عملية البحث عند خط العرض والطول، إلى المسافة المحددة في حقل نصف القطر.
If(IsBlank(AddressInput1.SearchResultJson), "", Collect(locations, {Latitude: AddressInput1.SelectedLatitude, Longitude: AddressInput1.SelectedLongitude}))تقوم الصيغة بحفظ خط الطول وخط العرض الحاليين في مجموعة مسماة المواقع، طالما أن نتائج البحث ليست فارغة.
حدد عنصر التحكم الخريطة. قم بتغيير خصائصه كما يلي:
اسم الخاصية القيمة الموقع Items "المواقع" علامة تبويب الخصائص ItemsLatitudes "خط العرض" علامة تبويب خيارات متقدمة ItemsLongitudes "خط الطول" علامة تبويب خيارات متقدمة
عندما يحدد المستخدم الزر، ستُضاف النتيجة من عنصر التحكم إدخال العنوان إلى الخريطة كدبوس جديد.
الخصائص
قم بتغيير سلوك عنصر تحكم إدخال العنوان ومظهره باستخدام الخصائص. تتوفر فقط بعض الخصائص في علامة التبويب خيارات متقدمة.
| الخاصية | الوصف | النوع | علامة التبويب |
|---|---|---|---|
| Default | تعيين قيمة عنصر التحكم الأولية. | سلسلة | خصائص؛ خيارات متقدمة: افتراضي |
| نص التلميح | تعيين التلميح الذي يظهر في عنصر التحكم قبل إدخال المستخدم للنص. | سلسلة | الخصائص؛ خيارات متقدمة: HintText |
| Font | تعيين اسم عائلة الخطوط المستخدمة لنص عنصر التحكم. | قائمة منسدلة | خصائص؛ خيارات متقدمة: Font |
| حجم الخط | تعيين حجم نص عنصر التحكم. | رقم الفاصلة العائمة | خصائص؛ خيارات متقدمة: FontSize |
| وزن الخط | تعيين وزن نص عنصر التحكم، إما غامق، أو خفيف، أو عاديأو شبه غامق. | قائمة منسدلة | خصائص؛ خيارات متقدمة: FontWeight |
| محاذاة النص | تعيين المحاذاة الأفقية لنص عنصر التحكم، إما توسيط أو ضبط أو يسار أو يمين. | قائمة منسدلة | خصائص؛ خيارات متقدمة: TextAlignment |
| ارتفاع السطر | تعيين المسافة العمودية بين أسطر النص في عنصر التحكم. | رقم الفاصلة العائمة | خصائص؛ خيارات متقدمة: LineHeight |
| وضع العرض | تحديد ما إذا كان عنصر التحكم يسمح بإدخال من المستخدم (تحرير)، أم عرض البيانات فقط (عرض)، أم تعطيل (معطلة). | قائمة منسدلة | خصائص؛ خيارات متقدمة: DisplayMode |
| نمط الخط | تعيين نمط نص عنصر التحكم، إما مائل أو تسطير أو يتوسطه خط أو بلا. | قائمة منسدلة | خصائص؛ خيارات متقدمة: Italic أو Underline أو Strikethrough |
| حد نتيجة البحث | تعيين عدد العناوين المقترحة التي يعرضها عنصر التحكم. | عدد صحيح | خصائص؛ خيارات متقدمة SearchResultLimit |
| Search within radius | يحدد ما إذا كان يجب على عنصر التحكم اقتراح عناوين ضمن نصف قطر خط العرض وخط الطول. | منطقي | خصائص؛ خيارات متقدمة: SearchWithinRadius |
| خط العرض | تعيين إحداثي خط العرض لنقطة الوسط المستخدمة لاقتراحات العناوين. يتطلب وجود Search within radius للتشغيل. | رقم الفاصلة العائمة -90 إلى 90 | خصائص؛ خيارات متقدمة: Latitude |
| خط الطول | تعيين إحداثي خط الطول لنقطة الوسط المستخدمة لاقتراحات العناوين. يتطلب وجود Search within radius للتشغيل. | رقم الفاصلة العائمة -180 إلى 180 | خصائص؛ خيارات متقدمة: Longitude |
| نصف القطر | تعيين نصف القطر، بالمتر، حول خط العرض وخط الطول لتقييد اقتراحات العنوان. يتطلب وجود Search within radius للتشغيل. | رقم الفاصلة العائمة | خصائص؛ خيارات متقدمة: Radius |
| اللغة | تعيين اللغة التي يتم بها إرجاع اقتراحات العنوان. | سلسلة | خصائص؛ خيارات متقدمة: Language |
| تعيين الدولة | تحديد قائمة للبلدان/المناطق مفصولة بفواصل لتقييد اقتراحات العنوان بها، بتنسيق ISO 3166 alpha-2؛ على سبيل المثال، US,CA,MX. | سلسلة | الخصائص؛ خيارات متقدمة: CountrySet |
| مرئي | إظهار عنصر التحكم أو إخفاؤه. | منطقي | الخصائص؛ خيارات متقدمة: Visible |
| الحاشية العلوية | تعيين المسافة بين نص عنصر التحكم وأعلى عنصر التحكم. | رقم الفاصلة العائمة | خصائص؛ خيارات متقدمة: PaddingTop |
| الحاشية السفلية | تعيين المسافة بين نص عنصر التحكم وأسفل عنصر التحكم. | رقم الفاصلة العائمة | خصائص؛ متقدمة: PaddingBottom |
| حاشية يسرى | تعيين المسافة بين نص عنصر التحكم والحافة اليسرى لعنصر التحكم. | رقم الفاصلة العائمة | خصائص؛ خيارات متقدمة: PaddingLeft |
| حاشية يمنى | تعيين المسافة بين نص عنصر التحكم والحافة اليمنى لعنصر التحكم. | رقم الفاصلة العائمة | خصائص؛ خيارات متقدمة: PaddingRight |
| الموضع | وضع الزاوية العلوية اليسرى لعنصر التحكم في إحداثيات الشاشة المحددة في X وY. | عدد صحيح | خصائص؛ خيارات متقدمة: X، Y |
| الحجم | تحديد حجم عنصر التحكم باستخدام قيم البكسل المتوفرة في العرض والارتفاع. | عدد صحيح | خصائص؛ خيارات متقدمة: Width، Height |
| نص قطر الحد | تحديد نصف قطر الزاوية لحدود عنصر التحكم. | رقم الفاصلة العائمة | خصائص؛ خيارات متقدمة: BorderRadius |
| اللون | تعيين ألوان نص عنصر التحكم وخلفيته. | غير قابل للتطبيق | خصائص؛ خيارات متقدمة: FillColor وTextColor |
| الحد | تحديد نمط حد عنصر التحكم وعرضه ولونه. | غير قابل للتطبيق | خصائص؛ خيارات متقدمة: BorderStyle و**BorderThickness** و**BorderColor** |
| فهرس علامة التبويب | تحديد الترتيب الذي يتم فيه تحديد عنصر التحكم إذا كان المستخدم يتنقل في التطبيق باستخدام مفتاح Tab. | رقم صحيح | خصائص؛ خيارات متقدمة: TabIndex |
| تعريف الأدوات | تحديد النص الذي سيتم عرضه عندما يقوم المستخدم بتمرير الماوس فوق عنصر التحكم. | سلسلة | خصائص، خيارات متقدمة: Tooltip |
| لون التمرير | تعيين ألوان نص عنصر التحكم وخلفية عنصر التحكم وحد عنصر التحكم عندما يقوم المستخدم بتمرير مؤشر الماوس فوقها. | غير قابل للتطبيق | خصائص، خيارات متقدمة: HoverFontColor وHoverFillColor وHoverBorderColor |
| لون التعطيل | تعيين ألوان نص عنصر التحكم وخلفية عنصر التحكم وحد عنصر التحكم إذا كان DisplayMode معطلاً. | غير قابل للتطبيق | خصائص؛ خيارات متقدمة: DisabledFontColor وDisabledFillColor وDisabledBorderColor |
| لون الضغط | تعيين ألوان نص عنصر التحكم وخلفية عنصر التحكم وحد عنصر التحكم عندما يقوم المستخدم بتحديد عنصر التحكم. | غير قابل للتطبيق | خصائص؛ خيارات متقدمة: PressedFontColorو PressedFillColor و PressedBorderColor |
| ContentLanguage | تحديد لغة العرض لعنصر التحكم، إذا كانت مختلفة عن اللغة المستخدمة في التطبيق. | سلسلة | خيارات متقدمة |
| OnAddressSelect | تحتوي على تعليمات برمجية تعمل عندما يقوم المستخدم بتحديد عنوان مقترح. | الحدث | خيارات متقدمة |
| OnChange | تحتوي على تعليمات برمجية يتم تشغيلها عند تغيير خاصية عنصر التحكم. | الحدث | خيارات متقدمة |
خصائص الإخراج
تتوفر خصائص أخرى عند تفاعل المستخدم مع عنصر تحكم إدخال العنوان. يمكنك استخدام خصائص الإخراج هذه في عناصر تحكم أخرى أو لتخصيص تجربة التطبيق.
| الخاصية | الوصف |
|---|---|
| UserInput | النص الذي كتبه المستخدم في مربع الإدخال |
| SelectedLatitude | خط عرض العنوان الذي حدده المستخدم |
| SelectedLongitude | خط طول العنوان الذي حدده المستخدم |
| SearchResultJson | نتيجة البحث، استنادًا إلى خاصية UserInput، معروضة كسلسلة في خاصية بتنسيق JSON |
| FreeformAddress | العنوان الذي حدده المستخدم من قائمة العناوين المقترحة |
| LocalName | اسم منطقة جغرافية أو محلية تجمع عددًا من الكائنات القابلة للعنونة لأغراض العنونة، دون أن تكون وحدة إدارية. |
| PostalCode | الرمز البريدي |
| ExtendedPostalCode | الرمز البريدي الموسع |
| CountryCode | رمز الدولة |
| البلد | اسم الدولة/المنطقة |
| CountryCodeISO3 | رمز الدولة بتنسيق ISO alpha-3 |
| CountrySubdivisionName | اسم القسم الفرعي للبلد/المنطقة |
| StreetName | اسم الشارع |
| StreetNumber | رقم الشارع |
| البلدية | البلدية |
| MunicipalitySubdivision | القسم الفرعي للبلدية |
| CountryTertiarySubdivision | القسم الفرعي فوق الثانوي للبلد/المنطقة |
| CountrySecondarySubdivision | القسم الفرعي الثانوي للبلد/المنطقة |
| CountrySubdivision | القسم الفرعي للبلد/المنطقة |
عناصر تحكم الموضع الجيوفضائي الأخرى
لعرض بيانات الموقع بشكل بياني وتفسيرها، استخدم عنصر التحكم interactive الخريطة.
الملاحظات
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجع https://aka.ms/ContentUserFeedback.
إرسال الملاحظات وعرضها المتعلقة بـ