WTL

INI 編集ツール IniModifier を作成してみる (3)

RAPT — Sun, 17 Aug 2008 16:20:00 GMT

INI 編集ツール IniModifier を作成してみる (3)

過去の記事へのリンク：
INI 編集ツール IniModifier を作成してみる (1)
INI 編集ツール IniModifier を作成してみる (2)

まずは、WTL::CRichEditCtrl のヘッダを見てみることにする。
WTL は SDK のラッパであり、MFC とほぼ同機能のメソッドを持っているので迷ったら、MSDN で MFC と SDK のヘルプを見るのが常套手段。

WTL::CRichEditCtrl

// WTL::CRichEditCtrl (CRichEditCtrlT<ATL::CWindow>) の宣言

// Constructors

    CRichEditCtrl( HWND hWnd = NULL );

    CRichEditCtrl& operator =( HWND hWnd );

    HWND Create( HWND hWndParent, ATL::_U_RECT rect = NULL, LPCTSTR szWindowName = NULL,

            DWORD dwStyle = 0, DWORD dwExStyle = 0,

            ATL::_U_MENUorID MenuOrID = 0U, LPVOID lpCreateParam = NULL );

// Attributes

    static LPCTSTR GetWndClassName();

    static LPCTSTR GetLibraryName();

    int GetLineCount() const;

    BOOL GetModify() const;

    void SetModify( BOOL bModified = TRUE );

    void GetRect( LPRECT lpRect ) const;

    DWORD GetOptions() const;

    DWORD SetOptions( WORD wOperation, DWORD dwOptions );

    // NOTE: first word in lpszBuffer must contain the size of the buffer!

    int GetLine( int nIndex, LPTSTR lpszBuffer ) const;

    int GetLine( int nIndex, LPTSTR lpszBuffer, int nMaxLength ) const;

    BOOL CanUndo() const;

    BOOL CanPaste( UINT nFormat = 0 ) const;

    void GetSel( LONG& nStartChar, LONG& nEndChar ) const;

    void GetSel( CHARRANGE &cr ) const;

    int SetSel( LONG nStartChar, LONG nEndChar );

    int SetSel( CHARRANGE &cr );

    int SetSelAll();

    int SetSelNone();

    DWORD GetDefaultCharFormat( CHARFORMAT& cf ) const;

    DWORD GetSelectionCharFormat( CHARFORMAT& cf ) const;

    DWORD GetEventMask() const;

    LONG GetLimitText() const;

    DWORD GetParaFormat( PARAFORMAT& pf ) const;

#if ( _RICHEDIT_VER >= 0x0200 )

    LONG GetSelText( LPTSTR lpstrBuff ) const;

#else

    // RichEdit 1.0 EM_GETSELTEXT is ANSI only

    LONG GetSelText( LPSTR lpstrBuff ) const;

#endif

#ifndef _ATL_NO_COM

    BOOL GetSelTextBSTR( BSTR& bstrText ) const;

#endif

#if defined( _WTL_USE_CSTRING ) || defined( __ATLSTR_H__ )

    LONG GetSelText( _CSTRING_NS::CString& strText ) const;

#endif

    WORD GetSelectionType() const;

    COLORREF SetBackgroundColor( COLORREF cr );

    COLORREF SetBackgroundColor();    // sets to system background

    BOOL SetCharFormat( CHARFORMAT& cf, WORD wFlags );

    BOOL SetDefaultCharFormat( CHARFORMAT& cf );

    BOOL SetSelectionCharFormat( CHARFORMAT& cf );

    BOOL SetWordCharFormat( CHARFORMAT& cf );

    DWORD SetEventMask( DWORD dwEventMask );

    BOOL SetParaFormat( PARAFORMAT& pf );

    BOOL SetTargetDevice( HDC hDC, int cxLineWidth );

    int GetTextLength() const;

    BOOL SetReadOnly( BOOL bReadOnly = TRUE );

    int GetFirstVisibleLine() const;

    EDITWORDBREAKPROCEX GetWordBreakProcEx() const;

    EDITWORDBREAKPROCEX SetWordBreakProcEx( EDITWORDBREAKPROCEX pfnEditWordBreakProcEx );

    int GetTextRange( TEXTRANGE* pTextRange ) const;

#if ( _RICHEDIT_VER >= 0x0200 )

    int GetTextRange( LONG nStartChar, LONG nEndChar, LPTSTR lpstrText ) const;

#else

    int GetTextRange( LONG nStartChar, LONG nEndChar, LPSTR lpstrText ) const;

#endif

#if ( _RICHEDIT_VER >= 0x0200 )

    DWORD GetDefaultCharFormat( CHARFORMAT2& cf ) const;

    BOOL SetCharFormat( CHARFORMAT2& cf, WORD wFlags );

    BOOL SetDefaultCharFormat( CHARFORMAT2& cf );

    DWORD GetSelectionCharFormat( CHARFORMAT2& cf ) const;

    BOOL SetSelectionCharFormat( CHARFORMAT2& cf );

    BOOL SetWordCharFormat( CHARFORMAT2& cf );

    DWORD GetParaFormat( PARAFORMAT2& pf ) const;

    BOOL SetParaFormat( PARAFORMAT2& pf );

    TEXTMODE GetTextMode() const;

    BOOL SetTextMode( TEXTMODE enumTextMode );

    UNDONAMEID GetUndoName() const;

    UNDONAMEID GetRedoName() const;

    BOOL CanRedo() const;

    BOOL GetAutoURLDetect() const;

    BOOL SetAutoURLDetect( BOOL bAutoDetect = TRUE );

    // this method is deprecated, please use SetAutoURLDetect

    BOOL EnableAutoURLDetect( BOOL bEnable = TRUE );

    UINT SetUndoLimit( UINT uUndoLimit );

    void SetPalette( HPALETTE hPalette );

    int GetTextEx( GETTEXTEX* pGetTextEx, LPTSTR lpstrText ) const;

    int GetTextEx( LPTSTR lpstrText, int nTextLen, DWORD dwFlags = GT_DEFAULT, UINT uCodePage = CP_ACP, LPCSTR lpDefaultChar = NULL, LPBOOL lpUsedDefChar = NULL ) const;

    int GetTextLengthEx( GETTEXTLENGTHEX* pGetTextLengthEx ) const;

    int GetTextLengthEx( DWORD dwFlags = GTL_DEFAULT, UINT uCodePage = CP_ACP ) const;

#endif

#if ( _RICHEDIT_VER >= 0x0300 )

    int SetTextEx( SETTEXTEX* pSetTextEx, LPCTSTR lpstrText );

    int SetTextEx( LPCTSTR lpstrText, DWORD dwFlags = ST_DEFAULT, UINT uCodePage = CP_ACP );

    int GetEditStyle() const;

    int SetEditStyle( int nStyle, int nMask = -1 );

    BOOL SetFontSize( int nFontSizeDelta );

    void GetScrollPos( LPPOINT lpPoint ) const;

    void SetScrollPos( LPPOINT lpPoint );

    BOOL GetZoom( int& nNum, int& nDen ) const;

    BOOL SetZoom( int nNum, int nDen );

    BOOL SetZoomOff();

#endif

// Operations

    void LimitText( LONG nChars = 0 );

    int LineFromChar( LONG nIndex ) const;

    POINT PosFromChar( LONG nChar ) const;

    int CharFromPos( POINT pt ) const;

    void EmptyUndoBuffer();

    int LineIndex( int nLine = -1 ) const;

    int LineLength( int nLine = -1 ) const;

    BOOL LineScroll( int nLines, int nChars = 0 );

    void ReplaceSel( LPCTSTR lpszNewText, BOOL bCanUndo = FALSE );

    void SetRect( LPCRECT lpRect );

    BOOL DisplayBand( LPRECT pDisplayRect );

    LONG FindText( DWORD dwFlags, FINDTEXT& ft ) const;

    LONG FindText( DWORD dwFlags, FINDTEXTEX& ft ) const;

    LONG FormatRange( FORMATRANGE& fr, BOOL bDisplay = TRUE );

    LONG FormatRange( FORMATRANGE* pFormatRange, BOOL bDisplay = TRUE );

    void HideSelection( BOOL bHide = TRUE, BOOL bChangeStyle = FALSE );

    void PasteSpecial( UINT uClipFormat, DWORD dwAspect = 0, HMETAFILE hMF = 0 );

    void RequestResize();

    LONG StreamIn( UINT uFormat, EDITSTREAM& es );

    LONG StreamOut( UINT uFormat, EDITSTREAM& es );

    DWORD FindWordBreak( int nCode, LONG nStartChar );

    // Additional operations

    void ScrollCaret();

    int InsertText( long nInsertAfterChar, LPCTSTR lpstrText, BOOL bCanUndo = FALSE );

    int AppendText( LPCTSTR lpstrText, BOOL bCanUndo = FALSE );

    // Clipboard operations

    BOOL Undo();

    void Clear();

    void Copy();

    void Cut();

    void Paste();

    // OLE support

    IRichEditOle* GetOleInterface() const;

    BOOL SetOleCallback( IRichEditOleCallback* pCallback );

#if ( _RICHEDIT_VER >= 0x0200 )

    BOOL Redo();

    void StopGroupTyping();

    void ShowScrollBar( int nBarType, BOOL bVisible = TRUE );

#endif

#if ( _RICHEDIT_VER >= 0x0300 )

    BOOL SetTabStops( int nTabStops, LPINT rgTabStops );

    BOOL SetTabStops();

    BOOL SetTabStops( const int& cxEachStop );    // takes an 'int'

#endif

これで大体何ができるか分かった。あとは、実際に使用しそうで使ったことがないメソッドについて詳しくみていくことにする。

GetLibraryName

リッチエディットコントロールを使用するには、最初にリッチエディットコントロールの DLL をロードしておかなければいけないらしい。
リッチエディットコントロールの DLL 名はバージョンによって異なるので（Ver1.0 は RICHED32.DLL で、Ver2.0 以降は RICHED20.DLL）、このメソッドを使うことでその違いを CRichEditCtrl がプリプロセス時点で解決してくれる。

// IniModifier.cpp

int WINAPI _tWinMain( HINSTANCE, HINSTANCE, LPTSTR, int )

{

    HMODULE hRich = ::LoadLibrary( CRichEditCtrl::GetLibraryName() );

    // snip

    ::FreeLibrary( hRich );

    return nRet;

}

SetSelectionCharFormat

現在の選択のテキストの文字書式属性を設定する。
なお、選択範囲がない場合は、以降の入力についての設定となる。

// CRichEditCtrl m_rich;

// テキストを青色太字にして保護にする

CHARFORMAT cf;

cf.dwMask = CFM_PROTECTED | CFM_COLOR | CFM_BOLD;

cf.dwEffects = CFE_PROTECTED | CFE_BOLD;

cf.crTextColor = RGB( 0, 0, 255 );

m_rich.SetSelectionCharFormat( cf );

SetEventMask

親ウィンドウに送る通知メッセージを指定する。

ENM_PROTECTED: 保護領域を編集しようとした時に WM_NOTIFY メッセージで EN_PROTECTED が通知されるようにする。
0 を返すと変更許可、非0 を返すと変更禁止とする。
ENPROTECTED* pProtected = reinterpret_cast< ENPROTECTED* >( reinterpret_cast< LPNMHDR >( lParam ) ); としたとき、
pProtected->msg に、この通知発生原因のメッセージ ID が入っている。
pProtected->chrg.cpMin と pProtected->chrg.cpMax に、この通知発生元のインデックス（リッチエディットコントロール先頭位置からのオフセット）が入っている。
ENM_KEYEVENTS: キーボードイベントが発生した時に WM_NOTIFY メッセージで EN_MSGFILTER が通知されるようにする。
0 を返すと通常のイベントを処理する。非0 を返すと以降のイベント処理を無視する。
MSGFILTER* pFilter = reinterpret_cast< MSGFILTER* >( reinterpret_cast< LPNMHDR >( lParam ) ); としたとき、
pFilter->msg に、この通知発生原因のメッセージ ID が入っている。
ENM_MOUSEEVENTS: マウスイベントが発生した時に WM_NOTIFY メッセージで EN_MSGFILTER が通知されるようにする。
EN_MSGFILTER の動作については、ENM_KEYEVENTS と同じ。

m_rich.SetEventMask( ENM_PROTECTED | ENM_KEYEVENTS | ENM_MOUSEEVENTS );

INI 編集ツール IniModifier を作成してみる (2)

RAPT — Sat, 16 Aug 2008 01:23:00 GMT

INI 編集ツール IniModifier を作成してみる (2)

過去の記事へのリンク：
INI 編集ツール IniModifier を作成してみる (1)

リソース配置が楽なのでダイアログベースで作ることにする。
とりあえずリソースエディタで適当にコントロールを配置して、UI を決める。
ダイアログの自動リサイズを実装するため、CDialogResize も継承しておく。

class CMainDlg

    : public CDialogImpl< CMainDlg >

    , public CDialogResize< CMainDlg >

{

テキストを編集したり色をつけたりしたいので、リッチエディットコントロールを使ってみようと思う。リッチエディットコントロールを使うのはこれが初めてだが、WTL のヘッダを見ていると結構いろいろできそうなので、せっかくなので調べながら作っていくことにする。

リソースエディタのイメージはこんな感じ↓

リッチエディットコントロールは 2.0 を使うこととする。
CDialogResize は atlframe.h
CRichEditCtrl は atlctrls.h
にそれぞれ定義されているので、stdafx.h は下記のようになった。

// stdafx.h

// Change these values to use different versions

#define WINVER          0x0500

#define _WIN32_WINNT    0x0501

#define _WIN32_IE       0x0501

#define _RICHEDIT_VER   0x0200

// WTL よりも ATL を優先する場合は、atlapp.h より前に include すること

#include <atlstr.h>

#include <atltypes.h>

#include <atlbase.h>

#include <atlapp.h>

extern CAppModule _Module;

#include <atlcrack.h>

#include <atlframe.h>  // CDialogResize

#include <atlctrls.h>  // CRichEditCtrl

#include <atldlgs.h>   // CFileDialog

処理の関係上、文字セットは UNICODE ではなく、マルチバイト文字セット(MBCS) でビルドすることにする。

// stdafx.cpp

#if defined( _UNICODE ) || defined( UNICODE )

#error This program doesn't assume unicode build.

#endif

# ところで、なぜ #error ディレクティブではマルチバイト文字が使えないんだろ。
# ダブルクォーテーションで括ってやってもだめ。L"" としてもだめ。何かうまくいくようにしてくれるといいんだけど。

INI 編集ツール IniModifier を作成してみる (1)

RAPT — Sat, 16 Aug 2008 00:18:00 GMT

IniModifier

Inno Setup のフロントエンドである ISTool の日本語言語ファイル作成をしたりしているが、INI 形式のファイルをアップデートが非常にめんどくさすぎるので何かツールを作成しようと思う。

開発環境は以下の通り。

Windows XP sp2
Visual C++ .NET 2003 sp1
WTL 8.0

要件仕様は下記の通りとする。

ファイルのエンコーディングは SJIS/UTF-8 に対応。（できれば EUC も対応。）
セクション名・キー名で差分チェックを行う。
Visual SourceSafe の比較画面のように見比べつつ編集もできるようにする。
セクション：[太字表示]
コメント：緑色表示
追加されたセクション・キー：青色表示
削除されたセクション・キー：赤色表示
削除されたキー：キーの先頭に ";<DEL>:" を追加。

IniModifier の完成イメージはこんな感じ↓

localtime の罠

RAPT — Sun, 28 Jan 2007 03:27:00 GMT

Cランタイムの標準関数 localtime() について。
これは時刻をタイムゾーンに合わせて現地時刻に変換したもの取得するものだが、NULL を返すことがある。
これを忘れてエラーチェックを忘れるとランタイムエラーでプログラムが強制終了してしまう。

日時を取得する別の手段として、Windows API で処理することができる。
こちらは、localtime() 関数と違って、年数や月数の調整が不要で変数名も分かりやすいのでオススメなのだ。

void test1() { TCHAR szNow[ 100 ] = { 0 }; time_t long_time; time( &long_time ); tm* t = localtime( &long_time ); if ( t != NULL ) { // Cランタイムを使用 wsprintf( szNow, _T( "%04d/%02d/%02d %02d:%02d:%02d" ) , 1900 + t->tm_year , 1 + t->tm_mon , t->tm_mday , t->tm_hour , t->tm_min , t->tm_sec ); } else { // Windows API を使用 SYSTEMTIME st; ::GetLocalTime( &st ); wsprintf( szNow, _T( "%04d/%02d/%02d %02d:%02d:%02d" ) , st.wYear , st.wMonth , st.wDay , st.wHour , st.wMinute , st.wSecond ); } ::MessageBox( NULL, szNow, _T( "現在時刻" ), MB_OK ); }

ところで、例えば１週間前の日時を取得したいときはどうするのだろうか。
今の日時が 8 日以降なら問題ない。-7 すればいいだけなのだから。
しかしながらこの方法はそのまま採用できない。
実際には、1～7 日の場合も検討に入れねばならず、月の計算やうるう年など複雑な計算を要することもあるからである。

さて、Cランタイムを使って処理する場合、tm 構造体の中身を編集して、mktime() 関数を呼び出すと
その値を再構成してくれる。その値が 0 以下であっても適切に変換してくれるので便利だ。

ところが、これを Windows API だと、うまい方法が見当たらない。
今の所、一度 FILETIME に変換して 100 ナノ秒単位で加減して、SYSTEMTIME に再変換する
といった手順で計算しているけど、もっと良い方法はないのだろうか。

void test2() { TCHAR szNow[ 100 ] = { 0 }; time_t long_time; time( &long_time ); tm* t = localtime( &long_time ); if ( t != NULL ) { // Cランタイムを使用 t->tm_mday -= 7; long_time = mktime( t ); t = localtime( &long_time ); if ( t != NULL ) { wsprintf( szNow, _T( "%04d/%02d/%02d %02d:%02d:%02d" ) , 1900 + t->tm_year , 1 + t->tm_mon , t->tm_mday , t->tm_hour , t->tm_min , t->tm_sec ); } } if ( t == NULL ) { // Windows API を使用 SYSTEMTIME st; ::GetLocalTime( &st ); FILETIME ft; ATLVERIFY( ::SystemTimeToFileTime( &st, &ft ) ); __int64 nTime = __int64( ft.dwHighDateTime ) << 32 | ft.dwLowDateTime; nTime -= 10000000ULL /*100ns*/ * 60 /*sec*/ * 60 /*min*/ * 24 /*hour*/ * 7 /*day*/; ft.dwHighDateTime = DWORD( nTime >> 32 ); ft.dwLowDateTime = DWORD( nTime & 0xFFFFFFFF ); ATLVERIFY( ::FileTimeToSystemTime( &ft, &st ) ); wsprintf( szNow, _T( "%04d/%02d/%02d %02d:%02d:%02d" ) , st.wYear , st.wMonth , st.wDay , st.wHour , st.wMinute , st.wSecond ); } ::MessageBox( NULL, szNow, _T( "1週間前の時刻" ), MB_OK ); }

※なお、上記サンプルでは time() 関数で現在時刻を取得しているので、NULL になることはまずないと思われるが、
時間をファイルに読み書きしている場合に不正な時刻変換を行なおうとしてしまうことがありうる。
実はそれこそが不正終了の一因だったりして(^^;

CString::AppendFormat

RAPT — Fri, 24 Nov 2006 02:19:00 GMT

# まー、今更ですが。

自宅にある VC2003 で WTL7.5 final を入れて、新しい WTL の中身と ATL の中身を眺めていた時の話。

ATL::CString::AppendFormat() が増えていて便利ーと思った。
CString 使っていると、整形文字列を追加したいことがよくあるので、そのたびに一時オブジェクトを作って
CString::operator+=() していたので。

しかしなぜかこのメソッドが WTL7.5 になかった。
ATL に比べてこれだけ外す理由が思いつかないのだけど。

VC++6/WTL7.0 の頃は、MFC::CString に対して、WTL::CString::Append( int n ) があって優位だったのに…。

なぜ実装しなかったのかは謎だが、まぁ、WTL はオープンソースなヘッダ群なので早速、
WTL::CString::AppendFormat() を作成しました。
実際のところは、WTL::CString のメソッドを順番に呼ぶだけなのでそんなに難しくはなく。

※宣言は省略。定義だけ。なお、変数名は WTL の流儀にあわせてあります。

// [atlmisc.h] // UDT RAPT : like ATL::CString::AppendFormat inline BOOL __cdecl CString::AppendFormat( LPCTSTR lpszFormat, ... ) { ATLASSERT( _IsValidString( lpszFormat ) ); va_list argList; va_start( argList, lpszFormat ); CString string; BOOL bRet = string.FormatV( lpszFormat, argList ); va_end( argList ); operator += ( string ); return bRet; } // ENDE