QTP中对象的常见属和方法-km.doc

QTP中对象的常见属性和方法 测试管理部 康淼QTP中对象的常见属性和方法1常见属性 Exist语法object.Exsit(TimeOut)用途描述用于检查某个特定对象在目前的应用中是否存在。参数描述1) 参数object，表示某特定的对象，比如浏览器对象Browser，对话框对象dialog等。2) 参数TimeOut，为可选参数，单位为毫秒。如果设定为大于0的值，那么QTP判断一个对象是否存在的过程就以这个时间值作为时间限制。返回值类型只读。布尔值。用法举例语句：Browser(Window_name).Exist作用：用于判断浏览器对象中名称为Window_name的窗口对象是否存在 Object语法object.Object用途描述用于访问浏览器对象的内部方法和属性。参数描述参数object，为浏览器对象类型的一个测试对象返回值类型只读。对象类型。用法举例语句：Set MyWebEdit = Browser(Mercury Tours).Page(Mercury Tours).WebEdit(username).Object MyWebEdit.focus作用：由于focus是WebEdit对象的内部方法，而不是QTP对象的方法，所以要通过Object属性来访问。2 常见方法 CaptureBitmap语法object.CaptureBitmap FullFileName, OverrideExisting用途描述用于将屏幕截图存为.bmp或者.png类型的图像文件参数描述1) FullFileName，为必要参数，.bmp或者.png图像文件存储的完整路径。如果写的是相当路径，那么就存在QTP的结果文件目录下。2) OverrideExistin，为可选参数，为一个布尔值。为False(默认)的表示如果截取的图像文件已经在结果文件目录下了，该图像文件不被覆盖。为True则表示覆盖返回值类型无返回值用法举例语句：Browser(Mercury Tours).Page(Find Flights).WebEdit(numPassengers).CaptureBitmap C:ScreenCapsedit_4.bmp, True作用：将名称为numPassengers的WebEdit对象存为文件名为edit_4.bmp的图像文件，路径为C:ScreenCapsedit_4.bmp，如果已经有这样一个文件，那么，覆盖原来的文件 CheckProperty语法object.CheckProperty (PropertyName, PropertyValue, TimeOut)用途描述用于检查对象的某个属性是否(在规定的时间内)被赋给了某个特定的值。参数描述1) PropertyName，必要参数，被检查的对象属性的名称。2) PropertyValue，必要参数，被检查对象属性应该被赋给的值。3) TimeOut，可选参数，这个检查操作的时间限制返回值类型为一个布尔值。返回值为真表示被测属性(在规定的时间内)被赋给了特定的值，否则返回值为假。用法举例语句：Browser(Nested Lists).Page(Page).WebEdit(Name).Set Mercury Browser(Nested Lists).Page(Page).WebEdit(Name).CheckProperty value, Mercury作用：用于检查Name对象的value属性是否已经被赋给了Mercury这样的值。 ChildObjects语法object.ChildObjects (Description)用途描述得到目前对象的所有子对象的集合。参数描述1) object，为浏览器对象类型的一个测试对象2) Description，可选参数，是一个Properties object的集合返回值类型为对象的集合。用法举例语句：Set oDesc = Description.Create() oDesc(micclass).Value = WebList Set Lists = Browser(Mercury Interactive).Page(Mercury Interactive).ChildObjects(oDesc) NumberOfLists = Lists.Count() For i = 0 To NumberOfLists - 1 Lists(i).Select i + 1 Next作用：查找并返回页面上的所有List对象。 Click语法object.Click X, Y, BUTTON用途描述点击一个对象。参数描述1) object，被点击的对象2) X, Y，可选参数，表示被点击的位置距被点击对象的左上角的相对横坐标和纵坐标，默认值为对象的中间3) Button，可选参数，0表示鼠标左键，1表示鼠标右键，2表示鼠标中键返回值类型无用法举例语句：Browser(Mercury Tours).Dialog(Internet Options).Click 47, 131, 1作用：用鼠标左键点击名称为”Internet Options”的对话框。 FireEvent语法object.FireEvent EventName, X, Y, BUTTON用途描述触发一个事件。参数描述1) object，被触发事件的对象2) EventName，必要参数，一个字符串，触发的事件的名字，包括：onchange, onclick, ondblclick, onblur, onfocus, onmousedown, onmouseup, onmouseover, onmouseout, onsubmit, onreset, onpropertychange3) X, Y，可选参数，表示被点击的位置距被点击对象的左上角的相对横坐标和纵坐标，默认值为对象的中间4) Button，可选参数，0表示鼠标左键，1表示鼠标右键，2表示鼠标中键返回值类型无用法举例语句：Browser(Mercury Technologies).page(Mercury Technologies).Link(Jobs).FireEvent onclick作用：触发名称为”Jobs”的Link对象的onclick事件。 GetROProperty语法object.GetROProperty (Property, PropertyData)用途描述从当前应用的对象中返回测试对象的属性当前值。参数描述1) object，当前对象类型的一个测试对象。2) Property，必要参数，一个字符串，需要从当前对象得到的属性的名字。3) PropertyData，可选参数，一个变量值，目前已经不使用。返回值类型一个变量值用法举例语句：Val = Browser(Mercury Tours).Page(Find Flights).WebCheckBox(roundtrip).GetROProperty(Value)作用：得到名称为”roundtrip”的Check Box对象的当前值 GetTOProperties语法object.GetTOProperties用途描述返回一个属性值的集合，用于标志一个对象。参数描述1) object，当前对象类型的一个测试对象。返回值类型一个对象。用法举例语句：Set TableDesc = Browser(Mercury Tours).Page(Method of Payment).WebTable(FirstName).GetTOProperties作用：得到用于标识名称为”FirstName”的WebTable对象的属性值的集合 GetTOProperty语法object.GetTOProperty (Property)用途描述返回测试对象的特定属性的值。参数描述1) object，当前对象类型的一个测试对象。2) Property，必要参数，一个字符串，用于标识需要返回值的属性。返回值类型一个变量值。用法举例语句：TableTag = Browser(Mercury Tours).Page(Method of Payment).WebTable(FirstName).GetTOProperty(HtmlTag)作用：用于HTMLTag属性的值。 Set语法object.Set text, position, 用途描述设定某些特定对象的特定属性的值。参数描述1) object，当前对象类型的一个测试对象。2) text, position，必要参数，表示文本框的文本值，滚动条的位置等。返回值类型无用法举例语句：Browser(Mercury Tours).page(Find Flights).WebEdit(numPassengers).Set 4作用：在名称为”numPassengers”的WebEdit对象中设置文本的值为字符串”4” SetSecure语法object.SetSecure EncryptedText用途描述在输入框内输入加密的文本内容参数描述1) object，当前输入框类型的一个测试对象。2) EncryptedText，必要参数，一个字符串，在输入区域内希望输入的加密的文本内容。返回值类型无用法举例语句：Browser(Mercury Tours).page(Mercury Tours).WebEdit(username).Set mercury Browser(Mercury Tours).page(Mercury Tours).WebEdit(password).SetSecure 38cf389da9621eb4822cd7作用：对Set和SetSecure进行比较，在名称为”username”的WebEdit对象处设定值为”mercury”，在名称为”password”的WebEdit对象处设定值为” 38cf389da9621eb4822cd7”，不过此文本是加密的，对用户不可见。 SetTOProperty语法object.SetTOProperty Property, Value用途描述设定测试对象的特定属性的值。参数描述1) object，当前对象类型的一个测试对象。2) Property，必要参数，一个字符串，用于标识需要设定的属性。3) Value，必要参数，期望设定的属性值。返回值类型无用法举例语句：Browser(New Page).Page(New Page).WebElement(just text).SetTOProperty Style, color:blue作用：设定名称”just text”的WebElement对象的”Style”属性的值为”color:blue” Submit语法object.Submit用途描述提交一个表单。参数描述1) object，当前对象类型的一个测试对象。返回值类型无用法举例语句：Browser(Web Testing).page(Mercury Tours).WebElement(username).Submit作用：提交一个表单 ToString语法object.ToString用途描述返回一个代表当前对象的字符串。参数描述1) object，当前对象类型的一个测试对象。返回值类型一个字符串。当前对象的名字以及其所属对象的类的名字，比如MyButton Webbutton用法举例语句：Dim fso, ResultFile, oDesc Set oDesc = Description.Create oDesc(Class Name).Value = Link Set oLinkCollection = Browser(Simple XML Example from).Page(Simple Web Example).ChildObjects(oDesc) Set fso = CreateObject(Scripting.FileSystemObject) Set ResultFile = fso.OpenTextFile(c:Links.txt, 2, True) 2 = Open file for writing For i = 0 To oLinkCollection.Count - 1 ResultFile.Write oLinkCollection.Item(i).ToString & vbNewLine Next ResultFile.Closet作用：将一个链接的列表中的链接名称存到文件中 WaitProperty语法object.WaitProperty (PropertyName, PropertyValue, TimeOut)用途描述执行一个等待的过程，直到指定的属性取得特定值，或者达到规定的超时时间限制。参数描述1) object，当前对象类型的一个测试对象。2) PropertyName，必要参数，指定的属性的名称3) PropertyValue，必要参数，指定的属性希望取得的属性值4) TimeOut，可选参数，