用VC++制作拨号控件

天云上人

作者：黄鹭滨
1 g6 }' J- y/ ^" c! Q
( V* @' L. l# w" L+ J如果您有VB 的编程经验，一定对VB所支持丰富的控件留下深刻的印象。这些就是ActiveX控件，一般是以
; ]  G) Z( Q3 @: x) \6 ]ocx后缀。由于ActiveX控件与开发平台无关，因此，用VC++编程开发的ActiveX控件即可在VB或其他平台上使用。用VC++中开发的ActiveX控件，代码简洁，运行速度快。VC++还可以直接控制底层的各种操作。用VB快速开发出漂亮的界面以及应用程序框架，再嵌用VC编写底层的各种操作的控件，已成为越来越多软件编程人员愿意采用的编程方法。
# S' _  \0 F& }( |; }
& ^2 v. I* _2 R# q" H1 t8 A" c/ a
  H# A" {/ O9 ]; Y7 L9 K! I8 W! T----
拨号上网是编写网络应用软件常用的操作，程序在运行某些远程网上操作前，需要先拨号与网络连接，完成操作后由必须收线断开。在Windows
$ N2 F- w: K- L) }4 s5 ~95/98的"拨号网络"中，虽然提供拨号功能，但无法直接让自己开发的应用程序来调。而在系统注册的常用的控件当中又没有提供。

- p: Y& v! n) y1 b- C# n
---- 本方法是利用VC++制作一个拨号控件，提供拨号与收线功能。VC++
. i' U" F8 T( h9 L% }6.00提供控件的创建引导（MFC ActiveX ControlWizard）可以快速生成ActiveX
4 v0 y: u. k. j# O控件的程序框架。拨号功能是由VC++提供的 rasapi32.lib
的函数库支持的，函数及变量在 ras.h 文件头定义。函数RasDial()实现拨号功能，RasHangUp()用来终止拨号连接。函数调用方法：
4 D4 C* y( m) y, J
" V$ ]2 `( A6 R
1 V. A  R( F2 X( H5 B; C  ?, `5 E% |DWORD dwRet = RasDial( NULL, NULL,
&rdParams, 0L, NULL, &hRasConn );
7 P! _& G$ o" k" f! {( hDWORD dwRet = RasHangUp( hRasConn );

# N) Z2 B6 S6 G: E& V其中：
( I! O- m5 z0 T0 Q; A/ crdParams 为 RASDIALPARAMS 结构，
主要参数定义如下：
DWORD dwSize 结构变量的大小；
TCHAR szEntryName[] 拨号网络中建立的连接名；
( P7 v- w" {8 i% d; \6 G( a- zTCHAR szPhoneNumber[] 电话号码，
7 G+ t8 G' t; H若采用 szEntryName 中定义的号码，置为NULL 值；
3 A! G- @* N' k% \CHAR szCallbackNumber[] 回拨号码，不用时置为NULL；
TCHAR szUserName[] 用户名；
8 H9 h* j/ }: d2 DTCHAR szPassword[] 用户口令；
TCHAR szDomain[] 用户权限验证域，
若为'*'采用szEntryName 中定义的域进行验证。
, U0 S- p% B2 l7 @, N! [HRasConn 是 HRASCONN 结构，作远程拨号连接句柄。

; i0 p5 K( G& A0 y" E

---- 一、建立工程项目

$ C5 S. c1 w3 w) _& }
---- 启动CV++集成开发环境，打开"New"对话框，选中Projects中的
' |/ J7 t. K) K- \# _. h% N/ r"MFC ActiveX Control Wizard", 在Project name 项输入"Dialer"
,在Location 项会生成相应的路径。单击OK钮进入第二步，保留默认值。单击Next
进入最后一步，选中 Invisible at runtime (运行时窗口不可见)，其余保持默认。按Finish
4 ^. [" J2 _& W# p- C) X' Q钮，弹出一个信息对话框，按OK钮完成工程项的创建。
3 {7 h  [' Z8 _" y' ~

---- 二、修改控件图标
# M3 N! j( ~, i% d+ F- s! y3 @+ _* z
; m3 ]" t' ^1 w# n  t% v' d; X
( D+ x9 i# m( H( s; V---- 工程项自动生成一个15 X 15
Bitmap 的位图，该图将在VB
7 n& e) T7 d0 D% \$ |" \  Q/ \的资源工具箱中显示为一个图标。实际上图标可以显示到
25 X 25
大小尺寸的位图。您需要将该位图改为自己的位图。VC++集成开发环境提供绘图工具让您修改。


---- 三、定制控件界面
) `+ ~$ k9 ?6 l2 t$ H: d. Z7 t4 M; A

2 L1 x6 E% ^$ s! q- {----
9 @9 b0 P2 d4 K1 O6 ~% \在应用程序设计时，嵌入的控件会显示一个界面。工程项创建时自动生成一个椭圆例图。在这里我们要去掉画椭圆的代码，并增加如下代码来限制控件窗口的大小及画出控件设计时的显示图标：

/ [! F& I* A/ M8 _, X
& j+ I. P8 ^) [9 s4 Jvoid CDialerCtrl::OnDraw(CDC* pdc,
const CRect& rcBounds, const CRect& rcInvalid)
. u& {! L0 G# W2 R) Q3 o& w0 g{
7 O( u" ~& \2 V1 J& b6 g+ y: l        // TODO: Replace the following code
with your own drawing code.
8 O$ D6 d" W5 M+ J3 D9 R        //pdc- >FillRect(rcBounds,CBrush::FromHandle
/ c) Y% B  d( p" H# l/ x((HBRUSH)GetStockObject(WHITE_BRUSH)));
4 G" [) J& V! g1 I, w: ~- ~        //pdc- >Ellipse(rcBounds);
' i1 l( r/ p: U$ e
/ c& S7 T; g& m* G //限制控件窗口大小
        if (rcBounds.Height!=25 ||
- |& n3 J& [7 T2 O/ |1 Z9 i( @rcBounds.Width!=25)SetControlSize(25,25);
//显示位图
' _: P5 Z1 z; U1 q' Y( T9 a CBitmap bitmap;
CBitmap* pOldBitmap;
CDC MemDC;
, U' \& E* t$ m" D0 R/ h$ x MemDC.CreateCompatibleDC(pdc);
/ j2 ]' O! K1 k0 Q0 d! m bitmap.LoadBitmap(IDB_DIALER);
pOldBitmap=MemDC.SelectObject(&bitmap);
# n' m- E, z4 d2 W9 }' C8 C0 @0 K pdc->BitBlt(0,0,48,48,&MemDC,0,0,SRCCOPY);
) |$ L% o; C7 \ MemDC.SelectObject(pOldBitmap);
: ~7 s# c4 }- y}
1 Q# ~: W& A& a, k
! J3 u5 u! h6 [2 [! a, P8 g

, y- H( Q  c: d5 ~$ R: l---- 四、添加拨号库及头文件
7 L+ |2 R) _2 Q+ w  C

4 R! f4 d( {" V---- 将rasapi32.lib 及 ras.h
加到工程项。


---- 五、添加控件属性


" r4 T5 b! _3 l& E& Q----
我们要在控件中设置一些属性来实现应用程序与控件的传递参数及控制动作。在Class
Wizard 的 Automation 标签中 ， Class name 项选中 CDialerCtrl ,单击
+ _. ^! f' n" b* Q4 K# T2 PAdd Property …按钮,按如下表增加控件属性:
# L9 d! _2 O) k+ ~! n+ \% E  d  f0 U


, _1 I7 q. A) m+ \+ Z2 R

6 E5 \% g7 N7 |/ }" i5 P' ~
) F$ c2 Z! D, M2 c0 F2 q---- 六、增加拨号及收线函数
* O, O: D9 L$ Y  Q: i- ?0 u
% D! Q7 T' e9 X( h. B2 a  l4 n* J. H
bool CDialerCtrl:ialUp(){  //拨号函数
1 v# j) a& s' K$ _; K RASDIALPARAMS rdParams;
rdParams.dwSize = sizeof(RASDIALPARAMS);
  `3 x# I4 U% N& u' X8 F lstrcpy( rdParams. szEntryName, m_netWorking);
- x8 N( l- t5 S  d7 x2 Z        lstrcpy( rdParams.szPhoneNumber, m_phone);
        rdParams.szCallbackNumber[0] = '\0';
! c2 ~* O% x" f# M+ l3 _9 A7 r        lstrcpy( rdParams.szUserName, m_userName );
        lstrcpy( rdParams.szPassword, m_passWord );
1 O7 ?- \% [! |( P        rdParams.szDomain[0] = '*';
7 I1 w/ H! C! i# ?& B. E& C hRasConn = NULL;  //hRasConn
为 HRASCONN 类型的变量；
1 J% R0 ^. p9 w" T DWORD dwRet = RasDial( NULL, NULL,
&rdParams, 0L, NULL, &hRasConn );
- L3 X% b, d( h% z3 E if ( dwRet == 0 )  {m_message="OK!";
m_returnCode = deRet; return true;}
……  //这里省去出错处理代码
return false;
}
% Z3 l- |4 T3 t% C7 E# M3 Zbool CDialerCtrl::HandUp(){ //收线函数
" J) J: U9 c. c; A9 NDWORD dwRet = RasHangUp( hRasConn );
……  //这里省去出错处理代码
return true;
}



/ {5 p4 w6 T6 I5 e" N4 r---- 七、增加动作函数

4 p+ L2 Z3 ?/ c' _6 V$ B
' k$ F# C2 v- a$ t# j8 h! Z---- 控件的Action
! Z. [; l0 W, v9 z/ ^% A  J+ p的值一有改变将自动运行该函数，Action 有两个动作:1.拨号
2.收线。


void CXiaXinDialCtrl::OnActionChanged() {
        // TODO: Add notification handler code
if (m_action==1) DialUp();    //调用拨号函数
if (m_action==2) HandUp();    //调用收线函数
* M  A0 Y9 O7 C! T8 j. I+ J: B+ y        SetModifiedFlag();
" A4 p$ I4 e" k  _0 q( J}

6 T4 q1 t1 W7 L
( D/ m9 u( t. U4 s" \1 _4 o0 d
1 U. k9 C1 b4 D$ K9 R5 `
8 p( `$ P* E8 [7 D3 ^6 D) S/ |---- 八、编译，链接，自动注册
: H# J8 \3 x2 ^  L+ I

---- 启动VC++的建立（build）动作，将实行编译，链接生成
Dialer.ocx 并自动注册到本机。这时您可以启动VB 开发平台
! J8 P! M) D4 `9 ^% A打开 Components 就可以看到刚注册的 Dialer ActiveX Control
( P" M% a+ k% {. E0 j( D. bModule 。
8 ]- _" B% M: c6 H
7 L1 |' E0 j8 r2 Z0 t  _' e; F
5 t4 G6 h! x) o8 u5 _. R2 x  n---- 九、VB 的调用方法
0 @9 y1 `% L2 c8 t; l0 U& q
9 L# ?( _* I& @2 B& q) e3 q
' P2 D" l, Y6 p9 e9 X---- 在VB的开发中，您可以和通用的控件一样使用Dialer.ocx。调用方法如下:
+ l, T  h, e; Y0 R* L
( f# P2 G  }  w* M+ o
: Y7 \  u' i  E, E6 HPrivate Sub Command1_Click()
* t. z% m# u+ Q* x  |, {Dialer1.NetWorking = Text1.Text
, r+ I, e% e5 }Dialer1.UserName = Text2.Text
Dialer1.PassWord = Text3.Text
  B! B/ v0 c& e3 p; n9 b- UDialer1.Phone = Text4.Text
Label5.Caption = "正在拨号..."
Dialer1.Action = 1
Labe15.Caption = Dialer1.Message
5 u* J( K2 z8 H' 如果接通 窗口最小化
If XiaXinDial1.ReturnCode =
0 Then Form1.WindowState = 1
% h, R8 Z# t3 u: I* Y5 I# l; fEnd Sub