QQ登录

只需要一步,快速开始

 注册地址  找回密码
查看: 5830|回复: 1
打印 上一主题 下一主题

MS Active Accessibility 接口技术编程尝试

[复制链接]
字体大小: 正常 放大
韩冰        

823

主题

3

听众

4048

积分

我的地盘我做主

该用户从未签到

发帖功臣 元老勋章

跳转到指定楼层
1#
发表于 2004-11-21 15:21 |只看该作者 |倒序浏览
|招呼Ta 关注Ta
<TABLE cellSpacing=0 cellPadding=0 width="100%" align=center border=0>" ?5 i& [" J" z# n( }2 b

; V" U4 s3 I# L9 f8 W& y<TR>0 O; f8 Z+ j" U1 ?
<TD align=left width="83%" bgColor=#efefef>文章标题:<B>MS Active Accessibility 接口技术编程尝试</B>
1 L6 f/ \2 w3 {  j2 o5 |原 作 者:崔传凯
8 O( m9 E4 C) l' X' G原 出 处:vckbase
! @) Q4 u/ b5 ^发 布 者:loose_went
" O) O) @7 U3 q7 A8 ]% w发布类型:转载( h% V3 x1 Z7 h; s. f
发布日期:2004-11-12
. i0 `5 B6 W& G" q今日浏览:6$ `8 w2 w7 H$ r* p
总 浏 览:234
  e! \" `2 ~4 E% l</TD>+ d( m; }( w: K( w# x0 P: N, n
<TD vAlign=bottom align=left width="15%" bgColor=#efefef><a href="http://www.vczx.com/article/file/20041112092122_vczx_msaa.rar" target="_blank" ><FONT color=#003399>下载本文所附源代码<IMG src="http://www.vczx.com/article/images/zip.gif" border=0></FONT></A> </TD></TR></TABLE>& ]8 m9 j9 q% W1 T
<TABLE cellSpacing=0 cellPadding=0 width="96%" align=center border=0>' Q  W; F+ S: o8 X

4 G" I0 [5 F2 r: l: U<TR>+ {. w, A7 D, n2 z0 c
<TD vAlign=top align=left bgColor=#ffffff>
1 w: D% `( g3 C6 l
& X9 @/ a& ~6 y* g4 ~0 p7 ?3 M<>
2 j0 e* [3 s. Q0 |; F& a& p7 w<TABLE cellSpacing=0 cellPadding=15 width="95%" align=center bgColor=#e6e6e6 border=0>: ~: }" V0 e6 Q" j2 B
' n! ?4 r, I% ~  h; F6 p
<TR>7 L, {9 W$ L% @* Q% I
<TD><FONT color=#00309c>Microsoft<FONT face="Times New Roman">&copy;</FONT> Active Accessibility 2.0 is a COM-based technology that improves the 1 I/ P% O/ I1 s+ a
way accessibility aids work with applications running on Microsoft Windows?. It
. f' v8 }# b9 Sprovides dynamic-link libraries that are incorporated into the operating system
* O- D5 D' `, R; Z/ Q# F9 [! eas well as a COM interface and application programming elements that provide
" d+ \# h9 G+ N4 r  [5 lreliable methods for exposing information about user interface elements.      </FONT></TD></TR></TABLE></P>" M* H7 F, j( X4 V' i
<>一、基础& h4 ?# H: ^9 P6 @% c* o8 n
    Microsoft<FONT face="Times New Roman">&copy;</FONT> Active Accessibility 是一种相对较新的技术(1.0版在1997年5月份推出)。目的是方便身患残疾的人士使用电脑——可用于放大器、屏幕阅读器,以及触觉型鼠标。同样还可以用来开发驱动其它软件的应用程序,其模拟用户输入的能力尤其适合测试软件的开发。
# v- d5 o1 X3 A. j! g  k$ H& N, F& t    Active Accessibility 的主要思想是提供一种以程序方式访问UI元素信息或操作这些UI元素的功能。支持这种功能的 UI(User Interface) 元素是可访问的。在大多数情况下,这意味着一个UI元素支持 IAccessible 接口。你也可以说在 Active Accessibility 的世界里,一个可访问的UI元素可表示为 IAccessible 接口。
6 {  a0 c: w5 ]5 u3 p  u% o    每当你需要得到有关一个元素的信息,在其上执行一个动作,或者使用 Active Accessibility 做其它的什么,你通常需要通过使用代表这个元素的 IAccessible 接口的一种方法或者属性来引用这个元素。</P>
0 o- Q  G  f1 O5 g( h<>二、Active Accessibility 原理
+ o& y$ U, g% q; c4 D; j    Active Accessibility? 的核心功能由 OLEACC.DLL 提供的。每次当你调用一个函数来返回一个 IAccessible 接口指针,其与一个UI元素相对应,OLEACC.DLL就检查此元素是否内在支持 IAccessible。内在的支持意思是该元素的 IAccessible 是用程序实现的。
$ B( N2 J* C5 E2 K- s; z4 B    当一个UI元素不能内在的支持 IAccessible 时,OLEACC.DLL 检查该元素的Windows 类名。如果该类是一个 USER 或者 COMCTL32 支持的类,OLEACC.DLL 就创建一个代理为 UI 元素实现 IAccessible 接口。大多数--但不是全部--COMCTL32 控件都具有被 OLEACC.DLL 支持的 IAccessible 接口。* g4 N; p5 M  Y
    内在支持 IAccessible 的 UI 元素的例子是定制控件,owner-drawn 和无窗口的控件。因为开发者创建的程序包含这些UI元素,同样就实现了这些元素的接口,他们有责任为这些方法和属性提供正确的支持。
9 G# }# J" z2 e% w' j* T# X2 a    如果你用标准控件,这也意味着你不必重写你的应用,这些应用自动与Active Accessibility兼容。
# Z$ E% j, X; c$ C" a    Active Accessibility 名字是基于 Win32 控件的名字给出的,角色基于控件的功能定义。</P>. R- M1 r; V5 r
<>三、如何得到 IAccessible 接口指针
8 y) p% i" _- r0 R* \5 @    每当你需要有关一个元素的信息,在其上执行一个动作,或者使用 Active Accessibility 做其它的什么,你只需要通过使用代表这个元素的 IAccessible 接口的一种方法或者属性来引用这个元素。
3 A' K- L+ ?( r/ Y7 n6 r    有几种方法取得代表一个可访问 UI 元素的 IAccessible 接口的指针。最普通的方法是使用 Active Accessibility 提供的一种函数,例如 AccessibleObjectFromPoint,AccessibleObjectFromWindow 等等,或者使用 IAccessible 支持的方法,例如 get_accChild,get_accParent。# s  X8 _- k" i9 t! B1 u
    IAccessible 接口支持允许你得到各 UI 元素信息的属性,而其中对于例子程序最重要的属性是名字、角色和状态。4 x0 H! v% u0 w
    Active Accessibility SDK提供了一些方便的工具,其中的 Object Inspector 能显示光标指向的UI元素的属性。Object Inspector 显示了Active Accessibility 的世界如何因为具有支持一个选定窗口内的 IAccessible 接口的控制而变得通用了。除了搜索有关元素的信息和通过 IAccessible 接口控制元素以外,Active Accessibility? 还有两种对于例子程序非常有用的特性:监视UI元素发生的事件和模拟键盘、鼠标输入。由可访问的元素激发的事件称为 WinEvents,当可访问的元素创建或者名字、状态、位置或者键盘焦点发生变化时,就激发这些事件(事件机制类似于标准的 Windows 的 hook 机制。监视事件我们将在后面介绍。)。这些事件的清单见文件 WINABLE.H。每个事件的名字以 EVENT_OBJECT 或 EVENT_SYSTEM 开始。
& [% z' c* M. Y0 F! z  M    好,我们言归正传,来介绍如何得到 IAccessible 接口指针。前面已经提到过 AccessibleObjectFromWindow 这个 Active Accessibility 提供的函数,从字面上大家可以看出是通过窗口来得到对应的 IAccessible 接口指针。, I5 m/ a/ G. |* _+ _5 d( K7 d
    因为 IAccessible 接口的数量比窗口要多(因为大多数--但不是全部--COMCTL32 控件都有被 OLEACC.DLL 支持的 IAccessible 接口。),使用 Win32 函数来搜索一个窗口将会比使用 Active Accessibility 树搜索与该窗口相应的 IAccessible 接口要占用少得多的时间。这就意味着为了提高性能,你应该使用 FindWindow 和 EnumWindows 这样的 Win32 函数来找到与希望的UI元素最接近的窗口。当然,在权衡 Win32 函数和 Active Accessibility 函数时,上面的规则只是使用它们的一般标准而不能盲目的遵照执行,重要的是理解它们的本来意义。
) {1 k3 U7 i8 [' G下面结合代码介绍一下它的用法。$ y2 J* P3 F7 e/ ?: u
我们来得到下面运行窗口的 IAccessible 接口指针。- j& @* S  F  c9 B: j* C0 Q
2 P, U% Q& X% a
<IMG src="http://www.vczx.com/article/img/20041112092538_vczx_msaa_actaccblty1.gif" align=baseline border=0></P>* O' K: A  n+ \' W$ n( U
<>图一</P>
7 h- l/ o9 G: j) T" S! x+ I- Z6 B7 X<>
1 W% `: K2 }% _+ X( t<TABLE cellSpacing=0 cellPadding=15 width="95%" align=center bgColor=#e6e6e6 border=0>
% P% k7 U: W2 A$ d6 Y% S+ Y9 M# F
<TR>5 R+ o( z& W2 W6 a* V6 v5 Y
<TD><FONT color=#00309c>HWND hWndMainWindow;
! y; y! z9 l5 y9 L% y* mIAccessible *paccMainWindow = NULL;# h8 n% c# y4 v% g* a
HRESULT hr;
6 @% j4 N) F! u( i& ]4 x//得到标题为"运行"的窗口的句柄
, |! r: l9 S; H! F( ~# ]if(NULL == (hWndMainWindow = FindWindow(NULL, "运行")))2 a: }0 v- N% s9 _2 b6 O* v. ~
{
9 d! ?: p2 J$ b! n9 e6 _; w, R6 [/ bMessageBox(NULL, "没有发现窗口!", "错误", MB_OK);
/ r5 c; Z/ _" T}
3 N; q4 T; s* ]' ielse8 r- {! j4 m: W/ l% o
{+ k8 y9 `0 P) V0 J5 w% t
//通过窗口句柄得到窗口的 IAccessible 接口指针。: N4 k+ P  Y0 L! k; i% s0 h9 X
if(S_OK == (hr = AccessibleObjectFromWindow(hWndMainWindow,
* d3 t% I: z( x                                            OBJID_WINDOW,
$ x8 Z* t( z  b                                            IID_IAccessible,
- g- E- D2 V- x' [3 C. M+ X) l) Q                                            (void**)&amp;paccMainWindow)))
; Q% k% F3 O' j7 q{6 @  W4 i! c/ o- h6 X& y' S) B$ n
//……我们可以通过这个指针paccMainWindow进行操作。
% P- r, j' z, q/ l+ l; Q3 ~$ _paccMainWindow-&gt;Release();
# Z1 f( |) B; J: W: L* ~' i2 G5 O) n        }
+ U' ~* L- B, i+ X}    </FONT></TD></TR></TABLE></P>* Y/ c# k) L3 J/ {( _: a0 O
<>   现在我们已经得到窗口的 IAccessible 接口指针了(paccMainWindow),那么,我们可以干什么呢?我们怎么得到窗口中某个控件的 IAccessible 接口指针呢?我们就以上面的运行窗口为例。看看如何得到文本框的 IAccessible 接口指针!!
9 h' Z) f" |  _2 S4 u5 C& C; w7 V    首先我们启动 inspect32.exe,什么?你不知道这是什么东西?赶紧先下载个Active Accessibility SDK看看吧……
5 f$ I8 w3 r2 ~% d. g    然后,把鼠标放到所关注的控件上(即上图中的文本输入框),你会得到如下信息:</P># h! Z. a. p/ x/ D7 N3 s) |
<><IMG src="http://www.vczx.com/article/img/20041112092648_vczx_msaa_actaccblty2.gif" align=baseline border=0></P>
* I- _' e# p; d6 z! O<>图二</P>
4 l5 @$ U5 k3 c7 I2 X$ }<>我们现在主要关注的信息是:Name、Role、Window className。</P>+ ~( F0 o/ ^! g+ a
<>
! J) _, {  d  r# ]8 d3 ]) C<TABLE cellSpacing=0 cellPadding=15 width="95%" align=center bgColor=#e6e6e6 border=0>
  ]0 {% j3 W: P; R: j2 h' \6 v) a: X; `: [: n# U
<TR>$ a: q$ Q  c, U# J  E) u' T4 z
<TD><FONT color=#00309c>Name = "打开(O):"
" {) A4 f) v" n1 U* L, ?% i6 o3 ERole = "可编辑文字"
/ ?+ M7 A, x9 e$ H5 V- x$ f: p; L5 [Window className = "Edit"  </FONT></TD></TR></TABLE></P>  P/ d3 }# w: ~3 \  k
<>    当开发自定义、owner drawn 或者无窗口的控件时,为同一窗口的每个"角色-名字"指定独一无二的表示是一个非常好的编程习惯。然而,如果由于某种原因,同一窗口中的2个 UI 元素具有同样的"角色-名字"对,那么就需要增加一个参数--windows 类--以唯一的来表示这个元素。
& O; m% P: b  `    FindChild 函数显示了一个基于 Active Accessibility 父/子(你可以理解成父窗口/子窗口的关系,只是为了便于理解:-P)导航的搜索例程的实现。这个函数有6个参数。前4个包含传递给函数的信息,后2个包含了 IAccessible 接口/子ID对(见附录)。
% L/ u$ [4 b" y0 e下面我们开始取文本输入框的 IAccessible 接口指针。 </P>- G, Y) J$ k" z. [, I0 s
<>
9 x- m2 k7 p/ s$ `  ~5 x<TABLE cellSpacing=0 cellPadding=15 width="95%" align=center bgColor=#e6e6e6 border=0>0 X- }. f( d+ ]1 p) \& o
% Z( R4 _  n: i6 e1 f
<TR>1 H, i1 J) e* V
<TD><FONT color=#00309c>IAccessible* paccControl = NULL;//输入框的 IAccessible 接口8 t* |; j$ H8 a$ k
VARIANT varControl;    //子ID。8 U: Q2 }  s3 s" z

+ q) s' m+ l' Z0 LFindChild( paccMainWindow,
7 V7 i. ]7 l- g- e' b+ a           "打开(O):", * o; t! ~5 l, F- S, E
           "可编辑文字", 4 w. s4 ~5 @8 r5 A: B
           "Edit", , D- @+ C6 Y% f. i8 Q2 K
           &amp;paccControl, 5 I5 e9 z* {. f* c- ], _+ s3 l/ ^# g
           &amp;varControl ) </FONT></TD></TR></TABLE></P>
+ `& N: m' }& h2 O' V<>第一个参数是先前得到的窗口 IAccessible 接口指针。
" l' K4 ?% Q( j. V7 z第二、三、四个参数分别是名字、角色、类。8 x3 K9 w4 [# B1 @
后2个为返回参数包含了 IAccessible 接口/子ID对。下面是FindChild的实现。 </P>0 H/ E5 n5 e. I0 l5 Y
<>
" F" Q; J) S8 t! j8 q7 M) L; a, J<TABLE cellSpacing=0 cellPadding=15 width="95%" align=center bgColor=#e6e6e6 border=0>' ?2 {7 [) A+ m; ]! |# Z

+ q( M5 T" @1 x) K) l2 r: G<TR>
* j% `$ n) i; Q: y4 ^" `<TD><FONT color=#00309c>BOOL FindChild (IAccessible* paccParent, 5 c5 e. H3 D5 x
                         LPSTR szName, LPSTR szRole, 7 o+ e3 f% v; W7 a2 I4 e
                         LPSTR szClass, " Q: K% r+ Q  i  F
                         IAccessible** paccChild, # H; w( b: \/ h
                         VARIANT* pvarChild)
& _, w. G! p& C! S8 ?{
! K  e6 i2 N7 |1 q# IHRESULT hr;/ |6 {+ }# V- G& j
long numChildren;/ Z7 ]8 t# O! q# b8 N! P0 N
unsigned long numFetched;
7 P, ^; {+ o5 j3 o5 C: c; ^VARIANT varChild;; [: W" l) c8 ]/ P  l
int index;
, S$ z; J' i0 @1 D; B4 BIAccessible* pCAcc = NULL;% A. c" d% I9 I5 A0 n
IEnumVARIANT* pEnum = NULL;! [; ^: o" U% W5 c. d, v+ {
IDispatch* pDisp = NULL;' C( b1 h, E1 u
BOOL found = false;
$ s. l2 e% e$ s! Cchar szObjName[256], szObjRole[256], szObjClass[256], szObjState[256];
. m1 d" l* u3 M! ]6 V* r0 ^! H
( `2 [+ |) [' ^% e//得到父亲支持的IEnumVARIANT接口2 P7 t% [3 d( G' Y5 \$ u7 q& n  ^! ?7 O
hr = paccParent -&gt; QueryInterface(IID_IEnumVARIANT, (PVOID*) &amp; pEnum);  D! ], B) t% ]! ?: J3 ?

2 u. m; \8 ?) i( Z7 J* ]if(pEnum)
  m# B( w  m2 K7 _, b: opEnum -&gt; Reset();
3 m6 v2 B! Z; H( o
& J1 E/ Y% ^' O//取得父亲拥有的可访问的子的数目
  F0 Z4 p: L- ?. P3 ~paccParent -&gt; get_accChildCount(&amp;numChildren);
' e& ~5 q- I1 d- g7 ]' `& O7 Z3 R
//搜索并比较每一个子ID,找到名字、角色、类与输入相一致的。0 t3 D% \3 V( m; Y- H7 ^7 o- w
for(index = 1; index &lt;= numChildren &amp;&amp; !found; index++)# C2 d8 P6 m% N" g. t
{7 ]: ^$ l+ I6 `! Y% u
pCAcc = NULL;
5 n* R4 p/ y. q& T6 Z// 如果支持IEnumVARIANT接口,得到下一个子ID3 N; ?& |6 r4 G: K
//以及其对应的 IDispatch 接口
6 y- A* X+ J% u+ a6 ^7 K3 uif (pEnum)- P' E: H' ^1 o. |0 e- l% u* G
hr = pEnum -&gt; Next(1, &amp;varChild, &amp;numFetched);
2 z" k, H& F3 c7 I  ~7 _  L7 v# {else
: ]2 z5 {6 N% x" F3 H( B0 o0 l{
: T% h5 F. B1 p5 V# D7 @5 f//如果一个父亲不支持IEnumVARIANT接口,子ID就是它的序号
- z+ a* ~" u! i, p, U7 _varChild.vt = VT_I4;- M9 f2 d2 K+ H1 E# ~
varChild.lVal = index;% `: I/ @7 y/ S6 y) ]
}
+ a4 b% N" I* {( _( F
2 k3 D/ a7 h: r/ E+ Q5 E: G6 b0 @// 找到此子ID对应的 IDispatch 接口
" m3 Q! C" T0 c/ ~+ F* e3 }; n; ~if (varChild.vt == VT_I4)4 L* [* o7 k1 V2 Q+ G
{
8 _7 q- S, [# r- e, _. [) P//通过子ID序号得到对应的 IDispatch 接口/ ~1 ^6 d3 M  C  ]: r9 A9 K+ |
pDisp = NULL;9 r/ i! V8 B( q, B
hr = paccParent -&gt; get_accChild(varChild, &amp;pDisp);& W% G9 Z. _8 m* Y% q
}
$ K: e9 o. ]  k! M4 q3 K; Aelse
/ ~5 r  `7 M2 X' f' P& l//如果父支持IEnumVARIANT接口可以直接得到子IDispatch 接口
9 z8 [2 O9 m: U. @: O5 vpDisp = varChild.pdispVal;
1 l) Z- J+ O# @
/ V  E6 A4 [3 f, m8 M2 O8 r// 通过 IDispatch 接口得到子的 IAccessible 接口 pCAcc
$ h1 d5 ]8 r$ W- b; I, e6 cif (pDisp)6 l: E. u& o( {
{2 _" b& A- u( J" l4 y) v( J% I4 n
hr = pDisp-&gt;QueryInterface(IID_IAccessible, (void**)&amp;pCAcc);. C; G  N9 P1 x0 W9 N9 W
hr = pDisp-&gt;Release();4 Q' P: ]) u/ ?/ P( [  m8 x  {
}
  ~7 N+ `( A  ?; B2 Y2 p
( U, x1 b/ F; K0 }; H// Get information about the child
$ ?1 f2 d/ P2 v6 {if(pCAcc)* s9 O, v, d. ]
{& K, U+ p; ]. N9 _* |; Q
//如果子支持IAccessible 接口,那么子ID就是CHILDID_SELF
& ]( j' _) a' D% V  j- f1 FVariantInit(&amp;varChild);3 M; w( T% Z, }6 u5 o
varChild.vt = VT_I4;3 D* Z2 v# t9 X% w
varChild.lVal = CHILDID_SELF;6 P, X2 Z- g; @. t6 t5 C

. x$ R3 N% H5 B" k*paccChild = pCAcc;2 B; c, ~( n+ I3 M  N/ @* E! k
}2 K6 p5 [. ~0 m. K* C2 n' p: j. y: R
else4 u. J( T5 z2 v# h1 D5 n  h( @
//如果子不支持IAccessible 接口
# Q/ d4 p* `$ _  R4 D*paccChild = paccParent;. ?4 p. ?# e# o  l0 ~" C

, i, Q/ {3 v6 f' m/ `& N2 |4 p! a//跳过了有不可访问状态的元素
* A4 P7 W+ R, w' b5 S  FGetObjectState(*paccChild,
' w/ D2 R6 Z3 L/ x6 K               &amp;varChild, ; N& Y$ g& `. p( K! R
               szObjState,
' A% X7 B' }# p3 G               sizeof(szObjState));) c# D5 P' t$ G' A3 @
if(NULL != strstr(szObjState, "unavailable"))" O+ o- c6 d' f0 _! F
{
9 m0 B9 B* B8 Q& P6 Q& X2 s; B. hif(pCAcc)
. G& i" X( `: v9 v- d* FpCAcc-&gt;Release();
& t% j/ m( q3 I( ?continue;) _" E9 ~6 q" w& P# z
}, ]7 Q- F0 }- C' o" q
//通过get_accName得到Name3 _* \+ T3 m7 a  b2 ]: b; o6 t
GetObjectName(*paccChild, &amp;varChild, szObjName, sizeof(szObjName));
: {: o5 k0 `+ Q' g# a9 y  a$ W  a/ Z//通过get_accRole得到Role6 _* S# i1 h; L
GetObjectRole(*paccChild, &amp;varChild, szObjRole, sizeof(szObjRole));
, w8 O. n8 {2 j0 t//通过WindowFromAccessibleObject和GetClassName得到Class  O) u; l4 S8 N1 R1 q$ F7 T- ]
GetObjectClass(*paccChild, szObjClass, sizeof(szObjClass));! S0 P8 z; |& |2 w% m
//以上实现代码比较简单,大家自己看代码吧。
2 e1 X* p! e: `3 C( T
  t  t3 O6 X- t8 ?( c) D//如果这些参数与输入相符或输入为NULL: \; d1 r* f" H$ k+ h5 [9 i
if ((!szName ||
& d, F& X. A( ?7 @" v     !strcmp(szName, szObjName)) &amp;&amp; . @$ }7 p9 @2 r5 r. a
     (!szRole || # F7 _+ V1 }8 p: Z- V
      !strcmp(szRole, szObjRole)) &amp;&amp;
7 S( I& ~9 p2 [  E- f     (!szClass ||
2 A7 E% g7 T3 P      !strcmp(szClass, szObjClass)))
5 g) a* R: t9 V! V- E{
0 h* f- |* Q" Q# \7 ?found = true;! d. _" R( A+ M" A" s9 C8 H
*pvarChild = varChild;
+ r; J) K5 c+ `3 K8 T7 qbreak;
; f2 y% W2 h9 S7 }}
$ w$ a3 d1 C! Nif(!found &amp;&amp; pCAcc)
% O  U5 Q. G8 p- P% O+ Q2 z{
1 N! U- S! S5 g* |// 以这次得到的子接口为父递归调用0 I! V; c* i7 C" y3 ~: Q8 z# F
found = FindChild(pCAcc, * T+ z  K1 E0 [
                  szName,
6 D8 E1 u2 C6 m                  szRole,
" E7 \0 c5 P' R) R% e7 v+ a4 m                  szClass, : V+ M& N9 p- m' F( v
                  paccChild, ! \. w( b- L9 r0 O
                  pvarChild);
4 m) G% m. s! e' a5 ^+ Pif(*paccChild != pCAcc)8 z) x3 D$ {( S. g9 S1 H$ o
pCAcc-&gt;Release();5 {& S4 n6 a, {; j8 Y6 j# ~9 b
}
" S6 |; j6 y0 X; }* y/ l}//End for
( D+ \% r- H+ T9 E: Y# D( y6 [% Q% {( a& g8 I7 e, A
// Clean up$ F8 W; J( g& f
if(pEnum)
% i1 x; P( x& Y. _pEnum -&gt; Release();
4 p1 Y( J3 {" O7 |# b  B- X& G) j( {7 H
return found;, L, `/ p" ^" V4 \
}
. v" _1 S! u9 D9 v
9 u( l/ a: z# V' M5 p// UI元素的状态也表示成整型形式。因为一个状态可以有多个值,
7 l* y; Z. Q6 N( a$ V* I8 [5 w' s//例如可选的、可做焦点的,该整数是反映这些值的位的或操作结果。
' I" U$ s( s$ t& v4 B8 W: R5 j//将这些或数转换成相应的用逗号分割的状态字符串。
; l! @) @& x; Z- x2 a1 L# PUINT GetObjectState(IAccessible* pacc, % h, i0 R6 I3 l: @  O
                    VARIANT* pvarChild,
0 Y" F9 i7 C. t( V# g+ M) y                    LPTSTR lpszState,
4 s+ ^5 a: J! R2 {5 U) P                    UINT cchState)* G" n& z( ~& t: C5 ^
{
* Z* i, w) h1 }    HRESULT hr;
! E3 t; l  y0 }/ a! d; @    VARIANT varRetVal;! {/ j$ K2 Q, t5 o& _1 {1 T
9 L0 r1 Z  @' W* `
    *lpszState = 0;7 y8 S6 j0 k2 h. z; f

0 h, n& T: O7 D. ]0 e    VariantInit(&amp;varRetVal);; ^8 L/ G, r, h2 X/ x

( H6 f' s% [: }& X# ^- _    hr = pacc-&gt;get_accState(*pvarChild, &amp;varRetVal);
% z; s1 E( }4 Y/ v- m) M
" L) M# _. B. l5 w- d8 Sif (!SUCCEEDED(hr))
6 b. s# ~7 M7 n' l" _3 K        return(0);
# c! G2 _5 J! C8 n' w* m
, Y3 G2 ]* U3 BDWORD dwStateBit;
0 `7 g9 @* [2 J4 f  K1 k, J# ?int cChars = 0;" ?4 s+ q# o' u; n9 c3 b
    if (varRetVal.vt == VT_I4)
* `, M& D0 J4 O9 j+ k# l  F  g* G) l( E{6 z5 t$ k- c  _. y) J
// 根据返回的状态值生成以逗号连接的字符串。2 k% c( S: U- C2 g3 i
        for (dwStateBit = STATE_SYSTEM_UNAVAILABLE; % a3 m+ U7 w2 N6 y! H9 k" u
               dwStateBit &lt; STATE_SYSTEM_ALERT_HIGH; 0 j% d0 V1 C1 G, b# t: z3 o, x( V
               dwStateBit &lt;&lt;= 1)
8 z* j8 {/ q9 O; V! W7 Q4 `; S        {
" ]' E7 [/ d' z7 l& V3 X            if (varRetVal.lVal &amp; dwStateBit)
7 j( \" |  {! e; j" ]            {: z, E! \( M% e+ m. A$ ?
                cChars += GetStateText(dwStateBit, . m) p  [% y- t2 g1 n1 K
                                       lpszState + cChars,
7 F% N" h# ]5 e- N9 |9 [3 }, `  T1 m: x                                       cchState - cChars);
: ?. o. q4 L" l$ k( f*(lpszState + cChars++) = '','';6 I. g$ _# d0 y3 N
            }
+ J& X: @* @: {  l6 {        }7 ~, Y- R( }# `/ J+ _. f; u$ G
if(cChars &gt; 1)
- e7 _5 M, z+ i2 n*(lpszState + cChars - 1) = ''\0'';
& `2 M# }+ x6 b0 y0 k    }
  w$ \# M! x* D4 Y& u    else if (varRetVal.vt == VT_BSTR)# B' Z  k$ L( i- J% c1 `$ ~, W
    {
8 k# m: w8 {& x8 H- }+ n8 M        WideCharToMultiByte(CP_ACP, & |( O- i! u' }
                            0,   i4 Q7 o, p- o5 K
                            varRetVal.bstrVal, : u8 q7 M  c( p# K
                            -1, 5 i8 S4 _" q, O3 g5 y2 H
                            lpszState,
# z% X4 _$ D: _% R6 n                            cchState,
8 A3 {! V6 k, t; m                            NULL, ) h& k) i" P8 |) ^8 p, S$ H6 [
                            NULL);, b$ G  a, t: u" F6 v
    }
1 x5 I$ B' v; M' P0 R8 u" j& B3 \$ D- e+ l
    VariantClear(&amp;varRetVal);
& D0 P) ]9 N9 ^
1 A  L% B' D! G    return(lstrlen(lpszState));9 q' ]7 P  F& U, w' L
}</FONT></TD></TR></TABLE></P>8 X2 @3 a! P7 p
<>好了!!我们已经成功得到文本框的 IAccessible 接口指针了!!现在你可以用这个接口指针为所欲为了!!!呵呵:)* h/ Z* q2 a* W  d. y( }

# q4 u3 r  _5 _5 G8 r5 l四、在 IAccessible 接口上执行动作
# U/ w8 A- M) s7 N6 L    有了表示一个可访问的 UI 元素的 IAccessible 接口/子ID对,你也有了搜索该元素一个名字(get_accName)、角色(get_accRole)、类和状态(get_accState)的方法。让我们看看你还可以干什么!get_accDescription 能取得UI元素的描述,get_accValue 能取得一个值。/ {* P* m$ [& ?- u, A8 e( U
    最重要的函数之一是 accDoDefaultAction。每个可访问的UI元素都有一个缺省定义的动作。例如,一个按钮的缺省动作是"按下这个按钮",一个检查框的缺省动作是"不选"。为了确定一个元素的缺省动作,请参考 Active Accessibility 文档或者调用 get_accDefaultAction。  S# |4 I4 ~+ ~2 {
    如果我想起动注册表编辑器,该怎么办呢?如果是我们手动做的话,无非是在文本输入框输入"regedit",然后按确定按钮,就这么简单。下面我们来看看用 Active Accessibility 是怎么来实现的。 </P>, a: m* K. g, Y" M4 p6 J
<>
6 l# ~" W& ~4 ]" w4 g5 r. D<TABLE cellSpacing=0 cellPadding=15 width="95%" align=center bgColor=#e6e6e6 border=0>
* y' _: V* o* m0 o) `+ n  w0 t- F8 a
<TR>
) t8 i  e# z- s/ B' [. ~7 e/ A<TD><FONT color=#00309c>//在文本输入框输入"regedit"
- k0 C1 [! V& K) lif(1 == FindChild (paccMainWindow, "打开(O):", 1 k$ n! s. O' G1 e1 c
                   "可编辑文字", + {& {8 V  d, X/ f' K! e3 Z  Y
                   "Edit",
; Q" F% N* A+ L$ Y& _) \                   &amp;paccControl,
" Q6 e& E8 H" E                   &amp;varControl))
" J' @; |( W4 S2 E" t& @0 @{
  O2 I+ \9 e, f3 I4 C+ y7 }- S//在这里修改文本编辑框的值
! D: b5 }4 h2 c" Ehr = paccControl-&gt;put_accValue(varControl,
0 H% G! n4 q7 E7 ?+ y' q8 G5 t                                  CComBSTR("regedit"));
! C1 N& d" j0 d$ kpaccControl-&gt;Release();
2 U: J/ C1 y! s# P' ]$ pVariantClear(&amp;varControl);
# ]( _: C6 h3 Q. j6 E$ K}
& m9 |; L' @, y4 J
$ e; @. n( J  R// 找到确定按钮,并执行默认动作。5 ]+ v" y1 b6 B( s6 a% b+ a
if(1 == FindChild (paccMainWindow,
" l+ B, F' K& P% ^0 I1 b& R                   "确定", 4 s  c$ l" V7 _" F  X1 w
                   "按下按钮",
' q/ ^7 J# O. s0 e0 u% _: I                   "Button", ( ^' b% v- J  y/ t& n3 e( h& C% v
                   &amp;paccControl, - L. s$ R7 f4 P" g; C- R" i, A  ~
                   &amp;varControl))
$ j9 d- a" V: T  E! s{
& r# Y/ Q& ~+ j" ]//这里执行按钮的默认动作,即"按下这个按钮"2 U. \% X5 m& B
hr = paccControl-&gt;accDoDefaultAction(varControl);4 P9 v- [! \' H) l
paccControl-&gt;Release();
: {7 a0 J' m& x" d# F2 FVariantClear(&amp;varControl);
4 {2 t5 c% g" m+ C% y. I}</FONT></TD></TR></TABLE></P>
8 F2 C: [5 O3 x2 D- j5 o- |0 g<>现在,你会发现已经成功启动了注册表编辑器!!% D# i. @' T$ k% a0 x
</P>
5 u+ z! I( \* c  x; p4 g<>五、模拟键盘和鼠标输入3 d- d1 f2 P& k- `, `
    让我们假设你需要操作一个新的不完全支持 Windows 消息和 IAccessible 接口方法的 UI 元素。如果它不支持你需要的消息和方法,最简单的解决办法就是模拟键盘和鼠标输入。例如,你可以用Tab模拟转移到期望的控件。. A, j0 x  y# x1 ], _
    使你能够实现这些的函数就是 SendInput 一个一般的USER API。虽然不属于Active Accessibility,把他们联合使用很自然。) f- \& c/ ~. U- z2 @; ~  B/ C0 a% s0 X
    SendInput 接受三个参数:要执行的鼠标键盘动作个数、INPUT结构数组和结构数组的大小。每个INPUT结构描述一个要执行的动作。注意,按下一个按钮和释放一个按钮是两个不同的动作,所以必须创建两个不同的INPUT结构。& T& `) b- y7 t2 ^8 Y; I6 R8 C" {3 N/ d
下面的代码将模拟 ALT+F4 按键来关闭窗口。 </P>7 r1 _3 ?9 X' S. M% q% s
<>$ C6 E" [# {) l
<TABLE cellSpacing=0 cellPadding=15 width="95%" align=center bgColor=#e6e6e6 border=0>
, [8 O* O& A3 E9 d2 R1 E
6 E; s  |  a, E5 \, ^: ?5 D  z5 E<TR>- g, o# l3 Z/ v9 D" E* f3 g6 k. c
<TD><FONT color=#00309c>INPUT input[4];
( v, e0 [) s0 R" ^' o4 O4 \memset(input, 0, sizeof(input));
% U0 v! b% j9 J: y
- J3 }' ~: z9 W1 R; E1 @//设置模拟键盘输入) B8 C7 k1 f" w% {" K) c9 F  n  A( O
input[0].type = input[1].type = input[2].type = input[3].type = INPUT_KEYBOARD;! U5 }4 E" n1 B+ A1 U) V: K1 V
input[0].ki.wVk  = input[2].ki.wVk = VK_MENU;# F! E. |) a2 N! x
input[1].ki.wVk  = input[3].ki.wVk = VK_F4;3 I6 ]4 q" W- m! X
" x& F" w/ z; {! x& }- b9 S% I1 F  ^
// 释放按键,这非常重要, G! M0 A  ^) v( @! ?
input[2].ki.dwFlags = input[3].ki.dwFlags = KEYEVENTF_KEYUP;% N: R+ x/ N7 Q& ?0 r" ~+ o

# H: f+ R9 f& Y: O( s$ TSendInput(4, input, sizeof(INPUT));</FONT></TD></TR></TABLE></P>
) _* q) n. T* M, L<>具体用法大家还是查MSDN吧,这里就不罗嗦了!!:). q2 m* ?* _3 Q; a, E) L( L/ c& A
</P>
) t  G, i& I: G, a5 S<>六、监视WinEvents
& e+ f8 s0 m/ j+ {1 T    监视 WinEvents 非常像通过 Windows Hook 监视 Windows 消息。最重要的区别就是从另一个进程监视 UI 元素发出的 WinEvents 时,你不需要创建一个单独的DLL来注入那个进程的地址空间。
" p, r+ D- z6 `$ @! C8 F+ }) T; J    监视 WinEvents 有两种选择:通过设置 SetWinEventHook 函数的最后一个参数来确定是在上下文之外还是之内监视。如果是在上下文之外,不需要额外的DLL,回调函数运行在目标进程之外。如果是在上下文之内,回调函数必须放在额外的DLL,并注入目标进程的地址空间。第二种方法写代码比较麻烦,但是运行效率高。3 M) N# b) l$ U  O: ?
    好,现在回到上面的例子。上面例子能够执行的前提条件是能够找到标题为"运行"的窗口。现在可以先检查运行窗口是否存在,如果不存在就设置WinEvents 钩子去监视,直到"运行"窗口被创建。看下面代码:</P>; J3 Q( ]1 c0 {& }
<>+ O$ m- b( s( K' R& a
<TABLE cellSpacing=0 cellPadding=15 width="95%" align=center bgColor=#e6e6e6 border=0>
$ F  Z3 [: A8 k9 z
$ ^6 i# o) v0 h5 r" E* u<TR>4 n7 N6 V$ x1 _
<TD><FONT color=#00309c>if(NULL == (hWndMainWindow = FindWindow(NULL, szMainTitle)))
8 [: Z* V; ?* I6 |& a8 c3 |{1 Z" L! A5 C: c. ~( p( t! y+ y
hEventHook = SetWinEventHook(. N1 M# C; F# v6 u
EVENT_MIN, // eventMin ID' h% S% Y4 G& x; r  P  O: D* Q
EVENT_MAX, // eventMax ID
5 [3 Z7 u. h) F- a6 G1 _7 g- S  CNULL, // always NULL for outprocess hook0 e5 z& @4 M& W1 v( G
WinCreateNotifyProc, // call back function
% t. }2 p- T, P6 @7 d0, // idProcess# R' |1 U  q8 _8 Z. q, U2 _% H- h
0, // idThread & x. ^% T- z0 _# H2 M
         // always the same for outproc hook
/ |9 I- J8 E1 L, Y" I, q7 wWINEVENT_SKIPOWNPROCESS | WINEVENT_OUTOFCONTEXT);" y0 P$ d) A% d  A  \  o4 Z
}  </FONT></TD></TR></TABLE></P>
. S$ Z: q" r' E# I. f# {. W( D% E3 O7 J/ K9 n' y" y* k
<>    第一、二个参数用来指定监视事件的范围。第四个参数是定义的回调函数。
  J0 @3 I6 q* ]- q4 C& i下面是回调函数:</P>
& w. s; \9 K9 p: W<>4 S) n3 Y# }% B+ c* k; ]
<TABLE cellSpacing=0 cellPadding=15 width="95%" align=center bgColor=#e6e6e6 border=0>
; }; M1 [; r5 B# ?. z
2 H' I) f7 Y1 b8 O$ |+ I<TR>+ A" S- g8 _4 E7 z) J( e) W) f
<TD><FONT color=#00309c>void CALLBACK WinCreateNotifyProc(/ E( n+ d; }% D4 U$ }& z; d
HWINEVENTHOOK  hEvent,
2 D) G" q+ p& |* Z9 O1 x3 FDWORD   event,& G( Z  G% G- [( P( J0 K
HWND    hwndMsg,8 D  y/ a% S% {' }! H, t$ i% c
LONG    idObject,; {4 k9 y4 @: V( T( w& T6 v) {
LONG    idChild,
6 W4 b& p! {; o7 @% U+ HDWORD   idThread,
8 ?# @8 R7 I5 fDWORD   dwmsEventTime
% x( i) F9 s6 `)2 f! g# p  p: Q
{2 e% L: i# |" p8 s6 h
. k. E; S5 O$ P) w2 f
if( event != EVENT_OBJECT_CREATE)% y3 ~6 z0 r8 V" p7 ]+ T0 s0 z9 X
return;2 R4 [2 A2 E0 r, ], y+ t1 T2 [+ j5 t
" y# u5 j, K* Q- [* p/ H  |2 s
char bufferName[256];  _% ^! E8 |+ g2 c, p
IAccessible *pacc=NULL;
& `0 ?3 w5 z! K& RVARIANT varChild;
/ u7 p6 u9 O" Y2 l    VariantInit(&amp;varChild);
, o  s8 C5 f# i* J( t9 w. a/ A//得到触发事件的 UI 元素的 IAccessible 接口/子ID对$ ?) Q, i; h3 m2 F
HRESULT hr= AccessibleObjectFromEvent(hwndMsg,
* S9 i. u4 t0 c8 D. S; M                                      idObject, % U) x: @! y+ P2 N: f* o8 y, W
                                      idChild, 1 F- T) Q! t" U
                                      &amp;pacc, % ?4 D' x) v, @% j$ A% q
                                      &amp;varChild);
, Z* Z+ L; V8 L" [3 a0 T; N4 _0 Y+ B, r5 h' L$ s3 I0 X/ ?
if(!SUCCEEDED(hr))
& O- J8 `4 C& j1 ~4 u% |+ H{
" a$ u3 g5 d9 ]) PVariantClear(&amp;varChild);' z3 Y6 t& r, C3 K; ^* B
return;
% L8 q" \3 t* c) B}
2 J" h; T5 X+ `//得到 UI 元素的Name,并比较,如果是"运行"就发送消息给主线程。
, m; X% c7 z* |) q* x. _, NGetObjectName(pacc, &amp;varChild, bufferName, sizeof(bufferName));
3 R  W% y/ o0 a: wif(strstr(bufferName, szMainTitle))
0 d5 C, E; F* F5 l3 PPostThreadMessage(GetCurrentThreadId(), - v2 {6 H4 Z3 u% x1 u
                  WM_TARGET_WINDOW_FOUND,
9 I0 W) @0 Z/ b                  0,
$ }* G) |$ ~- d  I  \1 K: E                  0);# h3 I3 v+ V: G- A1 p

* U! U) M" i* y# D- v9 o6 rreturn;
, B9 }% o8 L1 [* `}    </FONT></TD></TR></TABLE></P>恩…………,一个应用基本成型了,虽然比较简单。就先写这么多吧,请关注后续介绍。9 n. s/ V! X$ A0 s- ^% a6 @
# V0 e9 ?. t! f, L5 @- w3 e
附录:# _0 c$ u: a* r& O+ i2 y5 m9 ]

# |6 Q( i4 k' }关于IAccessible 接口/子ID对:  n2 s" x3 G' i7 r3 F" Z
    让我们来考虑这样一个控件,他支持 IAccessible 接口并且包含一些子控件,比如 listbox 就包含很多 items 。有两种方法让他可以被访问:第一种,提供listbox的 IAccessible 接口和每一个 item 自己的 IAccessible 接口。另一种是只提供一个控件的 IAccessible 接口,这个接口能够提供基于某种识别方法来访问每一个子控件的功能。
0 E2 x1 n4 _; W3 c# V$ _  e7 _+ \    第一种方法,需要为这个控件和每一个子控件创建单独的 COM 对象,这会比第二种方法(每一个子控件不支持自己的 IAccessible 接口,而是通过父接口来访问)增加内存消耗。第二种方法里,通过增加一个参数--子ID--同父的IAccessible 接口一起表示这个子控件。子ID 是一个 VT_I4 型的 VARIANT 值,包含一个由程序决定的独特的值,或只是一个子控件的序号。序号意味着第一个子控件的ID为1,第二个子控件的ID为2,依次增长!& h  Q2 I9 i6 R
    这样,如果一个子控件不支持自己的 IAccessible 接口,而其父控件支持,那么这个子控件可以用它的父控件的 IAccessible 接口/子ID 对来表示。通常,一个支持 IAccessible 接口的父UI元素也是通过这样的 IAccessible 接口/子对表示的,这时候其子ID号为 CHILDID_SELF (就是0)。
: p- s5 \1 g7 g    记住,子ID号总是相对于 IAccessible 接口的。例如,一个可访问的元素可以同相对于其父 IAccessible 接口的一个非子 CHILDID_SELF 的 ID 及其父IAccessible 接口表示,如果他支持 IAccessible 接口,此元素的子ID就是相对于自己 IAccessible 接口的CHILDID_SELF。
& P) ?8 Q4 F8 U) ?    呵呵,翻译的有点别扭,意思就是说,如果这个控件支持 IAccessible 接口,那么它的子ID就是0(CHILDID_SELF),可以用它自己的 IAccessible 接口和0这个对来表示这个控件。如果控件不支持 IAccessible 接口,就用它父控件的 IAccessible 接口,和一个相对于父 IAccessible 接口的子ID来表示。哎呀!!不知道说明白没有。郁闷!!!!
: W8 G2 X, h& Z" t
  Q' }4 Y( m+ x8 |注:
" {& u" H+ M: y+ f. m% E# I    我也是刚开始学习怎么使用MSAA,但是苦于很难找到中文资料。希望这篇文章对大家能有所帮助。由于了解的还很肤浅,错误难免,望谅解!!:)
: N. }4 H% [- s) d' _; r    还有,这篇文章基本编译自Dmitri Klementiev的《Software Driving Software: Active Accessibility-Compliant Apps Give Programmers New Tools to Manipulate Software》,只是按自己的理解重新编排了一下,如果觉得不符合自己的学习习惯可以看原文。并且我的文章省略了很多东西,呵呵。- z# n- a4 s1 g# h) t

  G7 V  ?. K$ b  `) @: l) D参考资料:
, o( @! B7 [; r0 C- [<UL>" d. h5 r) q1 X0 s
<LI>1、 Dmitri Klementiev写的《Software Driving Software: Active Accessibility-Compliant Apps Give Programmers New Tools to Manipulate Software》及其源程序。http://msdn.microsoft.com/msdnmag/issues/0400/aaccess/default.aspx & B0 u; u" t3 N. P) v9 W; g+ `
<LI>2、 MSDN中的相关章节。 </LI></UL></TD></TR></TABLE>
zan
转播转播0 分享淘帖0 分享分享0 收藏收藏0 支持支持0 反对反对0 微信微信
xShandow        

43

主题

1

听众

385

积分

升级  28.33%

该用户从未签到

国际赛参赛者

新人进步奖

回复

使用道具 举报

您需要登录后才可以回帖 登录 | 注册地址

fastpost qq
收缩
  • 电话咨询

  • 04714969085

关于我们| 联系我们| 诚征英才| 对外合作| 产品服务| QQ

手机版|Archiver| |繁體中文 手机客户端  

蒙公网安备 15010502000194号

Powered by Discuz! X2.5   © 2001-2013 数学建模网-数学中国 ( 蒙ICP备14002410号-3 蒙BBS备-0002号 )     论坛法律顾问:王兆丰

GMT+8, 2026-11-23 06:30 , Processed in 0.195872 second(s), 58 queries .

回顶部