[jawsscripts] Re: Find Graphic Question

  • From: "David Farough" <David.Farough@xxxxxxxxxxxxx>
  • To: <jawsscripts@xxxxxxxxxxxxx>
  • Date: Mon, 01 Dec 2008 13:58:15 -0500

Hi Mark:

If you look in the Windowsmail.jsm file you will see the following
constant definitions.

;the following string should be translated from default.jgf
scCheckMark = "check mark",  ;graphic label for marlett97, marlett98
scCorner = "corner",  ;graphic label for marlett99, marlett100,
marlett101, marlett102
cscAttachmentsRemoved="unsafe attachment",
scSearchResultsList="FTSearch",


scCorner and scCheckMark are constants which define the way that the
graphics that represent the check mark and the unchecked graphics have
been labelled in the default.jgf file.

The first parameter was the handle for the window where the search is
to be performed, the second parameter is the label of the graphic to be
searched for.


find below the description for FindGraphic taken from the fsdn
document.
Function: FindGraphic 
Description 
FindGraphic searches for a graphic in the specified window. If the
graphic is found, then the JAWS cursor is placed on it. The graphic must
have a text label associated with it because the FindGraphic function
searches for text labels. Text labels are assigned by the Graphics
Labeler. 

Returns 
Type: Int
Description: "WAS_SUCCESSFUL" = 1, "WAS_NOT_SUCCESSFUL" = 0.


Parameters 
Param 1: 
Type: Handle
Description: Specify a window handle. Type the name of a variable or
choose a script function that indicates the window that is to be
searched.
Include: Required


Param 2: 
Type: String
Description: Type the graphic label that is to be located. The label
must be typed exactly as it appears in the graphic label file. Enclose
the graphic label within quotation marks.
Include: Required


Param 3: 
Type: Int
Description: Indicate the search direction. Type a constant value to
indicate the starting point for the search: S_TOP or S_BOTTOM.
Include: Required


Param 4: 
Type: Int
Description: Indicate search restriction. Type the name of a constant
value to indicate whether the search should be restricted to the active
window or it should extend into all child windows of the active
application. Type S_UNRESTRICTED to search all application windows or
S_RESTRICTED to limit the search to the active child window.
Include: Required


Version 
This function is available in the following releases: 

PAC Mate 1.10 and later 
JAWS 4.51 and later 
Magic 10.5 and later 


David Farough
Application Accessibility Coordinator/coordonateur de l'accessibilité 
Information Technology Services Directorate /
Direction des services d'information technologiques
Public Service Commission / Commission de la fonction publique
Email / Courriel:  David.Farough@xxxxxxxxxxxxx
Tel. / Tél:    (613) 992-2779 

>>> "Mark" <torgersonenator@xxxxxxxxx> 01:33 pm Monday, December 01,
2008 >>>
Hi
     I am trying to understand the find Graphic command. In the example
below from the windows mail scripts, what does (hWnd,scCorner mean? 

If FindGraphic(hWnd,scCorner,s_top,s_restricted) then

let sState = msgNotChecked

ElIf FindGraphic(hWnd,scCheckMark,s_top,s_restricted) then

let sState = MSGChecked

EndIf

     Thank you.

__________ 
Visit and contribute to The JAWS Script Repository http://jawsscripts.com

View the list's information and change your settings at 
http://www.freelists.org/list/jawsscripts

Other related posts: