SilkTest Extension Kit for .NET
By:
This manual provides all the information you need to work effectively with the
SilkTest Extension Kit for .NET.
Planning the extension
The Infragistics UltraWinToolbars application is not part of the SilkTest
installer. You must download a trial version from http://
www.infragistics.com. This tutorial supports any version of the
UltraWinToolbars application. You may have to update the project file for
your version.
This tutorial was built using Microsoft’s 1.1 .NET Framework
Procedure To support your version of the Ultrawin toolbar
1 Open the project file (infra_toolbar.vcproj) using a text editor. If you
open it using Microsoft’s Visual Studio .NET, you may receive an error
message that 'Project <project> failed to open'. The project file is
provided in the Extension Kit directory under
ekwin32\tutorial\dotnet\infra_toolbar.
2 Update the references to the version of the Ultrawin toolbar. The
references are contained in the <AssemblyReference> tags within the
<References> tag, and refer to Infragistics DLLs:
3 Open the project in Microsoft’s Visual Studio .NET and rebuild the .dll.
Infragistics UltraWinToolbars sample application
The Infragistics UltraWinToolbars sample application and the Extension Kit
DLL must be built using the same version of Microsoft’s .NET FrameWork.
The Extension Kit DLL example was built using Microsoft’s 1.1 .NET
Framework, so you must make sure that the Infragistics UltraWinToolbars
sample application is also built with the 1.1 version of the Framework. If the
Framework versions differ, the LoadLibrary() call, which SilkTest uses to
map the DLL module into the address space of the .NET application, will
fail. See the “LoadLibrary” online help topic for more information.
The application contains multiple toolbars that contain three powerful
components that enable you to build rich user interfaces in your applications.
The UltraWinToolbars component is designed to display and manage
Microsoft Office style toolbars and menus. It also has an enhanced status bar
component plus a dockable windows component which makes it easy to add
a Microsoft Visual Studio.NET style dockable, tabbed windows interface to
your application.
The Toolbar window contains multiple toolbars that contain different
UIElements.
To familiarize yourself with the Infragistic UltraWinToolbars application:
1 Download the trial version of the UltraWinToolbars application from
http://www.infragistics.com.
2 Start the UltraWinToolbars application.
3 Click on some of the toolbar objects.
What to test
To test the application, you need to perform actions and retrieve information
that a user might perform or retrieve manually. A few examples are:
• Click on a toolbar button.
• Retrieve the names of the items in the specified toolbar.
• Retrieve the number of items in the toolbar.
Add a method: GetCount
In this tutorial, you will write an extension to retrieve the number of items in
the toolbar. This extension supports a new 4Test method which you will
name GetCount. This method takes no arguments, and it returns an integer
which is the number of objects in the toolbar.
Writing a 4Test include file
A complete extension consists of external functions written in C and
declarations for the corresponding 4Test methods in a 4Test include file. The
4Test include file enables your 4Test scripts to call these external functions asmethods to your custom class.
Writing a window class definition
You need to write a window class definition for the UltraWinToolbar sample
that contains the new class methods that your extension implements. The
simplest way to define a window class is to derive it from an existing class.
The UltraWinToolbar window is similar to the existing CustomWin class, so
you should derive your custom class from that.
Procedure To write a window class definition:
1 Start SilkTest (if it is not already running).
2 Open a new 4Test include file in the editor window.
3 Type the following into the include file:
winclass UltraWinToolbar : CustomWin
extern integer GetCount()
This declaration defines a class called UltraWinToolbar, which is derived
from the built-in 4Test class CustomWin. It inherits all of the methods
and properties of the CustomWin class, plus any methods that you add.
The GetCount function is declared inside the window class definition
using the extern keyword. The extern keyword indicates to 4Test that the
function is implemented in an external extension rather than in a 4Test
script.
4 Save this file as UltraWinToolbar.inc and minimize SilkTest.
Example
For a more advanced example of an extension for the UltraWinToolbar class
that includes window declarations and a testcase for the sample application,
see the test script 'infratoolbar.t' that is provided in the
ekwin32\tutorial\dotnet\infra_toolbar directory in your Extension Kit
directory.
Understanding the UltraWinToolbar project
The “assist” library allows your extension to communicate with the SilkTest
Agent. You need to link this library with your C or C++ project.
Preparing to write the extension
SilkTest comes with a header file that contains function prototypes for
SilkTest functions, data structures that will be used by your extension
functions, and some useful macros. To see the header file:
1 Open segUltraToolbar.cpp in the ekwin32\tutorial\dotnet\infra_toolbar
directory in your Extension Kit directory.
2 The header file information is placed below the comment /*** include
EK header files here ***/. In this case, you see:
#include "qapwinek.h"
Preparing to build the extension
The “assist” library comes set up to communicate with the Agent and with
include directories. To see how this is set up:
1 Open the project file using Microsoft’s Visual Studio .NET. The project
file is provided in the Extension Kit directory under
ekwin32\tutorial\dotnet\infra_toolbar.
2 Select Project/Properties from the main menu bar.
3 Select Linker/Input from the tree view in the Property Pages dialog and
find the line “Additional Dependecies”. The assist.lib file is listed below
that in the format:
“$(SEGUE_HOME)\ekwin32\assist.lib”
4 Select C/C++ from the tree view in the Property Pages dialog and find
the line “Additional Include Directories”. You will see Infragistics’
include directory listed in the format:
“$(SEGUE_HOME)\ekwin32”
5 Save and close the project file.
Full article...
Other Resource
... to read more articles, visit http://sqa.fyicenter.com/art/
|