QTP Tutorial #14 – How to Add Bitmap and Text Checkpoints in QTP Tests

Let us just continue our journey of familiarizing ourselves with the important QTP concept of adding checkpoints in today’s QTP tutorial too. In our previous tutorial, we learned how to add Standard and Image checkpoints in QTP tests.

In today’s QTP training session we will learn how to insert Bitmap and Text Checkpoints in QTP tests.

=> Click Here For QTP Training Tutorials Series

Add Bitmap and Text Checkpoints

Bitmap Checkpoint

A lot can be inferred from the name of the checkpoint itself.  However, it is often confused with the Image checkpoint.

Differences between Image and Bitmap Checkpoints:

Difference #1: Image checkpoint works only on the Web environment whereas Bitmap checkpoint works on any supported environments.

Difference #2: Bitmap checkpoint can be used to compare an area of an application or page, an object, or any part of an object. On setting this checkpoint, it captures the chosen portion of the screen as a bitmap and compares it with the result at runtime. In contrast, image checkpoints are just for web image objects.

Therefore, the Bitmap checkpoint captures the visible parts of your AUT and compares them as bitmaps, pixel by pixel. Typically this is used to check maps, logos, or any other diagrams in your AUT.

A couple of important points to remember:

  • Bitmap checkpoints are dependent on factors like screen resolution, Operating systems, and RGB settings. So any changes to any of these factors will cause the checkpoint to fail.
  • When creating the checkpoint, QTP does not record any part that is scrolled off the screen or hidden by any other object.
  • While capturing the bitmap if another app is overlapping your AUT then that part of the screen is also captured.
  • It can be added while recording or from the active screen.

For example, I want to create a bitmap checkpoint on the www.gmail.com page’s Google icon.

I start a test with a record and run settings set in a way that opens www.gmail.com on internet explorer when I record the test. Then I select Insert -> Checkpoint -> Bit map checkpoint. Then I select the ‘google’ logo on the www.gmail page and the following dialog will open up.

QTP Bitmap checkpoint

Take a closer look at the above window.

#1) The image appears in the Bitmap checkpoint properties dialog and then the user has an option to choose either to check for the entire image or choose a selection.

#2) If you check on the ‘Check only selected area’ option to be ON, then you will be able to select the portion of the image. Since it is hard to represent it pictorially, I would suggest the readers give it a try practically to see how this works.

#3) The other options on the screen are basically the fine-tuning properties. They are really there to make sure that the checkpoint passes even though certain RGB or pixels are a little inconsistent.

  • RGB Tolerance: Once set, this value will determine how many RGB values of the pixels can be different for the checkpoint to not fail.
  • Pixel Tolerance: When this option is checked on, the user has to select whether he wants to specify this value in % or a number. For example, if the user chooses 5 pixels and the image has 1000 pixels.  If in run time, up to 5 different pixels the differences are not counted towards failing the checkpoint. If more than 5 differences exist, only then the checkpoint fails.  If both RBG tolerance and Pixel tolerance values are set, then RGB tolerance is calculated first.

#4) There is also a timeout factor that we talked about earlier in the previous tutorial.

I will go ahead and choose a portion of the logo and click OK.

The following statement is generated in the Expert view:

 Browser("Gmail: Email from Google").Page("Gmail: Email from Google").Image("Google").Check CheckPoint("Google") 

Keyword view looks like this:

QTP Bitmap checkpoint

  • If there is a difference in the image in runtime, the checkpoint fails and the two images (one saved, one that came up during runtime) are displayed in the test results.
  • This feature can be configured from Tools -> Options -> Run -> Screen capture

QTP Bitmap checkpoint

Once the Bitmap checkpoint is created, it can be edited later on from the checkpoint properties screen. This dialog can be launched from the Keyword view, expert view, or the Object Repository.

Text Checkpoint

There will be many instances during the testing process when the text displayed in the AUT will have to be checked.  ‘Text’ in this context refers to a text string.

One way of doing that is by using a standard checkpoint and checking the “text” property of an object. Let us give that a try. Again, I will open www.gmail.com and check the text that is displayed in the “Check Account” button or link.

I would choose to insert a standard checkpoint from the menu and set the following details:

QTP Text Checkpoint

The statement that it inserts is:

 Browser("Gmail: Email from Google").Page("Gmail: Email from Google").Link("Create an account").Check CheckPoint("Create an account") 

However, QTP provides specific checkpoints to achieve these.

Text Checkpoint: We will use the same example and see how a Text Checkpoint is different from inserting a standard checkpoint over the ‘text’ property.

I chose “Insert -> Checkpoint -> Text checkpoint” from the menu while recording on the gmail.com page in internet explorer.

The following dialog will be displayed:

QTP Text Checkpoint

Let us look at each field in this dialog and understand what role will each value we set in this dialog will play in our checkpoint.

#1) Name: By default a checkpoint’s name is the object’s name on which a checkpoint is placed. The user can change it if required.

#2) Class: Specifies the type of the object. This is non-editable.

#3) Checkpoint Summary: An understandable explanation of what this checkpoint does.

  • For web applications, it displays the text that is within the object in red. Refer to the dialog above.
  • For a windows application, it displays the text you selected while creating the checkpoint.
  • Also for a windows application if you selected a text that is more than one line, then the summary area displays [Complex value].

Let us look at it as an example. Open the notepad application. First, let us try with one line of text. I will just write a test in the entire notepad, insert a text checkpoint and click on the text in the notepad.

The following is how this dialog appears:

QTP Text Checkpoint

Now, I will insert two lines of text i.e. test and test 1 in two lines. Look at how this text appears in the Checkpoint summary.

QTP Text Checkpoint

#4) You can configure the text to specify what is the “Text before”, “Text after” and “Checked Text”.

For instance, if I need to see if a “test” appears in the notepad before ‘test1’ and the same can be specified by clicking on the ‘Configure’ button above.

The following dialog opens up:

QTP Text Checkpoint

#5) The next options are to parameterize and to set the rules for comparison. They are pretty much self-explanatory.

A checkpoint statement is inserted into the test once the user sets all the options and clicks OK:

  • Text checkpoints can be added while recording, editing, or from the active screen.
  • Once created, all properties can be modified from the checkpoint property window that can be accessed from keyword view, expert view, or OR.
  • Text checkpoints work in most environments, unlike text area checkpoints that work only in a windows environment. We will get to it next time.
  • In case QTP cannot retrieve the text directly from an object in cases when it is handwritten stuff that is scanned and put as an image, it employs OCR to identify the text.

As always, please feel free to post questions and comments. We will continue with checkpoints in the next article as well.

=> Visit Here For QTP Training Tutorials Series

Recommended Reading

8 thoughts on “QTP Tutorial #14 – How to Add Bitmap and Text Checkpoints in QTP Tests”

  1. Hi. This is really good tutorial. I have few doubts of image and bitmap checkpoints. If you could answer that would be great.

    1) Which checkpoint (image or bitmap) need to be used to check type of a image file?

    2) Which checkpoint can be used to check part of a image from source to destination?

  2. @Ravindra: 1. If its an image file in the webpage you would go with Image checkpoint
    2. For checking a part of an image, bitmap checkpoint is the way to go.

  3. thanks for clearing the difference between image and bitmap checkpoints

  4. can any one send the link to download QTP 11.0 full version……

    pcs06@hotmail.co.uk this is my mail id

  5. i am a newbiee to QTP, and trying to learn it through online resources. I came across this wonderful site explainig the concepts in detail with relevant examples.

    while trying to work out with the above mentioned text checkpoint, i.e., trying to select the ‘Create an account’ button object, the QP is throwing the error as below:

    Logical Name:Gmail:Email from Google

    Cannot create Text checkpoint
    cannot retrieve text for this object

    Can you please let me know why this error is popping up everytime i try to select the button.Awaiting your response

  6. Hi Teena,

    Even I encountered a similar error while inserting standard checkpoint while QTP is in recording mode. I stopped recording and then resumed with inserting the checkpoint and then it worked fine.

  7. Thanks much for your descriptive ideas and thoughts.

  8. ‘SystemUtil.Run”C:\Program Files\HP\Unified Functional Testing\samples\flight\app\flight4a.exe”
    Dialog(“text:=Login”).WinEdit(“attached text:=Agent Name:”).Set “Nilesh”
    Dialog(“text:=Login”).WinEdit(“attached text:=Password:”).Set “mercury”
    Wait 6
    ‘Create location to save file with image extension .bmp
    path_error_file = “C:\Documents and Settings\Nilesh\Desktop\nil.bmp”
    ‘Specify Screenshot name
    nName = “ScreenShot”
    Desktop.CaptureBitmap path_error_file,True
    ExlFormula = “=HYPERLINK(“&chr(34)&path_error_file&chr(34)&”,”&chr(34)&nName&chr(34)&”)”
    Set Excel = createobject(“Excel.Application”)
    ‘Create excel sheet with name c:\MyExcel.xls
    Set oBook = Excel.Workbooks.Open (“c:\MyExcel.xls”)
    oBook.ActiveSheet.cells(1,1).Formula = ExlFormula
    Window(“text:=Flight Reservation”).Close



Leave a Comment