改变VC++应用程序窗口的标题

上海卢湾区业余大学      邵祖铭

摘  要:讨论基于MFC类库的Windows应用程序设计中,应用程序各种标题的改变方法。

关键词:MFC Windows编程标题Visual C++

0 引言

有一个演示VC++中的消息处理的单文档应用程序。该程序开始运行的情况如下:

窗口中的初始文档标题竞显示为Untitled,实在不尽人意。

有些时候, 确实需要改变自编Windows应用程序窗口的标题。比如,想编一个标题名为"Communication soft的软件。虽然在Windows95或Windows NT下,Visual C++(以下简称VC)可以生成以"Communication soft为名的工程,但该工程下的C++类的名称也要带上这么多的字符,给编程带来不便。可以采用的方法是生成以"CS为名的工程,再把程序的标题改成 "Communication Soft。再比如,在多文档应用程序中,希望每个子窗口的标题并不是"主窗口标题t、"主窗口标题2 ” ……这种类型,而是象"COM1速率"、"LPT并行口"……,即子窗口标题与主窗口标题无关。这时都需要改变各种窗口标题。下面介绍一下改变窗口标题所用的方法,所用的开发平台是usual C++5.0。

1 单又挡接口(SDI)典型窗口标题的改变

首先,来看看Windows SD!类型窗口标题栏的结构形式。用VC的AppWizard创建一个名为"Exam9的单文档类型的工程。开始运行时,程序主窗口标题形式如下:

Untitled-Exam9

其中"Untitied"为文档标题,"Exam9"为主窗口标题。当用"File-Open ” 打开"wd1.exm"文裆以后,文档标题变为"wd1.exm"。

所以程序主窗口标题栏的一般形式为:

文裆标题----主窗口标题

1.1 又档标题的改变

既然文档标题是由工程中相应的文档类所控制的,了解这一点,就可在相应的文档类中,利用SetTitle()函数来改变文档标题。

例：改变CExam9Doc::onNewDocument()函数为:

BOOL CExam9Doc::OnNewDocument()

{

if(!CDocument::OnNewDocument())

return FALSE-

SetTitle("文档标题");

return TRUE;

}

运行程序,则每次选择选单中的"文件"的"新建"选项时,标题就变成"文档标题-Exam9 ”

1.2 主窗口标题的改变

主窗口的标题默认是工程的文件名,正如前面Appvvazied生成的Exam9工程执行后,标题栏的形式总为"文档标题-Exam9。

改变主窗口的标题方法有两种:

第一种方法:利用ResourceView打开工程的资源,修改String Table中的

IDR_MAINFRAME的值。将原来的"Exam9\n\nExam9\nEXMFile(*.exm)\n.exm\nExam9.Document\nExam9 Document"改为"标题改变示例

\n\nExam9\nEXM File(*.exm)\n.exm\nExam9.Document\nExam9 Document"。这样改变后,主窗口标题就变为"-标题改变示例"。第二种方法:具体改变方法如下:

改变 CMainFrame的成员函数PreCreateWindowO为:

BOOL CMainFrame::PreCreateWindow(CREATESTRUCT&cs)

{

m_strTitle="上海市卢湾区业余大学 ” ;

return CFrameWnd::PreCreateWindow(cs);

}

这样改变后,主窗口标题的形式就为"-上海市卢湾区业余大学"。

M_strTile是CFrameWnd的保护成员(要得到m_strTile更详细的信息,请打开\msdev\mfc\include\afxwin.h文件)。CMainFrame则是CFrameWnd类的派生类。

在这两种改变方法中,第二种方法优先级高。也就是说,改变了m_strTitle的值后,IDR_MAlNFRAME的值就不起作用。

2 对多文挡接口(MDI)类型窗口标题的改变

在MDI类型窗口中,主窗口标题和文档标题的次序,和SDl类型窗口中次序是不同的。结合具体例子说明,用VC的AppWizard创建一个名为"MDITitle"的多文挡类型的工程。创建完工程后,编译运行该工程,主窗口标题形式如下:"主窗口标题-文档标题"。

2.l 文挡标题的改变

MDI类型窗口的文档标题也是由相应的文档类控制的。改变方法同SDI类型窗口类似,要改变标题,只要在相应的文档类中利用SetTitle()函数来改变文档标题。

2.2 主窗口标题的改变

MDI类型主窗口标题的改变方法同SDI类型窗口类似。改变主窗口标题也有两种方法,通过改变IDR_MAINFRAME或m_strTitle的值就可实现改变主窗口标题的目的。同样,改变了m_strTitle值后,IDR_MAINFRAME的值就不起作用。

2.3 子窗口标题的改变

在默认情况下,MFC自动将子窗口标题设为该子窗口所打开的文档标题。但实际上,子窗口标题与该子窗口标题所打开的文档标题可以不一样。可做如下改动:

利用ResourceView打开资源,修改String Table中的IDR_MAINFRAME的值为"上海市卢湾区业余大学",使得主窗口标题变成"上海市卢湾区业余大学"。

并将BOOL CMDlTitleDoc::OnNewDocument()函数改为:

BOOL CMDlTitleDoc::OnNewDocument()

{

if(!CDocument::OnNewDocument())

return FALSE;

static int count=0;

char message[10];

wsprintf(message,"%s%d","文档",count);

SetTitle(message);

count++;

return TRUE;

}

通过以上修改,主窗口标题栏被设置为:文档标题为"上海市卢湾区业余大学-文挡0"、"上海市卢湾区业余大学-文档1 ” ……

一下针对子窗口标题的修改作如下改动:

将CChildFrame::PrecreateWindow()函数改为:

BOOL CChiidFrame::PrecreateWindow(CREATESTRUCT&cs)

cs.style &=~(LONG)FWS_ADDTOTlTLE;

return CMDIChildWnd::PrecreateWindow(cs);

}

要改变窗口类型, 这步工作必须做。常量问FWS_ADDTOTITLE是在文件\msdev\mfc\include\afxwin.h中定义。

在 CMDlTitleView类中增加OnlnitialUpdate()函数:

void CMDlTitleView::OnlnitiaiUpdate()

{

CView::OninitialUpdate();

Getparent()-〉SetWindowText(GetDocument()-)GetTitle()+ ” -上海卢湾区业余大学 ” );

}

这样,子窗口的标题栏的形式就为"文档名-上海卢湾区业余大学"。

参考资料:

[1]Michaei Morrison:Sams Tech Yourself MFC in 24Hours

[2]David krugiinski:Programming Microsoft Visual C++,FiHh Edition

[3]Kate Gregory:Special Edition Using Visual C++5

1. 添加CToolTipCtrl成员变量 m_tt。

2. 在父窗口中调用EnableToolTips(TRUE);
   

3. 在窗口的OnCreate（或者其他适当的位置）中向ToolTip中添加需要显示Tip的子窗口，并同时指定相应的显示字串CToolTipCtrl::AddTool(pWnd,"string to display")。
   

4. 重载父窗口的 BOOL PreTranslateMessage(MSG* pMsg) ，在函数中调用 m_tt.RelayEvent(pMsg)。

				在类定义中添加变量说明：

class CWndYour:xxx
{
	CToolTipCtrl m_tt;
}

在OnCreate中添加需要显示Tip的子窗口
CWndYour::OnCreate(....)
{
	EnableToolTips(TRUE);
	m_tt.Create(this);
	m_tt.Activate(TRUE);
	CWnd* pW=GetDlgItem(IDC_CHECK1);//得到窗口指针
	m_tooltip.AddTool(pW,"Check1");//添加
........

}

在BOOL PreTranslateMessage(MSG* pMsg)中添加代码
BOOL CWndYour::PreTranslateMessage(MSG* pMsg)
{
	{
		m_tt.RelayEvent(pMsg);
	}
	return CParentClass::PreTranslateMessage(pMsg);
}

		

这样当鼠标移动到相应的子窗口上时会显示出相应的ToolTip。

1. 上面所讲的1、2、4步骤。
   
2. 在增加ToolTip时不指定显示的字串，而是使用LPSTR_TEXTCALLBACK。
   
3. 在窗口中增加消息映射 ON_NOTIFY_EX( TTN_NEEDTEXT, 0, SetTipText )。

4. 在窗口中增加一个函数用于动态提供显示内容，其原型为 BOOL SetTipText( UINT id, NMHDR * pTTTStruct, LRESULT * pResult )，下面的代码可以根据传入的参数判定应该显示的内容。

				BOOL CWndYour::SetTipText( UINT id, NMHDR * pTTTStruct, LRESULT * pResult )
{
	TOOLTIPTEXT *pTTT = (TOOLTIPTEXT *)pTTTStruct;    
	UINT nID =pTTTStruct->idFrom; //得到相应窗口ID，有可能是HWND
	if (pTTT->uFlags & TTF_IDISHWND)    //表明nID是否为HWND
	{
	        nID = ::GetDlgCtrlID((HWND)nID);//从HWND得到ID值，当然你也可以通过HWND值来判断
		switch(nID)
		case(IDC_YOUR_CONTROL1)        
			strcpy(pTTT->lpszText,your_string1);//设置
			return TRUE;
		break;
		case(IDC_YOUR_CONTROL2)
			//设置相应的显示字串
			return TRUE;
		break;
	}
	return(FALSE);
}
		

在MFC程序中如果使用默认的状态栏的话，其第一栏在空闲时显示的是“就绪”，如果用户点击菜单，还会用于显示菜单栏的提示文本，如“建立新文档”等。有时候我们不希望程序在状态栏中显示这些东西，那该怎么办呢？

在MFC中，是用主框架类中的CStatusBar对象m_wndStatusBar来管理状态栏的。CStatusBar中有一个SetPaneText的函数可用于设置状态栏中的文字。我们在CMainFrame类中的OnCreate函数中添加

m_wndStatusBar.SetPaneText(0, "Hello");

则程序启动后，状态栏上显示的文字为“Hello”。但是当我们点击菜单后，会发现这段文字会消失，被替换成菜单的提示文本；若菜单操作结束，则又显示成“就绪”了。那该如何禁止MFC自动修改状态栏文本呢？

我们再看看主框架类的源程序。当中有这么一段

static UINT indicators[] =
{
ID_SEPARATOR,
ID_INDICATOR_CAPS,
ID_INDICATOR_NUM,
ID_INDICATOR_SCRL,
};

而在OnCreate中有这么一段

m_wndStatusBar.SetIndicators(indicators, sizeof(indicators)/sizeof(UINT)))

这一句的作用是设置状态栏各部分的ID，默认的ID由indicators数组指定。由于MFC中把状态栏的第一栏设置为ID_SEPARATOR 了，这是一个MFC默认的ID，所以它有一系列默认的操作，如显示“就绪”二字。我们想禁止MFC自动操作状态栏就必须修改indicators数组。

我们打开Resource View，修改String Table，找到那堆ID_INDICATOR开头的，在后面新加一个ID_INDICATOR_1。然后修改CMainFrame中indicators的声明

static UINT indicators[] =
{
ID_INDICATOR_1,
ID_INDICATOR_CAPS,
ID_INDICATOR_NUM,
ID_INDICATOR_SCRL,
};

然后编译运行程序。我们会发现，MFC不会再自动修改状态栏的文本了，可是前面添加的一句
m_wndStatusBar.SetPaneText(0, "Hello");
也不起作用了。这是为什么呢？

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vccore/html/_core_status_bars.3a_.updating_the_text_of_a_status.2d.bar_pane.asp
MSDN上有一篇介绍如果修改状态栏文本的文章。当中有一句

Note   The SetText approach is recommended. It is possible to perform this task at a slightly lower level by calling the CStatusBar member function SetPaneText. Even so, you still need an update handler. Without such a handler for the pane, MFC automatically disables the pane, erasing its content.

意思大概是如果我们不为状态栏添加UPDATE的处理函数，MFC会自动禁止状态栏的该栏(pane)。按照MSDN的说法，我们需要增加UPDATE的处理函数。在MainFrm.h中添加

afx_msg void OnUpdate1(CCmdUI *pCmdUI);

在MainFrm.cpp中添加

ON_UPDATE_COMMAND_UI(ID_INDICATOR_1, OnUpdate1)

void CMainFrame::OnUpdate1(CCmdUI *pCmdUI)
{
 pCmdUI->Enable();
}

这样我们就可以往状态栏的第一栏写文字，而避开MFC对其的自动修改了。

       BOOL CMainWnd::PreCreateWindow(CREATESTRUCT& cs)
      {
             WNDCLASS wndcls;
 
             ZeroMemory( &wndcls, sizeof(WNDCLASS) );
             wndcls.style   = CS_DBLCLKS;
             wndcls.lpfnWndProc  = AfxWndProc;
             wndcls.hInstance  = AfxGetInstanceHandle();
             wndcls.hIcon   = theApp.LoadIcon( IDR_MAINFRAME );
             wndcls.hCursor   = theApp.LoadStandardCursor( IDC_ARROW );
             wndcls.hbrBackground = NULL;
             wndcls.lpszMenuName  = NULL;
             wndcls.lpszClassName = _T("MyMainWnd");
 
             AfxRegisterClass( &wndcls );
 
             cs.lpszClass = wndcls.lpszClassName;
 
             return CMDIFrameWnd::PreCreateWindow( cs );
      }

二 主窗口为CDialog的派生类

       第一步 在BOOL CMyApp::InitInstance()中 声明Dialog对象之前添加

                  WNDCLASS wndcls;
                  ::GetClassInfo( AfxGetInstanceHandle(), "#32770", &wndcls );
                  wndcls.lpszClassName = _T("MyDialog");
                  AfxRegisterClass( &wndcls );

      第二步  有两种方法

             a  直接修改××.rc文件

                  IDD_MY_DIALOG DIALOGEX 0, 0, 319, 152
                  STYLE DS_SETFONT | DS_MODALFRAME |  ……
                  EXSTYLE WS_EX_APPWINDOW
                  CAPTION "Lottery2"
                  CLASS "MyDialog"//添加此行即可
                  FONT 9, "MS Shell Dlg", 0, 0, 0x1

             b  修改属性
                 在IDE中修改××.rc属性 vc6 取消Enable MFC features

                                                    .net  Mfc mode = FALSE

                 在Dialog属性中的class name 项中 输入 MyDialog即可


参考：VC++中定制个性化的对话框窗口类 http://blog.csdn.net/chinawash/archive/2006/06/25/832338.aspx

__declspec(dllexport)与.def文件


在VC++中，如果生成DLL可以不使用.def文件。只需要在VC++的函数定义前要加__declspec(dllexport)修饰就可以了。但是使用__declspec(dllexport)和使用.def文件是有区别的。如果DLL是提供给VC++用户使用的，只需要把编译DLL时产生的.lib提供给用户，它可以很轻松地调用你的DLL。但是如果DLL是供VB、PB、Delphi用户使用的，那么会产生一个小麻烦。因为VC++对于__declspec(dllexport)声明的函数会进行名称转换，如下面的函数：
    __declspec(dllexport) int __stdcall IsWinNT()
    会转换为IsWinNT@0，这样你在VB中必须这样声明：
    Declare Function IsWinNT Lib "my.dll" Alias "IsWinNT@0" () As Long
    @的后面的数由于参数类型不同而可能不同。这显然不太方便。所以如果要想避免这种转换，就要使用.def文件方式。
    EXPORTS后面的数可以不给，系统会自动分配一个数。对于VB、PB、Delphi用户，通常使用按名称进行调用的方式，这个数关系不大，但是对于使用.lib链接的VC程序来说，不是按名称进行调用，而是按照这个数进行调用的，所以最好给出。如：
EXPORTS 
test @1 

  vc的dll，delphi调用的方法：

////K9RtExpr.h
extern "C" __DECDLL
unsigned int _stdcall K9RtSysInterrupt(int nInterruptTag);

extern "C" __DECDLL
unsigned int _stdcall K9RtSysExprm(unsigned int nModuleTag,
           float fTimeout,  
           void * pTestPar, 
           void * pResultPar 
           );

// K9RtExpr.cpp
#include "K9RtExpr.h"
#include "RtCtrl.h"
extern "C" __DECDLL
unsigned int _stdcall K9RtSysInterrupt(int nInterruptTag)
{
 return CRelayTestControl::Instance()->InterruptTest(nInterruptTag);
}
extern "C" __DECDLL
unsigned int _stdcall K9RtSysExprm(unsigned int nModuleTag,
           float fTimeout,   
           void * pTestPar, 
           void * pResultPar 
           )
{
 return CRelayTestControl::Instance()->RelayTest(
      nModuleTag, fTimeout, pTestPar, pResultPar);
}

///K9RtExpr.def
LIBRARY      "K9RtExpr"
DESCRIPTION  K9RtExpr Windows Dynamic Link Library'

EXPORTS
K9RtSysInterrupt
K9RtSysExprm
    ; Explicit exports can go here


//delphi   调用文件
unit InterfaceFunc;

interface

uses
   UnitData,Types;
  
function K9RtSysExprm(nModuleTag:integer  ;
                        uTimeout:integer;
                        pTestPar:Pointer;
                        pResultPar:Pointer) : Integer; stdcall;

function K9RtSysInterrupt(nInterruptType:Integer) : Integer; stdcall;

implementation
const DLLPATH  = 'RtBsExpr.dll';
function K9RtSysExprm; external DLLPATH  name  'ExperimentRelayTest';
function K9RtSysInterrupt; external DLLPATH  name 'InterruptRelayTest';

end.

VC 双缓冲绘图

BOOL CGraphDlg::OnDraw(CDC* pDC)

{

       CRect rc;

       GetClientRect(&rc); 

       CDC  MemDC;

       CBitmap  MemBitmap;  

       MemDC.CreateCompatibleDC(NULL);      

       MemBitmap.CreateCompatibleBitmap(pDC, rc.Size().cx,rc.Size().cy);

       CBitmap *pOldBit=MemDC.SelectObject(&MemBitmap);      

       MemDC.BitBlt(0,0,rc.width, rc.height, pDC,0,0,SRCCOPY);

       m_pGraph->SetGraphDC(&MemDC);

       m_pGraph->DoGraphShowEvent();  

       pDC->BitBlt(0,0, rc.Size().cx,rc.Size().cy,&MemDC,0,0,SRCCOPY);  

       MemDC.SelectObject(pOldBit);

       MemBitmap.DeleteObject();

       MemDC.DeleteDC();

}

Delphi 双缓冲绘图：

procedure TBkCoordi.Draw(Canvas : TCanvas);

var

    _bmp : TBitmap;

    _width, _height : integer;

    _top, _left : integer;

begin

    _width := Round(m_width);

    _height := Round(m_height);

    _left := Round(m_topleft.x);

    _top := Round(m_topleft.y);

    _bmp := Tbitmap.Create;

    _bmp.Handle := CreateCompatibleDC(Canvas.Handle);

    _bmp.Width :=  _width;

    _bmp.Height :=  _height;

    BitBlt(_bmp.Canvas.Handle,0,0,_width,_height, Canvas.Handle,_left,_top,SRCCOPY);

    if m_showcross then m_cross.Draw(_bmp.Canvas);

    if @OnDrawing <> nil then OnDrawing(_bmp.Canvas);

    BitBlt(Canvas.Handle,_left,_top,_width,_height, _bmp.Canvas.Handle,0,0,SRCCOPY);

    _bmp.Free;

end;