EditLog类的使用

下载：

http://www.vrixpzone.com/zone2/codeRepo/vc/EditLog_src.zip

要解决的问题:

我曾经想使用EDIT控件来快速的处理异步文本输出。我需要在很多线程里记录大量的信息。有时候每秒1000个Log信息。自从我创建了一些函数把我要的对象信息输出到 std::cout ，我也想吧edit控件作为std::ostream.

特点:

• 异步, 快速的输出信息到任何的edit 控件
• 你可以在打印信息的时候查看记录，选择和复制文本等等。
• 可以支持MFC和飞MFC程序
• 使用了子类化，你可以把任何CEdit派生出的类和一同使用
• 支持多线程
• 类basic_streambuf用来创建和 重定向 std::ostream (such as std::cout)的输出到 edit控件

使用CEditLog

创建CEditLog 的一个实例并通过SetEditControl() 方法把它和EDIT控件绑定，然后你就可以用AddText() 成员函数来添加一些文本到EDIT控件了。

class CEditLog : protected CSubclassWnd
{
public:
typedef CSubclassWnd root_type;

// Constructs the CEditLog. You can pass the edit controls handle
// here or set it later using the SetEditCtrl() function.
// To increase performance CEditLog repaints the edit-control
// only if the caret resides in the last line. Otherwise the
// control will be refreshed only every nMaxRefreshDelay msec.
CEditLog( HWND hEdit = NULL, UINT nMaxRefreshDelay = 500 );

// Adds some text to the end of the edit control. Works asynchronously
// (using PostMessage()) and is save to be called by multiple threads.
// If you pass true for bLFtoCRLF every LF (ASCII 10) (as it is used in
// most cases for end-of-line) will be converted to a CR/LF (ASCII 10/13)
// sequence as it is needed by the windows edit control.
virtual void AddText( LPCWSTR pwszAdd, bool bLFtoCRLF = false );

// Converts pszAdd to UNICODE and calls the above
void AddText( LPCSTR pszAdd, bool bLFtoCRLF = false );

// Sets the edit-control to be used for logging.
// Pass NULL to stop text logging.
virtual void SetEditCtrl( HWND hEdit );

HWND GetEditCtrl() const

...
};

实例代码说明

实例代码中演示了CEditLog的用法以及basic_editstrbuf如何重定向std::cout 到EDIT控件.

CEditLog 用到了William E. Kempf写的CSubclassWnd类，实例代码中也包含了CSubclassWnd 类

-------------以上翻译由vrix.yan完成于2007.09.30 21:18

在使用此类的过程当中，我总结了一下的步骤:

1>将实例工程中的code子目录，复制到你的工程目录中

2>在你的对话框xxDlg.h 里引入头文件，并定义一些变量

#include "EditLog.h"
#include "editlog_stream.h"

// The logger object
CEditLogm_EditLogger;
// ANSI and UNICODE stream buffers for the EditLogger
std::editstreambufm_EditStrBuf;
std::weditstreambuf m_EditStrBufW;

// Used to save the previos values for cout and wcout
std::basic_streambuf<char>*m_pOldBuf;
std::basic_streambuf<wchar_t>*m_pOldBufW;

3>在你的stdafx.h中加入

// Include core STL header
#include <string>
#include <streambuf>
#include <iostream>

4>在你的xxDlg.cpp 中记得添加一下的代码

CEditLogDlg::CEditLogDlg(CWnd* pParent /*=NULL*/)
: CDialog(CEditLogDlg::IDD, pParent), m_EditStrBuf( m_EditLogger ), m_EditStrBufW( m_EditLogger )

5>在你的xxDlg.cpp里面OnInitDialog初始化

//设置EDIT控件为LOG的目标
m_EditLogger.SetEditCtrl( m_ctrlEdit.m_hWnd ); //记得要先定义Edit 控件

// 重定向cout的输出到 Edit控件
m_pOldBuf = cout.rdbuf( &m_EditStrBuf );
// unicode版本
m_pOldBufW = wcout.rdbuf( &m_EditStrBufW );

//用法
cout << "cout (ANSI) works :-)" << endl;
wcout << L"wcout (UNICODE) works also ;-)" << endl;
cout << "/n/n";

6>在你的WM_DESTROY消息里加入

void CEditLogDlg::OnDestroy()
{
// Restore the previous stream state for cout and wcout
cout.rdbuf( m_pOldBuf );
wcout.rdbuf( m_pOldBufW );

CDialog::OnDestroy();
}

我通过以上的步骤，成功的在我的程序里使用了EDITLOG类，希望对大家有所帮助。

vrix.yan 2007年09月30日晚 21点30分 写于 东莞