QA Partner
Quick Reference
Subsystem
list
Top
level

Built-In 4Test Classes (4.0)

This is a quick reference for the built-in 4Test classes.
Note that PRODUCT scripts should use the "Q Classes" instead of the built-in classes.
See also: UI Shell.

Window Class Tree

AnyWin
    Control 
        CheckBox
        ComboBox
        DataWin
        DWObject
        DynamicText
        Header
        ListBox
        ListView
        PageList
        PopupList
        PushButton
        RadioButton
        RadioList
        Scale
        ScrollBar
            HorizontalScrollBar
            VerticalScrollBar
        StaticText
        StatusBar
        TextField
        ToolBar
        TreeView
        UpDown
    DesktopWin
    Menu
        AppleMenu
        HelpMenu
        MenuItem
        PopupMenu
        SysMenu
    MoveableWin
        ChildWin
        DialogBox
            MessageBoxClass
        MainWin
    CustomWin
    GuptaTable

AgentClass

winclass AgentClass 
        FlushEvents ();
ANYTYPE GetOption (AGENTOPTION Option);
VOID    DisplayMessage (STRING sTitle, STRING sMessage);
ANYTYPE SetOption (AGENTOPTION Option, ANYTYPE aValue);

AnyWin

winclass AnyWin

Methods

VOID             CaptureBitmap (STRING sBitmapName,RECT Rect optional);
                 CaptureText - obsolete, replaced by GetEverything()
VOID             ClearTrap ();
VOID             Click (INTEGER iButton optional, INTEGER x optional, INTEGER y);
VOID             DoubleClick (INTEGER iButton optional, INTEGER x optional, INTEGER y);
BOOLEAN          Exists (NUMBER nTimeout optional);
LIST OF STRING   GenerateDecl ();
INTEGER          GetAppId ();
ANYTYPE          GetArrayProperty (STRING sName, INTEGER iIndex);
INTEGER          GetBitmapCRC (RECT Rect optional, STRING sMaskFile optional);
STRING           GetCaption (BOOLEAN fRawMode optional);
LIST OF WINDOW   GetChildren ();
LIST OF STRING   GetContents (BOOLEAN bRawMode optional);
LIST OF STRING   GetEverything (INTEGER iLevel optional);
INTEGER          GetHandle ();
STRING           GetID ();
INTEGER          GetIndex (ANYTYPE aObsolete optional);
STRING           GetInputLanguage ();
LIST OF PROPINFO GetManyProperties (LIST OF STRING lsProperties optional);
STRING           GetName ()
ANYTYPE          GetParent ();
ANYTYPE          GetProperty (STRING sName);
LIST OF STRING   GetPropertyList ();
RECT             GetRect (BOOLEAN bScreen optional);
ANYTYPE          GetResource (STRING sName);
LIST OF STRING   GetResourceList ();
BOOLEAN          IsActive ();
BOOLEAN          IsArrayProperty (STRING sName);
BOOLEAN          IsDefined (STRING sName)
BOOLEAN          IsEnabled ();
BOOLEAN          IsManaged ();
BOOLEAN          IsOfClass (DATACLASS Class, BOOLEAN fExact optional);
BOOLEAN          IsRealized ();
BOOLEAN          IsViewable ();
BOOLEAN          IsVisible ();
VOID             MoveMouse (INTEGER x optional, INTEGER y);
VOID             MultiClick (INTEGER iCount, INTEGER iButton optional, INTEGER x optional, INTEGER y);
VOID             PopupSelect (INTEGER x, INTEGER y, STRING sItem)
VOID             PressKeys (STRING sKeys, NUMBER nDelay optional);
VOID             PressMouse (INTEGER iButton optional, INTEGER x optional, INTEGER y);
                 Query - obsolete, replaced by GetEverything()
VOID             ReleaseKeys (STRING sKeys, NUMBER nDelay optional);
VOID             ReleaseMouse (INTEGER iButton optional, INTEGER x optional, INTEGER y);
VOID             SetArrayProperty (STRING sName, INTEGER iIndex, ANYTYPE aValue);
VOID             SetProperty (STRING sName, ANYTYPE aValue);
VOID             SetTrap (WNDTAG ButtonTag, INTEGER iExceptNum optional, STRING sExceptData optional);
VOID             TypeKeys (STRING sKeys, NUMBER nDelay optional);
VOID             VerifyActive (BOOLEAN bActive optional)
VOID             VerifyBitmap (STRING sBitmapName,RECT Rect optional, STRING sMaskFile optional);
VOID             VerifyEnabled (BOOLEAN bEnabled optional)
VOID             VerifyEverything (LIST OF STRING lsEverything)
VOID             VerifyProperties (WINPROPTREE WinPropTree)
VOID             VerifyText (STRING sBaseFile)
NUMBER           WaitBitmap (STRING sBitmapName, NUMBER nTimeout,RECT Rect optional, STRING sMaskFile optional);

Properties

bActive
AppId
sCaption
lwChildren
Class
bEnabled
bExists
sID
iIndex
sName
wParent
Rect
hWnd
WndTag

Predefined Window Parts

BottomEdge
BottomLeftCorner
BottomRightCorner
Caption
ClientArea
CloseBox
GrowBox
LeftEdge
MaximizeBox
MenuBar
MinimizeBox
RightEdge
RestoreBox
TopEdge
TopLeftCorner
TopRightCorner

CheckBox

winclass CheckBox : Control

Methods

VOID    Check ();
BOOLEAN GetState ();
BOOLEAN IsChecked ();
VOID    SetState (BOOLEAN bState);
VOID    Toggle ();
VOID    Uncheck ();
VOID    VerifyValue (BOOLEAN bExpectedValue)

Properties

bChecked
bValue

ChildWin

winclass ChildWin : MoveableWin

Methods

VOID Invoke ()

User-Defined Variables

wInvoke

ClipboardClass

winclass ClipboardClass

Methods

LIST OF STRING GetText ();
VOID           SetText (LIST OF STRING lsText optional);

Properties

SetText

ComboBox

winclass ComboBox : Control

Methods

VOID           ClearText ();
INTEGER        FindItem (STRING sItem);
LIST OF STRING GetContents (BOOLEAN bRawMode optional);
INTEGER        GetItemCount ();
STRING         GetItemText (INTEGER iIndex, BOOLEAN bRawMode optional);
INTEGER        GetSelIndex ();
STRING         GetSelText ();
STRING         GetText ();
VOID           Select (LISTITEM Item);
VOID           SetText (STRING sText);
               VerifyContents (LIST OF STRING lsExpectedContents)
               VerifyText (STRING sText)
               VerifyValue (LISTITEM ExpectedValue)

Properties

lsContents
iItemCount
iValue
sValue

Control

winclass Control : AnyWin

Methods

STRING  GetPriorStatic (BOOLEAN fRawMode optional);
BOOLEAN HasFocus ();
VOID    SetFocus ();
        VerifyFocus()

Properties

bHasFocus

Predefined Window Parts

HScrollBar VScrollBar

CursorClass

Note: do not confuse this with the CURSOR data type.

Not supported on Windows NT.

winclass CursorClass 

POINT  GetPosition ();
CURSOR GetType ();
NUMBER Wait (CURSOR cursor, NUMBER nTimeout, NUMBER nNoChange optional);

DesktopWin

winclass DesktopWin : AnyWin 
WINDOW GetActive ();
WINDOW GetFocus ();

DialogBox

winclass DialogBox : MoveableWin

Methods

VOID   Accept ()
VOID   Dismiss ()
WINDOW GetDefaultButton ();
VOID   Invoke ()
VOID   VerifyDefaultButton (WINDOW wButton null)

User-Defined Variables

wAcceptButton
wDismissButton

DynamicText

winclass DynamicText : Control

Methods

STRING GetText (INTEGER iStartChar optional, INTEGER iNumChars optional)
VOID   VerifyValue (STRING sExpectedValue)

Properties

sValue

ListBox

winclass ListBox : Control

Methods

VOID            DoubleSelect (LISTITEM Item);
VOID            ExtendSelect (LISTITEM Item);
INTEGER         FindItem (STRING sItem);
LIST OF STRING  GetContents (BOOLEAN bRawMode optional);
INTEGER         GetItemCount ();
STRING          GetItemText (INTEGER iIndex, BOOLEAN bRawMode optional);
LIST OF INTEGER GetMultiSelIndex ();
LIST OF STRING  GetMultiSelText ();
INTEGER         GetSelIndex ();
STRING          GetSelText ();
BOOLEAN         IsExtendSel ();
BOOLEAN         IsMultiSel ();
VOID            MultiSelect (LISTITEM Item);
VOID            MultiUnselect (LISTITEM Item);
VOID            Select (LISTITEM Item);
VOID            SelectList (LIST OF LISTITEM lItems);
VOID            SelectRange (LISTITEM StartItem, LISTITEM EndItem);
                VerifyContents (LIST OF STRING lsExpectedContents)
                VerifyValue (ANYTYPE aExpectedValue)

Properties

lsContents
bIsExtend
bIsMulti
iItemCount
iValue
liValue
lsValue
sValue

ListView

winclass ListView : Control 
void            DoubleSelect (LISTITEM Item)
void            ExposeItem (LISTITEM Item)
void            ExtendSelect (LISTITEM Item)
INTEGER         FindItem (STRING sItem)
INTEGER         GetColumnCount ()
STRING          GetColumnName (INTEGER iColumn)
LIST OF STRING  GetContents (INTEGER iColumn optional, BOOLEAN bRawMode optional)
INTEGER         GetItemCount ()
RECT            GetItemRect (LISTITEM Item, BOOLEAN bIconRect optional, INTEGER iColumn optional)
STRING          GetItemText (INTEGER iIndex, INTEGER iColumn optional, BOOLEAN bRawMode optional)
LIST OF INTEGER GetMultiSelIndex ()
LIST OF STRING  GetMultiSelText ()
INTEGER         GetSelIndex ()
STRING          GetSelText ()
STRING          GetTitle ()
LVVIEW          GetView ()
BOOLEAN         IsExtendSel ()
BOOLEAN         IsMultiSel ()
void            MultiSelect (LISTITEM Item)
void            MultiUnselect (LISTITEM Item)
void            PressItem (LISTITEM Item, INTEGER iButton optional, INTEGER iXoffset optional, INTEGER iYoffset optional)
void            ReleaseItem (LISTITEM Item, INTEGER iButton optional, INTEGER iXoffset optional, INTEGER iYoffset optional)
void            Select (LISTITEM Item)
void            SelectList (LIST OF LISTITEM lItems)
void            SelectRange (LISTITEM StartItem, LISTITEM EndItem)

MainWin

winclass MainWin : MoveableWin 
VOID           CloseWindows (BOOLEAN fTrace optional)
VOID           Exit (BOOLEAN fTrace optional)
WINDOW         GetActive ();
LIST OF WINDOW GetCloseWindows ();
WINDOW         GetNextCloseWindow ();
VOID           Invoke ()
VOID           Start (STRING sCmdLine);

Menu

winclass Menu : AnyWin

Methods

INTEGER GetItemCount ();
VOID    Pick ();
VOID    TearOff (INTEGER iXPos optional, INTEGER iYPos);
VOID    VerifyContents (LIST OF STRING lsExpectedContents)

Properties

iItemCount

MenuItem

winclass MenuItem : Menu

Methods

VOID    Check ();
BOOLEAN IsChecked ();
VOID    Pick ();
VOID    Uncheck ();
VOID    VerifyChecked (BOOLEAN bChecked optional)

Properties

bChecked

MoveableWin

winclass MoveableWin : AnyWin 
         Close (BOOLEAN fCloseConfirm optional)
WINDOW   GetFocus ();
WINSTATE GetState ();
VOID     Maximize ();
VOID     Minimize ();
VOID     Move (INTEGER x, INTEGER y);
VOID     Restore ();
VOID     SetActive ();
VOID     Size (INTEGER x, INTEGER y);
         VerifyCaption (STRING sCaption)
         VerifyContents (LIST OF STRING lsContents)
         VerifyFocus (WINDOW wFocus null)

PageList

winclass PageList : Control

Methods

INTEGER        FindPage (STRING sPage)
LIST OF STRING GetContents (BOOLEAN bRawMode optional)
INTEGER        GetPageCount ()
STRING         GetPageName (INTEGER iIndex, BOOLEAN bRawMode optional)
INTEGER        GetSelIndex ()
STRING         GetSelText ()
STRING         GetStatusLine ()
BOOLEAN        HasSubPages ()
void           Select (LISTITEM liPage)

Properties

lsContents
bHasSubPages
iPageCount
iValue
sValue

PopupList

winclass PopupList : Control

Methods

INTEGER        FindItem (STRING sItem);
LIST OF STRING GetContents (BOOLEAN bRawMode optional);
INTEGER        GetItemCount ();
STRING         GetItemText (INTEGER iIndex, BOOLEAN bRawMode optional);
INTEGER        GetSelIndex ();
STRING         GetSelText ();
VOID           Select (LISTITEM Item);
               VerifyContents (LIST OF STRING lsExpectedContents)
               VerifyValue (LISTITEM ExpectedValue)

Properties

lsContents
iItemCount
iValue
sValue

PushButton

winclass PushButton : Control 
BOOLEAN IsIndeterminate () 
BOOLEAN IsPressed ()

RadioButton

winclass RadioButton : Control

Methods

INTEGER GetChoice ()
BOOLEAN GetState (INTEGER iChoice optional)
void    SetChoice (INTEGER iChoice optional)

Properties

bValue
iValue

RadioList

winclass RadioList : Control

Methods

INTEGER        FindItem (STRING sItem);
LIST OF STRING GetContents (BOOLEAN bRawMode optional);
INTEGER        GetItemCount ();
STRING         GetItemText (INTEGER iIndex, BOOLEAN bRawMode optional);
INTEGER        GetSelIndex ();
STRING         GetSelText ();
VOID           Select (LISTITEM Item);
               VerifyContents (LIST OF STRING lsExpectedContents)
               VerifyValue (LISTITEM ExpectedValue)

Properties

lsContents
iItemCount
iValue
sValue

Scale

winclass Scale : Control

Methods

NUMBER   GetPosition ();
SCLRANGE GetRange ();
VOID     SetPosition (NUMBER nPosition);
VOID     SetToMax ();
VOID     SetToMin ();
         VerifyValue (NUMBER nExpectedValue)

Properties

Range
iValue
rValue

ScrollBar

winclass ScrollBar : Control

Methods

        GetPageSize
INTEGER GetPosition ();
SBRANGE GetRange ();
VOID    ScrollByLine (INTEGER iAmount);
VOID    ScrollByPage (INTEGER iAmount);
VOID    ScrollToMax ();
VOID    ScrollToMin ();
VOID    SetPosition (INTEGER iPosition);
NUMBER  TimeAutoScroll (INTEGER iAmount, NUMBER nTimeout);
VOID    VerifyPageSize (INTEGER iExpectedPageSize)
VOID    VerifyRange (SBRANGE Range)
VOID    VerifyValue (INTEGER iExpectedValue)

Properties

iPageSize
Range
iValue

StaticText

winclass StaticText : Control

Methods

STRING GetText (INTEGER iStartChar optional, INTEGER iNumChars optional);
       VerifyValue (STRING sExpectedValue)

Properties

sValue

TextField

winclass TextField : Control

Methods

VOID           ClearText ();
STRING         GetFontName (INTEGER iLine optional, INTEGER iCol)
INTEGER        GetFontSize (INTEGER iLine optional, INTEGER iCol)
LIST OF STRING GetMultiSelText ();
LIST OF STRING GetMultiText (INTEGER iStartLine optional, INTEGER iNumLines optional);
TEXTPOS        GetPosition ();
TEXTRANGE      GetSelRange ();
STRING         GetSelText ();
STRING         GetText (INTEGER iStartChar optional, INTEGER iNumChars optional);
BOOLEAN        IsBold (INTEGER iLine optional, INTEGER iCol)
BOOLEAN        IsItalic (INTEGER iLine optional, INTEGER iCol)
BOOLEAN        IsMultiText ();
BOOLEAN        IsRichText ()
BOOLEAN        IsUnderline (INTEGER iLine optional, INTEGER iCol)
VOID           SetMultiText (LIST OF STRING sText, INTEGER iStartLine optional, INTEGER iNumLines optional);
VOID           SetPosition (INTEGER iLine, INTEGER iCol);
VOID           SetSelRange (INTEGER iStartLine, INTEGER iStartCol, INTEGER iEndLine, INTEGER iEndCol);
VOID           SetText (STRING sText, INTEGER iStartChar optional, INTEGER iNumChars optional);
               VerifyPosition (TEXTPOS ExpectedPos)
               VerifySelRange (TEXTRANGE ExpectedRange)
               VerifySelText (ANYTYPE aExpectedValue)
               VerifyValue (ANYTYPE aExpectedValue)

Properties

bIsMulti
lsValue
sValue

TreeView

winclass TreeView : Control

Methods

void            Collapse (LISTITEM Item)
void            DoubleSelect (LISTITEM Item)
void            Expand (LISTITEM Item)
void            ExposeItem (LISTITEM Item)
void            ExtendSelect (LISTITEM Item)
INTEGER         FindItem (STRING sItem)
LIST OF STRING  GetContents (BOOLEAN bRawMode optional)
INTEGER         GetItemCount (BOOLEAN bAllItems optional)
INTEGER         GetItemLevel (LISTITEM Item)
RECT            GetItemRect (LISTITEM Item, BOOLEAN bIconRect optional)
STRING          GetItemText (INTEGER iIndex, BOOLEAN bRawMode optional)
LIST OF INTEGER GetMultiSelIndex ()
LIST OF STRING  GetMultiSelText ()
INTEGER         GetSelIndex ()
STRING          GetSelText ()
INTEGER         GetSubItemCount (LISTITEM Item)
LIST OF STRING  GetSubItems (LISTITEM Item)
TVVIEW          GetView ()
BOOLEAN         IsExtendSel ()
BOOLEAN         IsItemEditable (LISTITEM Item)
BOOLEAN         IsItemExpandable (LISTITEM Item)
BOOLEAN         IsItemExpanded (LISTITEM Item)
BOOLEAN         IsMultiSel ()
void            MultiSelect (LISTITEM Item)
void            MultiUnselect (LISTITEM Item)
void            PressItem (LISTITEM Item, INTEGER iButton optional, INTEGER iXoffset optional, INTEGER iYoffset optional)
void            ReleaseItem (LISTITEM Item, INTEGER iButton optional, INTEGER iXoffset optional, INTEGER iYoffset optional)
void            Select (LISTITEM Item)
void            SelectList (LIST OF LISTITEM lsItems)

Properties

lsContents
iItemCount
iValue
sValue

UpDown

winclass UpDown : Control

Methods

void    Decrement (INTEGER iSteps optional)
INTEGER GetPosition ()
SBRANGE GetRange ()
void    Increment (INTEGER iSteps optional)
void    SetPosition (INTEGER iPosition)
void    SetToMax ()
void    SetToMin ()

Properties

Range
iValue
sValue


This page is maintained by (REMOVED).

Last updated 22 August 1997.

Source Management using