المخططات Layouts

يعرف المخطط واجهات التطبيقات ضمن النشاط أو أي عنصر من عناصر واجهة المستخدم, ويتم إنشاء ملف المخطط تحت المسار التالي:


res/layout/filename.xml
حيث يُستخدم اسم الملف كمعرف للمخطط, ويتم تمثيله المخطط بالصف View أو بأي
صف آخر مشتق منه. ويمكن الوصول إلى المخطط برمجياً باستخدام الشيفرة
التالية:


R.layout.filename
ومن داخل ملفات الـ XML:


@[package:]layout/filename
والصيغة العامة للمخطط:




كود HTML:
<?xml version="1.0" encoding="utf-8"?>
<ViewGroup xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@[+][package:]id/resource_name"
android:layout_height=["dimension" | "fill_parent" | "wrap_content"]
android:layout_width=["dimension" | "fill_parent" | "wrap_content"]
[ViewGroup-specific attributes] >
<View
android:id="@[+][package:]id/resource_name"
android:layout_height=["dimension" | "fill_parent" | "wrap_content"]
android:layout_width=["dimension" | "fill_parent" | "wrap_content"]
[View-specific attributes] >
<requestFocus/>
</View>
<ViewGroup >
<View />
</ViewGroup>
<include layout="@layout/layout_resource"/>
</ViewGroup>
ملاحظة: العنصر الرئيسي للملف يمكن أن يكون أحد الصفوف
المشتقة من ViewGroup أو View أو العنصر <merge>, لكن يجب أن يحتوي
الملف على عنصر رئيسي واحد فقط ويجب أن يحتوي على الخاصية xmlns:android مع
القيمة المبينة في الصيغة السابقة.

<ViewGroup>: وهو عبارة عن نوع من العنصر الذي يحتوي على
عناصر أخرى, وتوجد عدة أنواع يمكن استخدامها ومشتقة من الصف ViewGroup وكل
منها تمكنك من تحديد طريقة عرض العناصر الأبناء بطرق مختلفة. ومن هذه
العناصر LinearLayout, RelativeLayout, FrameLayout. ولا يجب الافتراض بأن
جميع العناصر المشتقة من الصف ViewGroup يمكن أن تقبل عناصر أخرى ضمنها,
لأن بعض العناصر المشتقة من الصف ViewGroup هي عبارة عن تطبيق للصف
AdapterView والذي يقبل العناصر الأبناء له فقط من الصف Adapter:

android:id: معرف العنصر الفريد, والذي يمكن استخدامه كمرجع إلى
العنصر المشتق من الصف ViewGroup من خلال الشيفرة البرمجية أو ضمن نفس ملف
الـ XML.
android:layout_height: قيمة إجبارية رقمية أو كلمة مفتاحية محجوزة مسبقاً, وهي تحدد ارتفاع العنصر ضمن المخطط, والكلمات المحجوزة المقبولة:

• fill_parent.
  
• wrap_content.
  

android:layout_width: قيمة إجبارية رقمية أو كلمة مفتاحية محجوزة مسبقاً, وهي تحدد عرض العنصر ضمن المخطط, والكلمات المحجوزة المقبولة:

• fill_parent.
  
• wrap_content.
  

<View>: عنصر View ضمن واجهة المستخدم مشتق من الصف View, مثل TextBox, Button, CheckBox.

android:id: معرف العنصر الفريد, والذي يمكن استخدامه كمرجع إلى العنصر المشتق من الصف View من خلال الشيفرة البرمجية أو ضمن نفس ملف الـ XML.
android:layout_height: قيمة إجبارية رقمية أو كلمة مفتاحية محجوزة مسبقاً, وهي تحدد ارتفاع العنصر ضمن المخطط, والكلمات المحجوزة المقبولة:

• fill_parent.
  
• wrap_content.
  

android:layout_width: قيمة إجبارية رقمية أو كلمة مفتاحية محجوزة مسبقاً, وهي تحدد عرض العنصر ضمن المخطط, والكلمات المحجوزة المقبولة:

• fill_parent.
  
• wrap_content.
  

<requestFocus>: يمكن استخدام هذا العنصر ضمن أي عنصر مشتق من
الصف View, ويفيد بأن يعطي العنصر الأب للعنصر الذي يستخدم
<requestFocus> تركيزاً مبدئياً على شاشة الجهاز, ويمكن استخدام عنصر
واحد فقط ضمن الملف.
<include>: يُستخدم لإدراج مخطط آخر ضمن هذا المخطط:

• layout: قيمة إجبارية تعبر عن مرجع إلى مخطط آخر.
  
• android:id:
  معرف عنصر فريد للمخطط المدرج, وبتحديد هذه القيمة يتم تجاوز قيمة الخاصية
  android:id المحددة للعنصر الرئيسي في المخطط المشار إليه.
  
• android:layout_height:
  قيمة رقمية أو كلمة مفتاحية محجوزة مسبقاً, وبتحديد هذه القيمة يتم تجاوز
  قيمة الخاصية ذاتها ضمن العنصر الرئيسي في المخطط المدرج, والكلمات
  المحجوزة المقبولة:
  

• fill_parent.
  
• wrap_content.
  

android:layout_width: قيمة رقمية أو كلمة مفتاحية محجوزة مسبقاً,
وبتحديد هذه القيمة يتم تجاوز قيمة الخاصية ذاتها ضمن العنصر الرئيسي في
المخطط المدرج, والكلمات المحجوزة المقبولة:

• fill_parent.
  
• wrap_content.
  

يمكن استخدام أي خاصية ضمن العنصر <include> مدعومة من قبل العنصر
الرئيسي للمخطط المدرج وعندها سيتم تجاهل القيمة المحددة لنفس الخاصية ضمن
العنصر الرئيسي للمخطط المدرج.

ملاحظة: لتغيير أبعاد العنصر الرئيسي في المخطط المدرج يجب تحديد
قيمة للخاصيتين android:layout_height و android:layout_width, حيث لا يمكن
تغيير الارتفاع أو العرض فقط, بل يجب تغيير الاثنين معاً.

<merge>: عبارة عن عنصر رئيسي في ملف المخطط ولكن ليس له
تأثير على واجهة المستخدم, واستخدام هذا العنصر كعنصر رئيسي في الملف يعتبر
فعالاً عندما تكون متأكداً أن المخطط سيتم إدراجه في مخطط آخر باستخدام
العنصر <include>.

قيمة الخاصية android:id
من أجل تحديد قيمة للخاصية android:id التي هي معرف فريد للعنصر بغض النظر
عن نوعه, عادة يجب استخدام الصيغة “+id/name”, حيث أن المحرف + يعني أن
هذا المعرف هو معرفٌ جديد يجب إضافته إلى الصف R.java في حال أنه غير
موجود:




كود HTML:
<TextView android:id="@+id/nameTextbox"/>
القيمة nameTextbox هو معرف سيرتبط بالعنصر TextView وعندها يمكن استخدامه كمرجع ضمن الشيفرة البرمجية:




كود HTML:
findViewById(R.id.nameTextbox);
السطر السابق يعيد مرجعاً للحقل النصي TextView المعرف سابقاً.

ولكن في حال وجود معرف ضمن الصف R.java وغير مستخدم من قبل أي عنصر ضمن
التطبيق عندها يمكن استخدامه ضمن أي عنصر وذلك باستخدام نفس الصيغة السابقة
ولكن بدون المحرف +.

قيم الخاصيتين android:layout_height, android:layout_width
يمكن تحديد قيم للعرض والارتفاع باستخدام أي وحدة قياس معتمدة للأبعاد في
أندرويد (px, dp, sp, pt, in, mm) أو باستخدام الكلمات المفتاحية التالية:

• match_parent: تحدد أبعاد العنصر مطابقة لأبعاد العنصر
  الأب, وقد تمت إضافتها في نسخة الـ API رقم 8 وذلك لاستبعاد القيمة
  fill_aprent.
  
• fill_parent: تحدد أبعاد العنصر مطابقة لأبعاد العنصر الأب.
  
• wrap_content: تحدد أبعاد العنصر لتتطابق مع محتوى العنصر.
  

إنشاء عناصر مخصصة
يمكن في منصة عمل أندرويد إنشاء عناصر جديد مشتقة من الصف View أو الصف
ViewGroup واستخدامها ضمن المخططات كما يتم استخدام العناصر القياسية التي
توفرها منصة عمل أندرويد.

مثال عن استخدام المخطط
المخطط التالي معرف ضمن الملف res/layout/main_activity.xml:




كود HTML:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:orientation="vertical" >
<TextView android:id="@+id/text"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Hello, I am a TextView" />
<Button android:id="@+id/button"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Hello, I am a Button" />
</LinearLayout>
ويتم استخدام المخطط السابق ضمن الشيفرة البرمجية كما يلي:



كود PHP:

public void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView.(R.layout.main_activity);

}