4- أهم دوال وخصائص HTMLElement.

بسم الله الرحمن الرحيم

السلام عليكم ورحمة الله وبركاته

اللهم علمنا ما ينفعنا وانفعنا بما علمتنا إنك أنت العليم الحكيم

 ====>What is HTML Element ?<====

هو فصيلة(Class) تمثل العناصر في لغة HTML

====>Most Important Properties<====

1- All

تعيد HtmlElementCollection تحتوي على جميع العناصر الموجودة داخل أو تحت هذا العنصر.
VB.Net

 Dim Parent As HtmlElement = NameOfYourWebBrowser.Document.GetElementById("Testtable") For Each CC As HtmlElement In Parent.All If CC.TagName.ToLower = "th" Then MsgBox("cell value = " & CC.InnerText) Next

C Sharp

HtmlElement Parent = NameOfYourWebBrowser.Document.GetElementById("Testtable"); foreach (HtmlElement CC in Parent.All) { if (CC.TagName.ToLower() == "th") MessageBox.Show("cell value = " + CC.InnerText); }

2- ClientRectangle

تعيد Rectangle يحتوي على أبعاد (الطول والعرض وس{X} وص{Y}) العنصر في الصفحة.

 VB.Net

Dim Element As HtmlElement = NameOfYourWebBrowser.Document.GetElementById("Testtable") With Element MsgBox(String.Format("Width = {1}{0}Height = {2}{0}X = {3}{0}Y = {4}", vbNewLine, .ClientRectangle.Width, .ClientRectangle.Height, .ClientRectangle.X, .ClientRectangle.Y), MsgBoxStyle.Information) End With)

C Sharp

HtmlElement Element = NameOfYourWebBrowser.Document.GetElementById("Testtable"); MessageBox.Show(String.Format("Width = {1}{0}Height = {2}{0}X = {3}{0}Y = {4}", Environment.NewLine, Element.ClientRectangle.Width, Element.ClientRectangle.Height, Element.ClientRectangle.X, Element.ClientRectangle.Y));

3- Enabled

تحدد إذا ما كان هذا العنصر "ممكناً" أو قابلاً للإستخدام.

VB.Net

Dim Element As HtmlElement = NameOfYourWebBrowser.Document.GetElementById("Testtable") Element.Enabled = False

C Sharp

HtmlElement Element = NameOfYourWebBrowser.Document.GetElementById("Testtable"); Element.Enabled = false;

4- Id

تعيد قيمة الخاصية Id أو المعرف، إذا لم يكن للعنصر معرف(Id) ستعيد نص فارغ ("").

VB.Net 

Dim Element As HtmlElement = NameOfYourWebBrowser.Document.GetElementById("Testtable") MsgBox(Element.Id)

C Sharp

HtmlElement Element = NameOfYourWebBrowser.Document.GetElementById("Testtable"); MessageBox.Show(Element.Id);

5- InnerHtml

تعيد نص أو تركيب HTML الموجود داخل(بدون النص الخاص بالعنصر) العنصر.

VB.Net 

Dim Element As HtmlElement = NameOfYourWebBrowser.Document.GetElementById("Testtable") MsgBox(Element.InnerHtml)

C Sharp

HtmlElement Element = NameOfYourWebBrowser.Document.GetElementById("Testtable"); MessageBox.Show(Element.InnerHtml);

6- InnerText

تعيد النصوص الخاصة بالعناصر الموجودة داخل هذا العنصر.

ملاحظة : لا تعيد النص الموجود داخل حقل نص (TextBox) سنذكر في الدروس القادمة إن شاء الله كيفية جلب هذا النص.
VB.Net 

Dim Element As HtmlElement = NameOfYourWebBrowser.Document.GetElementById("Testtable") MsgBox(Element.InnerText)

C Sharp

HtmlElement Element = NameOfYourWebBrowser.Document.GetElementById("Testtable"); MessageBox.Show(Element.InnerText);

7- Name

تعيد إسم العنصر (قيمة الخاصية Name)، إذا لم يكن للعنصر إسم ستعيد نص فارغ ("").
VB.Net

Dim Element As HtmlElement = NameOfYourWebBrowser.Document.GetElementById("Testtable") MsgBox(Element.Name)

C Sharp

HtmlElement Element = NameOfYourWebBrowser.Document.GetElementById("Testtable"); MessageBox.Show(Element.Name);

8- OuterHtml

تعيد نص أو تركيب HTML الخاص بالعنصر.

VB.Net

Dim Element As HtmlElement = NameOfYourWebBrowser.Document.GetElementById("Testtable") MsgBox(Element.OuterHtml)

C Sharp

HtmlElement Element = NameOfYourWebBrowser.Document.GetElementById("Testtable"); MessageBox.Show(Element.OuterHtml);

 9- OuterText

تعيد النص الخاص بالعنصر والعناصر الموجودة بداخل العنصر ☻.

VB.Net

Dim Element As HtmlElement = NameOfYourWebBrowser.Document.GetElementById("Testtable") MsgBox(Element.OuterText)

C Sharp

HtmlElement Element = NameOfYourWebBrowser.Document.GetElementById("Testtable"); MessageBox.Show(Element.OuterText);

10- Parent

تعيد HtmlElement وهو "أب"(العنصر الذي يوجد بداخله العنصر الحالي) العنصر الحالي☻.

VB.Net

Dim Element As HtmlElement = NameOfYourWebBrowser.Document.GetElementById("Testtable") Dim Parent As HtmlElement = Element.Parent

C Sharp

HtmlElement Element = NameOfYourWebBrowser.Document.GetElementById("Testtable"); HtmlElement Parent = Element.Parent;

11- TagName 

تعيد الوسم الخاص بالعنصر.

 VB.Net

Dim Element As HtmlElement = NameOfYourWebBrowser.Document.GetElementById("Testtable") MsgBox(Element.TagName) 

C Sharp

HtmlElement Element = NameOfYourWebBrowser.Document.GetElementById("Testtable"); MessageBox.Show(Element.TagName);

====>Most Important Methods(Functions)<====

1- AppendChild

تقوم بإضافة HtmlElemnt بداخل العنصر.

أو تقوم بإضافة HtmlElement إلى أبناء هذا العنصر.

Parameters :

newElement : العنصر الجديد لإضافته.

VB.Net

Dim Element As HtmlElement = NameOfYourWebBrowser.Document.GetElementById("Testtable").GetElementsByTagName("tbody")(0) Dim Row As HtmlElement = Element.Document.CreateElement("tr") Dim Cell As HtmlElement = Row.Document.CreateElement("th") Cell.InnerText = "The First Cell in the new row" Row.AppendChild(Cell) Element.AppendChild(Row)

C Sharp

HtmlElement Element = NameOfYourWebBrowser.Document.GetElementById("Testtable").GetElementsByTagName("tbody")[0]; HtmlElement Row = Element.Document.CreateElement("tr"); HtmlElement Cell = Row.Document.CreateElement("th"); Cell.InnerText = "The First Cell in the new row"; Row.AppendChild(Cell); Element.AppendChild(Row);

2- AttachEventHandler

تقوم بإضافة "معالج/متعامل" للحدث

يمكنك مشاهدة جميع الأحداث (Events) من خلال الرابط  DOM Events

 Parameters :

1- eventName : إسم الحدث.

2- eventHandler : المعالج او المتعامل مع الحدث (Event Handler).

VB.Net

Dim Element As HtmlElement = NameOfYourWebBrowser.Document.GetElementById("Testtable") Element.AttachEventHandler("ondblclick", New EventHandler(Sub() MsgBox("User Clicked twice on Test Table")))

C Sharp

HtmlElement Element = NameOfYourWebBrowser.Document.GetElementById("Testtable"); Element.AttachEventHandler("ondblclick", (sender1, e1) => MessageBox.Show("User Clicked twice on Test Table"));

4- DetachEventHandler

 تقوم بإزالة "معالج/متعامل" لحدث معين.

هذه الدالة معاكسة للدالة السابقة.

VB.Net

Dim Element As HtmlElement = NameOfYourWebBrowser.Document.GetElementById("Testtable") Element.DetachEventHandler("ondblclick", NameOfEventHandler)

C Sharp

HtmlElement Element = NameOfYourWebBrowser.Document.GetElementById("Testtable"); Element.DetachEventHandler("ondblclick", NameOfEventHandler);

5- Focus

تقوم بتفعيل العنصر.

VB.Net

Dim Element As HtmlElement = NameOfYourWebBrowser.Document.GetElementById("Testtable") Element.Focus()

C Sharp

HtmlElement Element = NameOfYourWebBrowser.Document.GetElementById("Testtable"); Element.Focus();

6- RemoveFocus

تقوم بإزالة التركيز أو تقوم بإلغاء تفعيل العنصر.

VB.Net

Dim Element As HtmlElement = NameOfYourWebBrowser.Document.GetElementById("Testtable") Element.RemoveFocus()

C Sharp

HtmlElement Element = NameOfYourWebBrowser.Document.GetElementById("Testtable"); Element.RemoveFocus();

7- GetAttribute

 تقوم بجلب قيمة الخاصية (الخاصية التي تحددها في المعامل الأول).

 Parameters :

attributeName : إسم الخاصية التي تريد جلب قيمتها (حساسة لحالة الأحرف {كبير، صغير}).

VB.Net

Dim Element As HtmlElement = NameOfYourWebBrowser.Document.GetElementById("Testtable") MsgBox(Element.GetAttribute("border"))

C Sharp

HtmlElement Element = NameOfYourWebBrowser.Document.GetElementById("Testtable"); MessageBox.Show(Element.GetAttribute("border"));

 

8- SetAttribute

تقوم بتحديد/تغيير قيمة الخاصية (الخاصية التي تحددها بالمعامل الأول).

 Parameters :

attributeName : إسم الخاصية التي تريد تغيير قيمتها (حساسة لحالة الأحرف {كبير، صغير}).
value : القيمة الجديدة.

VB.Net

Dim Element As HtmlElement = NameOfYourWebBrowser.Document.GetElementById("Testtable") Element.SetAttribute("border", "5")

C Sharp

HtmlElement Element = NameOfYourWebBrowser.Document.GetElementById("Testtable"); Element.SetAttribute("border", "5");

9- ScrollIntoView

تجعل العنصر هو الأعلى او الآخر في النافذة (ليس بتغيير مكانه بل بتغير مكان الـScrollBar).

  Parameters :

alignWithTop : تحدد إذا ما سيتم جعل العنصر في اعلى الصفحة أو أسفلها.

VB.Net

Dim Element As HtmlElement = NameOfYourWebBrowser.Document.GetElementById("Testtable") Element.ScrollIntoView(False)

C Sharp

HtmlElement Element = NameOfYourWebBrowser.Document.GetElementById("Testtable"); lement.ScrollIntoView(false);

 10 - GetElementsByTagName

تعيد HtmlElementCollection تحتوي على العناصر التي تبدأ بالوسم(تحدده بالمعامل الأول).

يتم البحث في العناصر الموجودة داخل العنصر وليس في الصفحة ☻.

  Parameters :

tagName : الوسم.

 VB.Net

Dim Element As HtmlElement = NameOfYourWebBrowser.Document.GetElementById("Testtable") Dim SearchResult As HtmlElementCollection = Element.GetElementsByTagName("tr")

 C Sharp

HtmlElement Element = NameOfYourWebBrowser.Document.GetElementById("Testtable"); HtmlElementCollection SearchResult = Element.GetElementsByTagName("tr");

11- InvokeMember

تقوم بتنفيذ أمر معين (تحدده في المعامل الأول) على العنصر.
لكل عنصر في لغة HTML الدوال الخاصة به ☻.

Parameters :

methodName : إسم الدالة لتنفيذها.

 VB.Net

Dim Element As HtmlElement = NameOfYourWebBrowser.Document.GetElementById("Testtable") Element.AttachEventHandler("onclick", Sub() MessageBox.Show("Method Invoked Successfully")) Element.InvokeMember("click")

 C Sharp

HtmlElement Element = NameOfYourWebBrowser.Document.GetElementById("Testtable"); Element.AttachEventHandler("onclick", (s1, e1) => MessageBox.Show("Method Invoked Successfully")); Element.InvokeMember("click");

12- InvokeMember

هي "Over-load" للدالة السابقة وتختلف عنها بأن لها معامل ثان لتمرير المعاملات للدالة التي تريد تنفيذها.

Parameters :

methodName : إسم الدالة لتنفيذها.
parameter : المعاملات التي ستمررها للدالة.

 VB.Net

Dim Element As HtmlElement = NameOfYourWebBrowser.Document.GetElementById("Testtable") Element.GetElementsByTagName("tr")(0).InvokeMember("deleteCell", 0)

 C Sharp

HtmlElement Element = NameOfYourWebBrowser.Document.GetElementById("Testtable"); Element.GetElementsByTagName("tr")[0].InvokeMember("deleteCell", 0);

===========================================================

أدوات لتقوم بتجربة الأكواد عليها

المبرمج العربي	المبرمج العربي	شرح أهم خصائص ودوال HtmlElement	المبرمج	العربي
	The Arabian Programmer	HtmlElement most Important properties and Functions	The Arabian	Programmer

=======================================================

في الدرس القادم سنتعرف على أهم الخصائص والدوال في الفصيلة (Class)

GeckoNode

 =======================================================

إن أصبت فمن الله ، وإن اخطئت فمني ومن الشيطان  اترككم في امان الله ورعايته 

والسلام عليكم ورحمة الله وبركاته

DoneByA