<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<html>

<head>
<meta http-equiv="Content-Language" content="ja">
<meta http-equiv="Content-Type" content="text/html; charset=Shift_JIS">
<link rel="stylesheet" type="text/css" href="../../default.css">
<title>ATL のクラスを使ってみる</title>
</head>

<body>
<!--#include virtual="../../menu2.html"-->

<div class="contents">
<h4>contents</h4>
<ol>
	<li><a href="#strings">文字列</a></li>
	<li><a href="#pointer">スマートポインタ</a></li>
	<li><a href="#collection">コレクション</a></li>
	<li><a href="#file">ファイル処理</a></li>
	<li><a href="#window">ウィンドウ</a></li>
</ol>
</div>

<h1>ATL のクラスを使ってみる</h1>

<!--- Summary --->
<div>
	<p>
		MSDNを見ていると、ATL/ATL Server に属する便利そうなクラスがいくつか見つかります。
		STLと重なる部分もありますが、Windows用途に特化されていますので、より便利な部分もあるようです。
	</p>
</div>

<h2 id="intro">はじめに</h2>
<div>
	<p>
		私はWTLから入ったので、ATL/COMのことがほとんどわかってません。
		（WTLはテンプレートがわかっていればATLを知らなくても使えてしまいますし。）
		おかしなところもあると思いますが、ご容赦ください。
		コンセプトは、「とりあえずヘッダをインクルードするだけみたいなんで使ってみよう」です。
	</p>
</div>


<h2 id="string">文字列</h2>
<div>

	<h3>CStringT &lt; CharType, StringTraits &gt;</h3>
	<div>
		ヘッダ : atlstr.h<br>
		依存関係 : CRT (optional)
		<p>
			既存の MFC::CString とインタフェース互換の文字列。
			std::string に比べ、内部バッファの取得ができるのと、<code>operator const CharType*</code>が定義されているのが大きな違い。
			また、StringTraits のおかげでCRTを使わない場合でも様々な文字列処理関数が使えるのがメリット。
			std::iostream と組み合わせる必要が無ければ、std::string よりも使い勝手がよいと思われる。
		</p>
	</div>

	<h3>C<i>SourceType</i>2[C]<i>DestinationType</i>[EX]</h3>
	<div>
		ヘッダ : atlconv.h<br>
		依存関係 : malloc
		<p>
			マルチバイトとワイド文字列を相互に変換するクラス。
			通常は、typedefされた名前（CW2A, CA2CT, CT2WEX etc.）を使う。
			<code>MultiByteToWideChar() / WideCharToMultiByte()</code> の代わりに使うと便利。
			変換前と後の文字コードが同じで、文字列を変更する必要が無い場合は、文字列のコピーさえ行われないのでほとんど無駄が無い。
		</p>
		<h4>使用例</h4>
<pre><code>BOOL MySetWindowTextW(HWND hWnd, const WCHAR* wtext)
{
    return ::SetWindowText(hWnd, CW2CT(wtext)); // SetWindowTextW()は9xで使えないため
}</code></pre>
	</div>

	<h3>CPathT &lt; StringType &gt;</h3>
	<div>
		ヘッダ : atlpath.h<br>
		依存関係 : CStringT, shlwapi.dll
		<p>
			ファイルパス操作をするための <code>CStringT</code> ラッパー。
			shlwapi に含まれる、<code>Path*</code>関数群をクラス化している。
			また、スタティック関数として、ATLPath namespace内に別名が定義されている。
		（<code>PathAddExtensionA</code> ⇒ <code>ATL::ATLPath::AddExtension()</code> など）
		</p>
	</div>

	<h3>CAtlRegExp &lt; RECharTraits &gt;</h3>
	<div>
		ヘッダ : atlrx.h<br>
		依存関係 : CRT
		<p>
			正規表現。
			ただ、必ずCRTを使用するという部分が、CStringT との互換性が取れていない面で設計ミスか？
			（正規表現を使用するような場合は大抵CRTを使う必要があるとは思うが）
		</p>
	</div>

</div>

<h2 id="pointer">スマートポインタ</h2>
<div>
	<p>
		どれもデフォルトで<code>operator T*</code>が定義されているのがSTL/Boostのポインタとの最大の違いかと。
		明示的に破棄するためのメソッドがそれぞれ違うのが気に入らない？
	</p>
	<h3>CAutoPtr &lt; T &gt;</h3>
	<div>
		ヘッダ : atlbase.h
		<p>破壊式コピーポインタ。メソッドは、Attach(), Detach(), Free()。</p>
	</div>
	<h3>CHeapPtr &lt; T &gt;</h3>
	<div>
		ヘッダ : atlcore.h
		<p>配列に対するポインタ。通常の配列のほかに、可変長構造体のメモリ確保にも便利。
			メソッドは、Allocate(), Reallocate(), AllocateBytes(), ReallocateBytes(), Free()。</p>
	</div>
	<h3>CComPtr &lt; T &gt; / CComQIPtr &lt; T, IID &gt;</h3>
	<div>
		ヘッダ : atlcomcli.h
		<p>業界標準COMポインタ。メソッドは、Attach(), Detach(), Release()。</p>
	</div>
	<h3>CHandle</h3>
	<div>
		ヘッダ : atlbase.h
		<p>CloseHandle()できるハンドルが対象。無効ハンドルはNULLのみ；INVALID_HANDLE_VALUEが使われるものに使用する場合は注意。
			メソッドは、Attach(), Detach(), Close()。</p>
	</div>
</div>

<h2 id="collection">コレクション</h2>
<div>
	<p>さすがにSTLコレクションにと比べると貧弱。CRTを使用しない場合のみ、使う価値があるか？</p>
	<h3>CAtlArray / CAutoPtrArray / CInterfaceArray</h3>
	<div>
		ヘッダ : atlcoll.h
		<p>メンバ関数は貧弱なものの、<code>INARGTYPE</code>と<code>OUTARGTYPE</code>を定義することで、破壊式コピーポインタ（auto_ptr）に対応している。
			_ATL_MIN_CRT 環境では、VC7付属のSTLではリンクエラーになるので、これを使わざるを得ない。
			その際、慣れ＋std::algorithm のために、std::vector 互換メンバを追加してみた（<a href="Array.h">Array.h</a>）。</p>
	</div>
	<h3>CAtlList / CAutoPtrList / CHeapPtrList / CInterfaceList</h3>
	<h3>CAtlMap</h3>
	<h3>CRBMap / CRBMultiMap</h3>
</div>

<h2 id="file">ファイル処理</h2>
<div>
	<h3>CAtlFile / CAtlTemporaryFile</h3>
	<div>
		ヘッダ : atlfile.h
		<p>
			ファイルハンドルのラッパー。
			64bit単位で扱え、Low, Highを意識しなくて済む。
			テンポラリファイルは、Close()時に名前を与えた場合はその名前にリネームされ、与えない場合は削除される。
		</p>
	</div>
	<h3>CAtlFileMapping &lt; T &gt; / CAtlFileMappingBase</h3>
	<div>
		ヘッダ : atlfile.h
		<p>
			メモリマップトファイル。
			いろいろな使い方はあるが、ただ単にファイルを読み込むのに使っても便利。
		</p>
		<h4>使用例：ビットマップの読み込み</h4>
		<pre><code>struct BitmapFile
{
    BITMAPFILEHEADER header;
    BITMAPINFO       info;
    BYTE* getBits() { return (BYTE*)this + header.bfOffBits; }
};
CAtlFile file;
file.Create("image.bmp", GENERIC_READ, 0, OPEN_EXISTING);
CAtlFileMapping&lt;BitmapFile&gt; mapping;
mapping.MapFile(file);
BitmapFile* bmp = static_cast&lt;BitmapFile*&gt;(mapping);
</code></pre>
	</div>
</div>

<h2 id="window">ウィンドウ</h2>
<div>
	<h3>CWindow</h3>
	<div>
		ヘッダ : atlbase.h, atlwin.h<br>
		<p>すべてのウィンドウ関係のAPIをラッピングし、
			<code>CenterWindow(), ResizeClient()</code> などの便利なメソッドも追加されています。
			インテリセンスを機能させるためだけでも利用価値があります。</p>
	</div>
	<h3>CWindowImpl &lt; T, Base, Traits &gt;</h3>
	<div>
		ヘッダ : atlbase.h, atlwin.h<br>
		依存関係 : _AtlBaseModule, _AtlWinModule, atl*.lib
		<p>ATL7.0より、グローバル変数 <code>CComModule _Module</code> を宣言しなくてもCWindowImplが使用可能になりました。
			（内部的には <code>_AtlBaseModule, _AtlWinModule</code> を含むライブラリが自動的にリンクされます。）
			非常に軽量のライブラリなので、単にウィンドウを出すような場面（＝ほとんどすべてのWin32プログラム）ではいつでも使えるでしょう。
			誰もが一度は苦労するHWNDのクラス化を、Thunkingという面白い手法で実現しています。
			<a href="AtlWndTest.cpp">VC7のスケルトンと同等なコードの例</a>
		</p>
	</div>
</div>

<hr>
<!--#config timefmt="%Y/%m/%d"-->
<p align="right"><!--#echo var='LAST_MODIFIED'--></p>

</body>
</html>
