Windows Programming Tips & Memos

生の Windows API (および関連 API) を C/C++ で使用するために調べたことのメモおよび Tips 集です．随時追加します．

• Main：http://www5d.biglobe.ne.jp/~noocyte/Programming/Windows/WindowsTips.html
• Mirror：http://www.geocities.jp/iafuu/Programming/Windows/WindowsTips.html

1. 実行環境バージョン指定マクロ (Windows Kits 10, SdkDdkVer.h)
   • _MSC_VER
2. ウインドウリサイズ時のちらつきを抑える．
3. ウインドウの特徴
   • ウインドウ種別
4. ウインドウメッセージ
   • ウインドウメッセージ番号 (WM_*) の範囲
   • DestroyWindow() の処理手順 (WM_DESTROY，WM_NCDESTROY)
   • マウスメッセージ
     • マウス入力メッセージ
     • その他のマウス関連メッセージ
     • ダブルクリック・メッセージ (WM_xBUTTONDBLCLK) を使用するには
     • TrackMouseEvent()，WM_(NC)MOUSEHOVER，WM_(NC)MOUSELEAVE
   • ComboBox のメッセージ
5. ダイアログ
   • ダイアログの座標系 (ダイアログ (テンプレート) 単位とダイアログベース単位)
     • GetDialogBaseUnits() は使えない．
     • GetDialogBaseUnits() の代わりに MapDialogRect() を使う．
   • (１つ以上の) モードレスダイアログで TAB が効かない！
   • WM_INITDIALOG
6. コントロールのウインドウクラス名一覧
7. ToolBar
   • ToolBar のボタンの種類 (機能別分類)
     • プッシュボタン (BTNS_BUTTON)
     • チェックボタン (BTNS_CHECK)
     • チェックグループ (BTNS_CHECKGROUP)
     • ドロップダウンボタン (BTNS_DROPDOWN，BTNS_WHOLEDROPDOWN)
     • セパレータ (BTNS_SEP)
   • ToolBar の表示スタイル
     • リスト表示 (TBSTYLE_LIST)
     • 透明背景 (TBSTYLE_TRANSPARENT)
     • フラット表示 (TBSTYLE_FLAT)
     • 複数行表示 (TBSTYLE_WRAPABLE)
     • ツールバー上部の境界線 (CCS_NODIVIDER)
     • ダブルバッファリング (TBSTYLE_EX_DOUBLEBUFFER)
     • ツールチップでボタンの説明表示 (TBSTYLE_TOOLTIPS)
     • 部分的に隠れるボタンの非表示 (TBSTYLE_EX_HIDECLIPPEDBUTTONS)
8. GDI
   • DC のマッピングモード
   • 閉曲線・多角形の塗りつぶしモード (ALTERNATE/WINDING，EvenOdd/Nonzero)
     〜 点が閉曲線の内部にあるかどうかを判定する方法 〜
9. ゴミ箱
   • ファイルをごみ箱に移動する．
   • ごみ箱の構造 (Windows XP Pro SP2 の場合)
     • ごみ箱フォルダのパス名
     • 削除されたファイルのパス名
     • INFO2 ファイルのフォーマット
10. その他
    • Windows のエラーメッセージ文字列を取得する．
      • 使用例
      • サイト内関連ページ
    • Modifier Keys
    • ATOM
    • InitCommonControlsEx() のエラー
    • 実行ファイルのフルパス名を取得する．
11. 参考図書
12. 外部へのリンク
13. 更新履歴

参考

• Windows 10 用のダウンロードとツール
• Windows 8.1 用 Windows ソフトウェア開発キット (SDK) (Download)
• Using the Windows Headers (MSDN)
• What's the difference between WINVER, _WIN32_WINNT, _WIN32_WINDOWS, and _WIN32_IE? (The Old New Thing)
• SdkDdkVer.h (Windows Kits 8.1 / 10.0.10150.0 / 10.0.10240.0 / 10.0.10586.0)

• VS2013 以降，MSBuild Toolset version は VS バージョン番号と同じ (出典)．

参考

• Description of the predefined identifiers in Microsoft C and C++
  VC6 以前の定義済マクロ．

Overlapped Window (WS_OVERLAPPED，WS_OVERLAPPEDWINDOW)

アプリケーションのメインウインドウとして使用するためのトップレベル・ ウインドウ．タイトルバー，境界，クライアントエリアを持つ． ウインドウメニュー，最大化および最小化ボタン， スクロールバーを持つこともできる．

ウインドウスタイル：

• WS_OVERLAPPED：タイトルバーと境界を持つ．
• WS_OVERLAPPEDWINDOW：次の要素を持つ．
  • タイトルバー (WS_CAPTION)
  • サイズ変更可能境界 (WS_THICKFRAME (＝WS_SIZEBOX))
  • ウインドウメニュー (WS_SYSMENU)
  • 最小化ボタン (WS_MINIMIZEBOX)
  • 最大化ボタン (WS_MAXIMIZEBOX)

  // WinUser.h
  #define WS_OVERLAPPEDWINDOW (WS_OVERLAPPED | WS_CAPTION | WS_SYSMENU | \
                               WS_THICKFRAME | WS_MINIMIZEBOX | WS_MAXIMIZEBOX)
  

Pop-up Window (WS_POPUP)

Overlapped window の一種で， アプリケーションのメインウインドウの外に表示されるダイアログボックス， メッセージボックス，ツールチップ， その他の一時的なウインドウとして用いられる． タイトルバーがオプションである点を除いて WS_OVERLAPPED と同じ．

CreateWindowEx() で WS_POPUP を指定する場合， hwndParent には親ではなくオーナー (または NULL) を指定する． ポップアップウインドウの親はデスクトップウインドウになる．(実験で確認)

ウインドウスタイル：

• WS_POPUP：ポップアップ・ウインドウ．
• WS_POPUPWINDOW：WS_POPUP に加え，境界 (WS_BORDER) とウインドウメニュー (WS_SYSMENU) を持つ．

  // WinUser.h
  #define WS_POPUPWINDOW      (WS_POPUP | WS_BORDER | WS_SYSMENU)
  

Child Window (WS_CHILD)

通常，子ウインドウはクライアントエリアのみを持つが， 明示的に指定すれば次の要素を持つこともできる．

• タイトルバー (WS_CAPTION)
• ウインドウメニュー (WS_SYSMENU)
• 最小化ボタン (WS_MINIMIZEBOX)
• 最大化ボタン (WS_MAXIMIZEBOX)
• 境界 (WS_BORDER)
  指定しない場合は境界のないウインドウを作成する． これは親ウインドウのクライアント領域を， 見えない境界で分割するのに使用できる．
• スクロールバー (WS_HSCROLL，WS_VSCROLL)
• メニュー (不可)
  CreateWindow() の hMenu 引数の説明からわかるように， メニューハンドルと子ウインドウ ID の一方しか指定できないので， 子ウインドウはメニューを持つことができないのだろう．

Layered Window (WS_EX_LAYERED)

レイヤード・ウインドウ． 次のような視覚効果を持つトップレベル・ウインドウ (子ウインドウは不可) を，ちらつかずに高速表示する． Windows 8 では子ウインドウも可 (出典：SetLayeredWindowAttributes function)．

• 複雑な形状 (アニメーションも可)
• アルファブレンド

参考

• UpdateLayeredWindow 関数 (日 英)
• UpdateLayeredIndirect 関数 (英)
• SetLayeredWindowAttributes 関数 (日 英)
• 半通過ウィンドウの作り方講座 (INASOFT)
• Win32API、DirectXでウィンドウの背景を透過させる方法
• Win32API(Ｃ言語)編　第６０章　ウィンドウの操作�@

Message-Only Window

メッセージを受信するためだけのウインドウ．不可視であり，Z-order はなく，列挙できない．また，ブロードキャストメッセージは受信しない．

参考

• Window Features

■Memo

• DefWindowProc(hwnd, WM_APP＋n，0, 0) は０を返すらしい (実験で確認)．これは， アプリケーション内の指定されたウインドウが特定のメッセージや機能をサポートしているか否かを判定するのに使えそう．
  (OLE を使わないアプリケーション内 Drag & Drop でドロップ可能か否かを判定するなど．)
  (2010/10/09(土))
• 時々「WM_ 一覧」などで検索して来る人がいるが，上の表にあるとおり WinUser.h，CommCtrl.h，CommDlg.h を見れば全部書いてある．

下記のマニュアルの項目から推測した DestroyWindow(hwnd) の処理手順．

つまり WM_DESTROY は子孫ウインドウを破棄する前，WM_NCDESTROY は子孫ウインドウを破棄した後に send される．

参考

• DestroyWindow Function (日本語)
• WM_DESTROY Notification
• WM_NCDESTROY Notification
• WM_PARENTNOTIFY Notification
• テクニカル ノート 17: ウィンドウ オブジェクトの破棄

マウス入力メッセージ

その他のマウス関連メッセージ

ダブルクリック・メッセージ (WM_xBUTTONDBLCLK) を使用するには

TrackMouseEvent()，WM_(NC)MOUSEHOVER，WM_(NC)MOUSELEAVE

ComboBox のメッセージの一部に， マニュアルの内容から予想されるのと異なる動作があったので実験で確認してみた．
(Windows XP SP3 ＋ comctl32.dll 5.82.2900.5512 (2004/08/05))

• 選択状態
  • CB_GETCURSEL
    マニュアルには「リストボックス内で現在選択されている項目があればその番号 (０から始まる) を，なければ CB_ERR を返す．」とあるが，実際には「現在選択されている項目」ではなく 「ハイライト表示されている項目」． リストからクリックまたは↑↓キーで選択した項目だけでなく， ドロップダウンリスト内でマウスに追従してハイライト表示されている項目も取得できる．
  • CBN_SELCHANGE
    ユーザがリスト内の選択状態を (クリックまたは↑↓キーにより) 変更した時に発生する． ドロップダウンリスト内でマウスをトラッキングしている時には発生しない． トラッキングイベントを取得する方法は未確認． とりあえず CBN_DROPDOWN でタイマを起動し，CB_GETCURSEL を0.1秒程度の周期で実行すれば一応トラッキング状態をポーリングできる． CBN_CLOSEUP でタイマ停止．
• ドロップダウン状態
  • CB_GETDROPPEDSTATE
    リストボックスが表示されているときそのときに限り真を返す． 標準コンボボックスでは常にリストが表示されているので，常に真を返す．
  • CBN_DROPDOWN，CBN_CLOSEUP
    ドロップダウンリストが表示される直前に CBN_DROPDOWN が， 非表示になった直後に CBN_CLOSEUP が発生する (マニュアルどおり)． したがってこれら２つの通知でフラグをセット／リセットすれば， それはドロップダウンリストの表示状態と一致する．
    

    case CBN_DROPDOWN: comboBox->isDroppedDown = TRUE ; break;
    case CBN_CLOSEUP : comboBox->isDroppedDown = FALSE; break;
    

    一方，これらのタイミングで CB_GETDROPPEDSTATE を使用する方法は期待通りに動作しない． (CBN_DROPDOWN は表示される直前に発生するため．)

    // ×うまくいかない．
    // (仮にうまくいくとしても，上記の方法に比べて効率が悪い．)
    case CBN_DROPDOWN:
    case CBN_CLOSEUP:
      comboBox->isDroppedDown = SendMessage(comboBox->hwnd, CB_GETDROPPEDSTATE, 0, 0);
      break;
    

• ダブルクリック (CBN_DBLCLK)
  標準コンボボックスのリストボックス内の項目をダブルクリックしたときに発生する． 選択フィールドでは発生しない． ドロップダウンリストはシングルクリックで閉じてしまうので，そもそもダブルクリックできない． (マニュアルどおり)

ダイアログでは，座標の単位として画素数ではなく 「ダイアログテンプレート単位 (dialog template units，ダイアログ単位 (DLU) ともいう)」を用いる． リソースファイル (*.rc) の中のダイアログ定義データに含まれる座標はこれである． ダイアログテンプレート単位は「ダイアログベース単位 (dialog base units)」 を用いて次のように定義される．

TemplateUnitX ＝ BaseUnitX / 4
TemplateUnitY ＝ BaseUnitY / 8

ダイアログベース単位は， そのダイアログで使用するフォントのサイズにより次のように定義される．

BaseUnitX ＝ <ダイアログのフォントの平均幅>
BaseUnitY ＝ <ダイアログのフォントの高さ>

したがってダイアログ (テンプレート) 単位は次のようになる．

TemplateUnitX ＝ <ダイアログのフォントの平均幅> / 4
TemplateUnitY ＝ <ダイアログのフォントの高さ> / 8

2013/10/20(日) 追記

BaseUnitX は「フォントの平均幅」と定義されているが，TEXTMETRIC::tmAveCharWidth とは必ずしも一致しない．
(実験で確認．他方，BaseUnitY は TEXTMETRIC::tmHeight と一致する．)

後述する MapDialogRect() では，どうやらこのページのサンプルにあるように， 英字 [A-Za-z] の平均幅 (端数四捨五入) を使用しているらしい．(数種類のフォントとサイズについて実験で確認．)

要するにダイアログベース単位は， GetTextExtentPoint32("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz") の横幅を 1/52 にしたサイズに等しいはず．(端数四捨五入，高さはそのまま．)

GetDialogBaseUnits() は使えない．

GetDialogBaseUnits() の代わりに MapDialogRect() を使う．

Px ＝ MulDiv(Tx, BaseUnitX, 4)
Py ＝ MulDiv(Ty, BaseUnitY, 8)

/*─────────────────────────────────────
機能  ：ダイアログ hDialog の実際のダイアログベース単位を取得する．
        GetDialogBaseUnits() はシステムフォント (８ポイントの "System") を使
        用するダイアログでしか使えないが，この関数は hDialog が使用している
        フォントに基づいて実際のダイアログベース単位を返す．
入力  ：hDialog：ダイアログのウインドウハンドル．
出力  ：*baseUnit：hDialog の実際のダイアログベース単位．
戻り値：取得成功のときそのときに限り真．
2006/12/24(日) 作成
─────────────────────────────────────*/
BOOL GetActualDialogBaseUnits(HWND hDialog, SIZE *baseUnit)
{
  RECT rect;
  BOOL result;

  rect.left = 4;
  rect.top = 8;
  if(result = MapDialogRect(hDialog, &rect)) {
    baseUnit->cx = rect.left;
    baseUnit->cy = rect.top;
  }
  return result;
}

GetDialogBaseUnits() で求めたベース単位：(8, 18)
・ダイアログのフォントが "System" (サイズ：８ポイント) の場合
  GetActualDialogBaseUnits() で求めた実際のベース単位：(8, 18)
・ダイアログのフォントが "MS Shell Dlg" (サイズ：８ポイント) の場合
  GetActualDialogBaseUnits() で求めた実際のベース単位：(6, 13)

参考

この項目は，そもそも昨年12月に複数のモードレスダイアログを使おうとして TAB が効かなかったので追加したんだけど， リンクだけ紹介して中身を書くのをサボっていた． しかしついさっき「モードレスダイアログ  複数」で検索してきた人がいるのでこの機会に書くことにした． (2007/03/20(火) 13:40)

ちなみに「モーダレス」だと勘違いしている人が多いみたいだけど「モードレス (modeless)」だよ!!
(「モーダル (modal)」とごっちゃになってる．(笑))

モードレスダイアログで TAB が使えるようにする方法は下のリンク先にあるとおりだが， 複数のモードレスダイアログの場合については書かれていなかった． そこで自分で試した結果， メッセージループを次のようにするとうまくいった．

HWND Dialog[NDIALOGS];  // モードレスダイアログのハンドルの配列
HACCEL hAccelTable = LoadAccelerators(hInstance, (LPCTSTR)IDR_xxxx);
MSG msg;
UINT i;

while(GetMessage(&msg, NULL, 0, 0)) {
  for(i = 0;  ;  i++) {
    if(i >= NDIALOGS) {
      // Dialog[*] 宛ではないメッセージの場合
      if(!TranslateAccelerator(msg.hwnd, hAccelTable, &msg)) {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
      }
      break;
    }
    // Dialog[i] またはそのコントロール宛のメッセージか？
    // そうならば処理する．
    if(IsDialogMessage(Dialog[i], &msg)) break;
  }
}

なお，モードレスダイアログの親 (または祖先) がモーダルダイアログだとダメなので， 親 (祖先) もモードレスにする必要がある． これはモーダルダイアログが自分専用のメッセージループを持っており， 同じスレッドに属する他のウインドウへの入力 (マウス，キーボード) メッセージを握りつぶしてしまうため．

つまり，モーダルダイアログが開いている間は， 同じスレッドに属する他のウインドウ (モーダルおよびモードレスダイアログを含む) をマウスやキーボードで操作することはできない．

また，上記のコードはすべてのウインドウがモードレスダイアログ (最大４個) であるアプリケーションでうまく動いたが， 数が多くなると非効率なので，下記の Microsoft の技術サポート記事を参考にする方がよい．

• 多くのモードレス ダイアログ ボックスの 1 つの IsDialogMessage() 呼び出しを使用する方法
  (原文：How To Use One IsDialogMessage() Call for Many Modeless Dialogs)
• PRB: DLL のモードレス ダイアログ ボックスは、 Tab キーを処理しません。
  (原文：Modeless Dialog Box in a DLL Does Not Process TAB Key)
• 近藤妥の Ｃ言語で始めるＷｉｎｄｏｗｓプログラミング ２１章　ダイアログボックス（その４）
• Tips of VC++ > ダイアログ > モーダレスダイアログボックスを作る
• Google 検索「+"モードレスダイアログ" +TAB」

• wParam：デフォルトのキーボード・フォーカスを受け取るコントロールのハンドル． WM_INITDIALOG が TRUE を返したときに限り，キーボード・フォーカスが設定される． これはダイアログ内で次の条件を満たす最初のコントロールである．
  • Visible
  • Enabled
  • WS_TABSTOP スタイルを持つ．
• lParam：アプリケーション定義初期化データ．CreateDialogParam()， CreateDialogIndirectParam()， DialogBoxParam()， DialogBoxIndirectParam() の最後の引数がそのまま渡される．
• 戻り値：アプリケーションが特定のコントロールにキーボード・ フォーカスを設定した場合は FALSE を，それ以外は TRUE を返すべき．

2013/10/20(日) 追記

ダイアログプロシージャは，WM_INITDIALOG より先にいくつかのメッセージを受信する．実験で確認したところ，次の順番になった．

1. WM_SETFONT (フォントが指定されている場合のみ？)
2. WM_NOTIFYFORMAT (ない場合もある．)
3. WM_QUERYUISTATE (ない場合もある．)
4. その他 (実験で確認したものは WM_CHANGEUISTATE，WM_UPDATEUISTATE，WM_NOTIFYFORMAT など．)
5. WM_INITDIALOG

コントロールのクラス名は，CommCtrl.h の中で次のように定義されている．
(どうしてこんなに名前の付け方がバラバラなんだ．)

■マニュアル

• Windows Controls (概要)
• Control Library (各コントロールの説明)
• コントロール (MFC)
• About Common Controls
• Common Controls FAQ
• コントロール
  • エディットコントロール関数
  • コンボボックス関数
  • スクロールバー関数
  • ボタン関数
  • リストボックス関数
  • リッチエディットコントロール
    • ウィンドウレスリッチエディットコントロール関数
    • リッチエディットコントロール関数

• Toolbar
  • Overviews
    • About Toolbar Controls
    • Using Toolbar Controls
  • Toolbar Control Functions
  • Toolbar Control Messages
  • Toolbar Control Notifications
  • Toolbar Control Structures
  • Toolbar Control Constants
    • Toolbar Control and Button Styles
    • Toolbar Extended Styles
    • Toolbar Standard Button Image Index Values
    • Toolbar Button States

プッシュボタン (BTNS_BUTTON)

• ToolBar ボタンのデフォルトスタイル．
• 押すと WM_COMMAND を通知する．

チェックボタン (BTNS_CHECK)

• 押すたびに ON/OFF が反転する．(チェックボックスと同等)
• 押すと WM_COMMAND を通知する．
• ON/OFF 状態は TBSTATE_CHECKED フラグで取得できる．
• ボタンが ON になるときは押した瞬間に表示に反映されるのに対し， OFF になるときは WM_COMMAND の処理が終わってから表示が更新されるので， 処理に時間がかかると表示が変に見える．(実験で確認)

チェックグループ (BTNS_CHECKGROUP)

• グループ内の０または１個のボタンだけが ON になる． (ラジオボタンのグループと同等)
• グループの定義：BTNS_GROUP または BTNS_CHECKGROUP スタイルのボタンが連続 (隣接) する範囲が一つのグループとなる． (グループ間はセパレータで区切る．)
• 押すと WM_COMMAND を通知する．
• ON/OFF 状態は TBSTATE_CHECKED フラグで取得できる．
• 押したボタン以外のボタンが OFF の表示になるのは，WM_COMMAND の処理が終わってからなので，処理に時間がかかると表示が変に見える．(実験で確認)

ドロップダウンボタン (BTNS_DROPDOWN，BTNS_WHOLEDROPDOWN)

• ボタンを押すと選択肢のリストが表示される．
  (ドロップダウンリストスタイルの ComboBox と同等．ただしリストはアプリケーションが表示すべき．)
• BTNS_WHOLEDROPDOWN スタイル
  ボタンの右端に小さなドロップダウンアロー [▼] を表示する．ボタンを押すと TBN_DROPDOWN を通知する．
• BTNS_DROPDOWN スタイル
  ToolBar スタイル TBSTYLE_EX_DRAWDDARROWS が
  • 指定されていない場合：[▼] は表示されないが，ボタンを押すと WM_COMMAND ではなく TBN_DROPDOWN を通知する．
  • 指定されている場合：ボタンの右に [▼] を表示する． これはボタン本体とは別のボタンであり，ボタン本体を押すと WM_COMMAND を，[▼] を押すと TBN_DROPDOWN を通知する．(スプリットボタンと同等)
    Windows classic style では，TBSTYLE_FLAT も指定しないとちょっと見栄えが悪い．(ボタン本体と [▼] ボタンで右下の影の色が異なる．)

セパレータ (BTNS_SEP)

• ボタングループ間に小さな隙間を挿入する．(実測で８画素幅)
• ユーザ入力には反応しない．

以下はマニュアルに書いてある内容そのままではなく，自分で実験した結果を含んでいる． 正確・網羅的に調べたわけではないので間違いがあるかもしれない．
(Vista Home Premium SP2，Windows 7 Home Premium SP1，ComCtl32.dll version:6.16.7601.2)

リスト表示 (TBSTYLE_LIST)

ボタン画像の右にテキストを表示する．(OFF の場合は下に表示．)

フラット表示 (TBSTYLE_FLAT)

• Windows Classic Style：ボタンの 3D 表示 / フラット表示を切り替える． フラット表示では，セパレータは凹んだ縦線 (｜) として表示される． またボタンが複数行の場合，行間は凹んだ横線で区切られる．
• Aero Basic/Glass Style：TBSTYLE_FLAT にかかわらずフラット表示されるが，Classic Style と同様，TBSTYLE_FLAT が ON の場合のみセパレータと行間の横線が表示される．OFF ならばこれらは表示されない．

透明背景 (TBSTYLE_TRANSPARENT)

Windows classic style の場合，ツールバーの背景を透明にする．

• TBSTYLE_FLAT が OFF の場合：ボタンの背景は不透明 (COLOR_3DFACE) なので，親ウインドウの背景色を COLOR_3DFACE にしないと見栄えが悪い．
• TBSTYLE_FLAT が ON の場合：ボタンの背景も透明になる． 背景色に応じてセパレータの縦線と行間の横線の色を設定した方がよい． (TB_SETCOLORSCHEME を使用)

複数行表示 (TBSTYLE_WRAPABLE)

ボタンが１行に収まらない場合，複数行で表示する． 改行は行の右端のセパレータの位置で行われる． セパレータがなければボタン間で改行される．

Windows classic style では，セパレータ位置で改行された場合に限り， 行間にスペースが入る．(TBSTYLE_FLAT が ON の場合は８画素，OFF ならば５画素．(実測))

ツールバー上部の境界線 (CCS_NODIVIDER)

CCS_NODIVIDER が OFF ならば，ツールバー上部に高さ２画素 (マニュアルに記載あり，実測でも確認) の横線を描く． (実験で確認したところ，この境界線は， ツールバーウインドウの非クライアント領域となっている．)

Windows classic style では，境界線を表示すると， (TBSTYLE_EX_DOUBLEBUFFER を指定していても) ウインドウのリサイズ時にツールバーのちらつきが大きい．(Aero Basic/Glass style では，CCS_NODIVIDER にかかわらずちらつきが大きい．)

ダブルバッファリング (TBSTYLE_EX_DOUBLEBUFFER)

ちらつき防止のため，ダブルバッファリングを行う． 実験では，次の条件を両方満たした場合にのみ， ウインドウをリサイズしてもツールバーのちらつきが発生しなかった．

• Windows classic style
• CCS_NODIVIDER を ON にする．
  (CCS_NODIVIDER を OFF にした場合はちらつきがひどい． しかも，TBSTYLE_EX_DOUBLEBUFFER が勝手にリセットされる． 境界線が非クライアント領域なので，ダブルバッファリングと両立しないのか？
  「境界線を表示したいけど，リサイズ時のちらつきは嫌だ」という場合は， リサイズ中のみ境界線を非表示にするという手もある． (WM_ENTERSIZEMOVE で CCS_NODIVIDER を ON にし，WM_EXITSIZEMOVE で OFF に戻せばできるはず．))

Aero Basic/Glass style では CCS_NODIVIDER の設定によらずちらつく．

ツールチップでボタンの説明表示 (TBSTYLE_TOOLTIPS)

ツールチップでボタンの説明テキストを表示する．

画像ボタンとテキストボタンの混合表示 (TBSTYLE_EX_MIXEDBUTTONS)

このフラグが ON の場合，BTNS_SHOWTEXT が ON のボタンにだけテキストが表示される．(TBSTYLE_LIST も ON にすること．)

部分的に隠れるボタンの非表示 (TBSTYLE_EX_HIDECLIPPEDBUTTONS)

部分的に隠れるボタンを表示しない．(Rebar で使用する場合に ON にする．)

ハイライトと影の色 (TB_SETCOLORSCHEME)

次の部分のハイライトと影の色を設定する．

• ボタン上部および行間の横線 (Classic，Aero Basic/Glass いずれの場合も有効)
• ボタンの境界線およびセパレータ (Classic かつ TBSTYLE_FLAT の場合のみ)
  ただしボタンの境界線はホットトラック時のみ表示される．

^(*1) 等方性 (isotropy)：どちらの方向を向いても数学的・物理的性質が等しいこと． 特に2DグラフィックスではX軸方向とY軸方向の1論理単位の (デバイス上での物理的な) 長さが等しいこと． 論理座標空間で正方形や円を描くと，デバイス上でも正方形や円になる． 非等方 (異方) 座標系ではデバイス上で長方形や楕円になる．

• マッピングモードは SetMapMode() で設定する．
• デバイス座標 (0, 0) は常に左上隅を表す．(論理座標ではない．)
• 論理単位の小さい順
  1. MM_HIMETRIC (0.01mm)
  2. MM_TWIPS (約 0.0176mm)
  3. MM_HIENGLISH (約 0.0254mm)
  4. MM_LOMETRIC (0.1mm)
  5. MM_LOENGLISH (約 0.254mm)
• 参考
  • GDI 座標変換関数一覧 (日 英)
    • SetMapMode 関数 (日 英)
    • SetWindowExtEx 関数 (日 英)
    • SetViewportExtEx 関数 (日 英)
  • Mapping Modes and Translations
  • INFO: Logical and Physical Coordinate Relationship
  • Relationship Between Inches, Picas, Points, Pitch, and Twips
• Wikipedia
  • 等方的と異方的
  • Isotropy
  • Anisotropy

Windows GDI では多角形や閉じたパスの塗りつぶしモードとして，ALTERNATE および WINDING の２種類がある．これらは次の API (や MFC のメソッド) で使用できる．

Direct2D1 (D2D1) にも同様の塗りつぶしモード (D2D1_FILL_MODE) がある．

.NET Framework や Silverlight の FillRule 列挙体では，EvenOdd と Nonzero という名前になっている．

ALTERNATE (EvenOdd) と WINDING (Nonzero) とは何かというと， どちらも閉曲線の内部と外部を区別 (定義) するための規則である． 閉曲線を塗りつぶすには，当然ながら内部と外部を区別する必要がある． 閉曲線が単純 (数学用語で「曲線がそれ自身と交差・接触しない」) ならば，その内部と外部の区別は明らかだが， 単純閉曲線でない場合はあいまいになる場合がある．

ALTERNATE/EvenOdd (交互ルール，偶奇ルール)

　　　　　┏━━━━━━━━━━━━━━━━━┓
　　　　　┃　Ｙ　　　　　　　　　　　　　　　┃
　　　　　┃　┏━━━┓　　　┏━━┓　　　　┃
Ｌ　　　　┃　┃　Ｐ　┃　　　┃　　┃　　　　┃
──・→─╂─╂─・　┃　　　┃　　┃　　　　┃Ｃ
　　Ｑ　　┃　┃　　　┃　　　┃　　┃　　　　┃
　　　　Ｗ┗━╋━━━┛Ｘ　　┃　　┃　　　　┃
　　　　　　　┃　　　　　　　┃　　┃　　　　┃
　　　　　　　┗━━━━━━━┛　　┃　　　　┃
　　　　　　　Ｚ　　　　　　　　　　┃　　　　┃
　　　　　　　　　　　　　　　　　　┗━━━━┛

WINDING/Nonzero (巻数ルール)

(1) Ｐが単純閉曲線Ｃの内部にある場合

　　┏━━━━━┓Ｃ
　　┃　　Ｐ　　┃
　　┃　　・　　┃
　　┃　　　　　・Ｑ
　　┗━━━━━┛

　　ＱがＣを１周すると，Ｐのまわりを１回まわる．つまり巻数は１．


(2) Ｐが閉曲線Ｃの「明らかに」外部にある場合

　　┏━━━━━━━┓Ｃ
　　┃　┏━━━┓　┃
　　┃　┃　　　┃　・Ｑ
　　┗━┛　　　┃　┃　　　　　　　　　・Ｐ
　　　　　┏━━╋━┛
　　　　　┃　　┃
　　　　　┗━━┛

　　ＱがＣを何周しようが，Ｐからみれば８時の方向と10時の方向の間をウロウロ
　　するだけで，Ｐのまわりを１周もすることはない．つまり巻数は０．

参考リンク

ごみ箱は Windows95 以降のシェルアプリケーションの機能です． したがってごみ箱用の API は Windows API ではなく，シェル API であり， 次の３つがあります．

ここでは，SHFileOperation() を用いてファイルやディレクトリをごみ箱に送る方法を説明します． といっても，私は SHFileOperation() の動作についてまだ十分理解しているわけではないので， 色々試行錯誤しながら理解したことや注意点を書きます． 間違いや補足があればご指摘ください．

SHFileOperation() は，次の構造体を使って必要なパラメータを受け取ります．

typedef struct {
  HWND         hwnd;
  UINT         wFunc;
  LPCTSTR      pFrom;
  LPCTSTR      pTo;
  FILEOP_FLAGS fFlags;
  BOOL         fAnyOperationsAborted;
  LPVOID       hNameMappings;
  LPCTSTR      lpszProgressTitle; // only used if FOF_SIMPLEPROGRESS
} SHFILEOPSTRUCT;

この構造体のメンバのうち，注意が必要なのは (というより，私がつまずいたのは (^^;)) 次の２つです．

pFrom

• pFrom の最後は２個の '\0' で終端する．
  pFrom は複数のパス名を指定できる仕様になっており， 次の形式の文字列を受け取ります．

  <パス名１>\0<パス名２>\0 … \0<パス名Ｎ>\0\0

• フルパス名でなければならない．
  … さもなくば，ごみ箱行きではなく， 本当に削除されてしまう，とマニュアルには書かれています．(動作未確認)
  
  
• ディレクトリの区切り文字に '/' は不可．

  私がつまづいたのはこの点．マニュアルには書かれていないし， SHFileOperation() を説明している他のサイトにも書かれていません．
  (そもそも，Windows でパス名の区切りに '/' を使おうとする人自体，非常に少ないんだろうけど．(^^;)
  私は (少なくとも日本語環境では) 見やすいから Unix 流の '/' の方が好き．)

  多くの (すべての？) Windows API は，パス名の区切りとして '\\' の代わりに '/' を使っても，あるいは両者を混在させてもかまいません． しかし SHFileOperation() は Windows API ではなくシェル API であるせいか，そうはなっていないようです． この点にハマってしまいました．

  パス名の区切りとして '/' を用いたファイル名を指定したところ， ごみ箱には移動されるのですが， ごみ箱の中身を表示した際の「名前」が空文字列に， 「元の場所」が "D:" になってしまいました． また，「ファイル削除の確認」ダイアログに表示されるファイル名は， 単一の '"' だけになっていました． どうやらパス名の最初の '/' 以後の部分が無視されてしまったようです． しかし，ごみ箱のディレクトリ内にあるごみ箱管理ファイル "INFO2" をダンプしてみたところ， そのようなファイルでも元のパス名がちゃんと記録されており， ごみ箱から「元に戻す」こともできました． どうやら表示だけの問題のようです．

  2007/08/18(土) 追記

  パス名を \\?\ で始めると，Windows API でも '/' をディレクトリ区切り文字として使用できなくなるらしい． (参考：下記 外部へのリンク → Windowsパス名の落とし穴 → サービス機能の不活性化)

hwnd

NULL で大丈夫です．GUI アプリケーションだけでなく，hwnd に NULL を渡さざるを得ないコンソール・アプリケーションでも動きます． ただしコンソール・アプリケーションの場合はなぜか ERROR_INVALID_HANDLE がセットされますが，ごみ箱への移動はちゃんとできているようなので， このエラーコードは無視してよさそうです．
(ついでに言うと，fFlags に FOF_NOCONFIRMATION や FOF_NOERRORUI を指定しなければ，コンソール・アプリケーションであっても 削除確認ダイアログやエラーダイアログが表示されます．)

いやむしろ，NULL 以外の値として何を渡せばよいのか， マニュアルを見てもさっぱりわかりません． マニュアルの hwnd の説明には次のように書かれています．

「ファイル操作の状態に関する情報を表示するダイアログボックスのウインドウハンドル」(拙訳)

しかし，どんなコントロールをどのように配置すればいいのか？  全く謎です． テキトーにダミーのダイアログを作ってそのハンドルを渡してみたり， アプリケーションで別の目的に使用しているダイアログのハンドルを渡してみたりしましたが， ERROR_INVALID_HANDLE になり，ファイルはごみ箱に送られませんでした． 他のサイトのサンプルコードでは，当たり前のようにハンドルを渡しており， 疑問を持っている人はいないようです． ひょっとして，私はなにか大きな勘違いをしているのでしょうか？

現時点ではどんなダイアログのハンドル渡したらいいのかわからないし，NULL で動くので NULL を渡しています．

あと，ごみ箱に移動できないファイルがあると， なぜかそのようなファイルごとに数秒程度時間がかかります． SHFILEOPSTRUCT::fFlags に FOF_NOCONFIRMATION と FOF_NOERRORUI を指定していない場合，削除確認ダイアログはすぐに表示されるものの， それに「はい」と答えると約５秒後にエラーダイアログが出ました． なぜこんなに時間がかかるんだろう？

ファイルまたはディレクトリをごみ箱に送る関数の例を次に示します．

#include <ShellAPI.h>
#include <tchar.h>
/* その他のヘッダは省略 */

/* fullPathName はフツーの '\0' 終端文字列．
 * ただしフルパス名で，ディレクトリの区切りに '/' は不可．
 */
int MoveFileToRecycleBin(const TCHAR *fullPathName, HWND hwnd, FILEOP_FLAGS flags)
{
  SHFILEOPSTRUCT fileOp;
  const TCHAR *src = fullPathName;
  TCHAR *dest;

  /* ファイルのフルパス名を２つの _T('\0') で終端する必要があるので，
   * fullPathName[] を fileOp.pFrom[] にコピーし，２個目の _T('\0') を追加する．
   */
  fileOp.pFrom = dest = alloca(sizeof(*dest) * (_tcslen(fullPathName) + 2));
  while((*dest++ = *src++) != _T('\0')) {}
  *dest = _T('\0');     /* もう１個必要 */

  fileOp.hwnd = hwnd;
  fileOp.wFunc = FO_DELETE;
  fileOp.pTo = NULL;
  fileOp.fFlags = FOF_ALLOWUNDO | flags;
  fileOp.fAnyOperationsAborted = FALSE;
  fileOp.hNameMappings = NULL;
  fileOp.lpszProgressTitle = NULL;
  return SHFileOperation(&fileOp);
}

まだ調査中です．

ごみ箱フォルダのパス名

"S-1-5-21-1234567890-123456789-123456789-1234"

削除されたファイルのパス名

D<drive><number>.<元の拡張子>

INFO2 ファイルのフォーマット

// INFO2 ファイル全体の構造
typedef struct {
  Info2Header_t header;         // ヘッダ (20バイト)
  Info2FileData_t fileInfo[N];  // ファイル情報 (各800バイト)
} INFO2_t;

// ヘッダ部の16進ダンプ
00000000　05 00 00 00 00 00 00 00-00 00 00 00 20 03 00 00
00000010　00 00 00 00

// ヘッダ部の構造 (20バイト)
typedef struct {
  BYTE unknown1[12];  // 不明 (最初の数バイトは INFO2 ファイルのバージョンか？)
  DWORD fileInfoSize; // sizeof(Info2FileData_t) か？
  BYTE unknown2[4];   // ０固定？
} Info2Header_t;

// ごみ箱内の各ファイルの情報
typedef struct {
  // 削除前のフルパス名 (マルチバイト文字列)．
  // ・余白は '\0' で埋める．
  // ・ファイルを元に戻した場合，最初の１バイトが '\0' になる．
  char ansiPathName[MAX_PATH];

  DWORD fileNo;     // ファイル番号？ (１から始まる連番)
  DWORD driveNo;    // ドライブ番号？ (A:0，B:1，…，Z:25)
  BYTE unknown[12]; // 未確認．削除時刻と属性フラグか？

  // 削除前のフルパス名 (UTF-16LE 文字列)．
  // ・余白は L'\0' で埋める．
  // ・ファイルを元に戻しても変更されない．
  wchar_t unicodePathName[MAX_PATH];
} Info2FileData_t;

全面改訂中

■参考リンク (とりあえずメモ，未整理)

• いまどきのデスクトップ処理系 (steps to phantasien)
  ウインドウシステムの仕組みと，その歴史的変遷．
  ウインドウのちらつき防止を根本から考えるうえで必須の知識．
• コンポジット型ウィンドウマネージャ
• Flicker-free painting
• Can someone explain WS_EX_COMPOSITED
• WS_EX_COMPOSITED フラグを指定して作成したウィンドウのリサイズ後、Windows 8 でのみ表示が不正となる。
• Performance Considerations and Best Practices (DWM (Vista〜))
  トップレベルの WS_EX_TRANSPARENT は WS_EX_LAYERED と併用すべき．
  そうでない WS_EX_TRANSPARENT は子ウインドウ専用．
• How Windows 7/Vista Manage Flicker Free Drawing?
  • DWM はダブルバッファリングを使用しているが，完全にちらつきをなくすことはできない．
  • デスクトップは Direct3D サーフェスであり，ウインドウはテクスチャとして表示される．
• INFO: Transparent Windows
  Windows は透明ウインドウを完全にはサポートしない．
  WS_EX_TRANSPARENT ウインドウを移動させると，元の背景ごと移動してしまう．
• Why isn't my transparent static control transparent?
  • WS_EX_TRANSPARENT は，透明化に必要な描画順を保証するだけ．
    (自分より下 (奥) にあるウインドウより後に描画される．)
  • WS_EX_TRANSPARENT を指定しただけで透明になるわけではない．
    Static control の背景を透明にしたければ，WM_CTLCOLORSTATIC で HOLLOW_BRUSH を返す必要がある．
• とあるソフトの開発記録
  • Windows 7 におけるULWの挙動 (1) (2) (3)
  • Windows 7 での滑らかなアニメーションの実現 (1) (2) (3)

Windows のエラーメッセージは FormatMessage() で取得できるが， 引数が多いので自由度が高い反面，使うのが面倒． そこでエラー番号だけを指定すればエラーメッセージ文字列を取得できる， 次のような関数を用意しておくと簡単に使えて便利．

#include <windows.h>
#include <tchar.h>

TCHAR *WinErrorMessage(DWORD errorCode)
{
  TCHAR *message;
  DWORD n = FormatMessage(FORMAT_MESSAGE_ALLOCATE_BUFFER |
                          FORMAT_MESSAGE_IGNORE_INSERTS |
                          FORMAT_MESSAGE_FROM_SYSTEM,
                          NULL, errorCode, LANG_USER_DEFAULT,
                          (TCHAR*)&message, 0, NULL);
  return (n > 0) ? message : NULL;
}

この関数は，必要な文字列バッファを自分で確保するので， 不要になったら LocalFree() で解放する必要がある．
(注意：このため，メモリ不足に陥った場合， そのメモリ不足を知らせるメッセージを取得できない可能性がある．)

この関数は Windows API を直接呼び出す場合だけでなく， Ｃ標準ライブラリ関数を呼び出した後にも (仕様として保証されているわけではないが) 事実上使用できる． (ライブラリ関数の中で Windows API を呼んでいるため．)

Ｃ標準ライブラリでエラーメッセージを取得するには strerror(errno) を使うが， これは英語だけなので，日本語表示が必要な場合には WinErrorMessage() や FormatMessage() の方が便利．また FormatMessage() の dwLanguageId 引数に言語識別子を指定すれば， 他言語のメッセージを取得できる．

Windows の基本的なエラーメッセージは kernel32.dll のリソース (メッセージテーブル) で定義されており，Windows 日本語版では日本語と英語のメッセージテーブルが定義されている．

• 日本語の言語ID：MAKELANGID(LANG_JAPANESE, SUBLANG_DEFAULT) ＝ 0x0411
• 英語の言語ID：MAKELANGID(LANG_ENGLISH, SUBLANG_DEFAULT) ＝ 0x0409

メッセージテーブルの内容は，Resource Hacker などのリソース編集ツールで見ることができる．

• FormatMessage 関数 (日 英)
• Resource Hacker (配布元，日本語版あり)
• Resource Hacker - 概要
• Resource Hacker(リソースハッカー) 〜日本語対応ではないアプリケーションを日本語対応に〜
• ツールエキスパート 13 なんて素敵にジャパネスク(序) - Resource Hacker(1) (マイコミジャーナル)

使用例

TCHAR *fileName, *message, buf[1024];
FILE *in;

if((in = _tfopen(fileName, _T("r"))) == NULL) {
  message = WinErrorMessage(GetLastError());
  _stprintf(buf, _T("\"%s\" をオープンできません。\n%s"), fileName, message);
  LocalFree(message);
  MessageBox(NULL, buf, AppName, MB_ICONERROR);
  return -1;
}

Modifier Keys (SHIFT，CTRL，ALT など) を指定するための定数． いずれも WinUser.h で定義されている．

• RegisterHotKey() で使用する定数

  MOD_ALT	0x0001
  MOD_CONTROL	0x0002
  MOD_SHIFT	0x0004
  MOD_WIN	0x0008	Windows キーを含むショートカットは OS が使用するために予約されている．
  MOD_NOREPEAT	0x4000	Win7 以降．ホットキーのオートリピートを無効にする．

• マウス入力メッセージ (WM_[LRMX]BUTTON{DOWN,UP,DBLCLK}，WM_MOUSE* など) で使用する定数

  MK_SHIFT	0x0004
  MK_CONTROL	0x0008
  MK_LBUTTON	0x0001
  MK_RBUTTON	0x0002
  MK_MBUTTON	0x0010
  MK_XBUTTON1	0x0020	Win2000 以降．
  MK_XBUTTON2	0x0040	Win2000 以降．

• ACCEL 構造体で使用する定数

  FSHIFT	0x04
  FCONTROL	0x08
  FALT	0x10

■ATOM とは何か，なぜそういう名前なのか？
(たぶん間違っていない個人的推測 ― 以前回答したページに今更リンク．)

• ATOMは何の略ですか (教えて！goo)
  ⇒ 回答 No.3〜4．

■各種コントロールの ATOM の値 (ATOM values for various control classes)

各種コントロールについて， テストプログラムを作って実際の値を調べてみると次のようになった．
(I wrote a test code to confirm the ATOM values, and the result is as follows.)

INITCOMMONCONTROLSEX::dwICC に ICC_STANDARD_CLASSES または ICC_LINK_CLASS が含まれているとなぜかエラーになる．
(Windows XP SP3 ＋ comctl32.dll 5.82.2900.5512 (2004/08/05))

■参考

• ついに判明、XP と 2000 のコモンコントロールの動作の違い
• http://ir9.jp/prog/ayu/datlog/tech_win32api/1092524669/1092524669_02.html >>440〜442
  Windows 98 ではエラーにならないらしい．
• InitCommonControlsEx (Geoff Chappell)
  comctl32.dll のバージョンごとの違いに関する詳しい記述あり．
  (ちゃんと読んでいない．(2014/09/14(日) 追記))

GetLastError() で ERROR_ALREADY_EXISTS が返るが， 上記のフラグの代わりに未定義のビット (0x00010000 以上) をセットしても同じ結果になるので， このエラーコードには意味がなさそうである．

GetModuleFileName() の第１引数 (hModule) に NULL を渡すと， 現在のプロセスに対応する実行ファイルのフルパス名を取得できる．

#include <windows.h>
#include <tchar.h>

TCHAR ExeFileName[MAX_PATH];

GetModuleFileName(NULL, ExeFileName, MAX_PATH);

プログラミングWindows第5版〈上〉Win32 APIを扱う開発者のための決定版! (Microsoft Programming Series)

posted with amazlet at 10.07.10

チャールズ ペゾルド
アスキー
売り上げランキング: 97738

おすすめ度の平均:

Windowsプログラマのバイブル本！
初版で勉強しました。
基本から確実に理解したいなら
詳しいが、少しバランスが！
硬派なWindowsプログラマーを志すならば

Amazon.co.jp で詳細を見る

プログラミングWindows第5版〈下〉Win32 APIを扱う開発者のための決定版! (Microsoft Programming Series)

posted with amazlet at 10.07.10

チャールズ ペゾルド
アスキー
売り上げランキング: 208637

おすすめ度の平均:

Windowsプログラマのバイブル本！
初版で勉強しました。
基本から確実に理解したいなら
詳しいが、少しバランスが！
硬派なWindowsプログラマーを志すならば

Amazon.co.jp で詳細を見る

Advanced Windows 第5版 上 (マイクロソフト公式解説書)

posted with amazlet at 10.07.10

Jeffrey Richter Christophe Nasarre
日経BPソフトプレス
売り上げランキング: 127753

おすすめ度の平均:

Advanced Windows第5版翻訳本

Amazon.co.jp で詳細を見る

Advanced Windows 第5版 下 (マイクロソフト公式解説書)

posted with amazlet at 10.07.10

Jeffrey Richter Christophe Nasarre
日経BPソフトプレス
売り上げランキング: 131018

Amazon.co.jp で詳細を見る

楽天で買う 価格：7,980円（税込、送料込）	インサイドWindows 第6版 上 (マイクロソフト公式解説書) posted with amazlet at 13.07.27 Mark E. Russinovich David A. Solomon Alex Ionescu 日経BP社 売り上げランキング: 82,632 Amazon.co.jpで詳細を見る
楽天で買う 価格：7,560円（税込、送料込）	インサイドWindows 第6版 下 (マイクロソフト公式解説書) posted with amazlet at 13.07.27 Mark E. Russinovich David A. Solomon Alex Ionescu 日経BP社 売り上げランキング: 82,761 Amazon.co.jpで詳細を見る

Microsoft Windows Internals (Part 1)

posted with amazlet at 13.07.27

Mark Russinovich David A. Solomon Alex Ionescu
Microsoft Pr
売り上げランキング: 23,301

Amazon.co.jpで詳細を見る

Microsoft Windows Internals (Part 2)

posted with amazlet at 13.07.27

Mark E. Russinovich David A. Solomon Alex Ionescu
Microsoft Pr
売り上げランキング: 25,543

Amazon.co.jpで詳細を見る

C++ユーザーのためのWindowsプログラミングの基礎知識―Visual C++とMFCを利用したプログラミング入門 (Ascii books)

posted with amazlet at 10.07.10

柏原 正三
アスキー
売り上げランキング: 359295

おすすめ度の平均:

この本はいいですよ
入門者にはお勧めできない
MFCを使ったWindowsプログラミング入門に最適です。

Amazon.co.jp で詳細を見る

猫でもわかるWindowsプログラミング 第3版 (猫でもわかるプログラミングシリーズ)

posted with amazlet at 10.07.10

粂井 康孝
ソフトバンククリエイティブ
売り上げランキング: 122154

おすすめ度の平均:

普通にわかりません。
猫ではわかりません
実践重視でテンポよい解説
著者はMSDNライブラリを読んでいない
Visual C++ 2008対応リニューアル版

Amazon.co.jp で詳細を見る

Windowsプログラミング逆引きクロス大辞典

posted with amazlet at 10.07.10

佐納 康治 曽我部 雄樹
秀和システム
売り上げランキング: 318690

おすすめ度の平均:

こんな辞書を待っていました

Amazon.co.jp で詳細を見る

Windowsゲームプログラミング 第2版 Game Developer

posted with amazlet at 10.07.11

赤坂 玲音
ソフトバンククリエイティブ
売り上げランキング: 24726

おすすめ度の平均:

内容はいいんだけど
C言語経験者向き
Windowsプログラミング

Amazon.co.jp で詳細を見る

楽天で買う 価格：3,990円（税込）

Windowsプログラミングの極意 歴史から学ぶ実践的Windowsプログラミング! posted with amazlet at 12.02.05 Raymond Chen アスキー 売り上げランキング: 190469 Amazon.co.jp で詳細を見る

日本語のタイトルは誤解を招きやすいが，Windows のプログラミング方法ではなく， 「Windows の○○はなぜそうなっているのか？」を解説した本．

■参考

• Windowsプログラミングの極意 - The OLD NEW THING - (Windowsプログラミングの極意 - The OLD NEW THING -)
• The Old New Thing (著者ブログ，この本の元ネタ)

• MSDN
  • Win32 および COM 開発
  • DirectX (日本語マニュアル)
    • Direct3D C/C++ リファレンス
    • Direct3D エクステンション (D3DX) C/C++ リファレンス
  • DirectX SDK (August 2009) (英語マニュアル)
  • ファイルフォーマット
    • Microsoft Office File Formats (2010年7月 最新版らしい)
    • Microsoft Office Binary (doc, xls, ppt) File Formats (2008年2月)
    • X ファイル リファレンス
    • DDS (DirectDraw Surface) ファイル リファレンス
• マイクロソフト サポート オンライン
  • [SDK32] COM10 以上のシリアルポートを指定する方法
    以前 MSDN でパスの命名規約について調べたときは，COM や LPT の番号は 1〜9 だけが予約されていると書いてあったので COM1〜COM9 しか使えないのかと思っていたが，このページによると \\.\ を付ければ COM10 以降も使えるらしい．
• The Old New Thing (Raymond Chen, MSDN Blogs)
  • Why do we even have the DefWindowProc function?
  • Taxes: Remote Desktop Connection and painting
  • Why are HANDLE return values so inconsistent?
• EternalWindows

  本サイトはC言語とWindows APIを用いたプログラムが永遠に栄えることを願うべく
  多数のプログラミング技術を提供しています

• VC++ プログラミング解説 (YuichiroMiura)
  • ウィンドウメッセージ
    • メッセージの優先度
    • WM_* 一覧表
• Windows API マスターへの道 -- GUI 編 (出雲 正尚)
  最終更新：2001/03/26(月) (FireFox で確認．)
• The Arcpit Windows API Topics (アークピット)
• Windowsパス名の落とし穴 (セキュアWindowsプログラミング)
  

  Windows のパス名 (ファイル名，ディレクトリ名，デバイス名) を扱う上で非常に参考になる (MSDN を調べても，パス名の細かい規則に関するまとまった情報がなかなか得られない)．

  「末尾文字の落とし穴」は私も昨年偶然発見した．ノード名の先頭， 途中，末尾，そして単一文字のノード名で使える文字を調べるプログラムを書いてテストしてみたところ， ノード名の末尾に半角のピリオドまたはスペースが連続している (正規表現で書けば "[ .]+$") と， それらはすべて無視 (削除) されることがわかった．

  なお，「Windows のパス名は大文字小文字を区別しない」 ということは誰でも知っていると思うが，これは ASCII 英字だけの話ではなく，Unicode レベルで大文字小文字が同一視される点に注意 (えっ，それも知ってる？)． したがって日本語環境で使える文字としては，全角英字もそうだし， ギリシャ文字やロシア文字もそうである． 例えばギリシャ文字を含むファイル名 "ΑΒΓ.TXT" は， それらを小文字にした "αβγ.txt" と同じと見なされる (実験で確認済)．

• あなたの知らない259文字越えの世界 (Tatsuの開発室)
  

  パス名の先頭に \\.\ を付けて，259文字 (MAX_PATH＝260 から終端 NUL を除いた有効文字数) 以上のパス名を持つファイルを作ってみたらどうなるか， という実験．私も \\.\ で長いパス名が使えることは知っていたので， 以前から実験してみたいとは思っていた．

  しかしほとんどのアプリケーションは固定長のバッファ (ひどいのになると MAX_PATH より小さい値を勝手に定義している (-_-#)) でパス名を扱い，\\.\ なんて使っていないので， そういうパス名は扱えないだろう．

  長過ぎるパス名が存在する可能性がある以上， 受け入れられるようにはしておきたいが， それを扱えないアプリケーションがほとんどなので， 自分からそういうパス名のファイルを作るのは避けた方がよい．

• 実例で学ぶ脆弱性対策コーディング (CodeZine)
  • WindowsのDLLだけが危ないのか？ DLL hijacking vulnerability概説 (前編， 後編)
• Windows 特殊な設定
• Windows XPで自動再生機能を無効化する (ANGIE WORKSHOP)
• 記事紹介: Inside Vista SP1 File Copy Improvements (1) (NyaRuRuの日記)
• COM総合研究所

1. 2006/09/21(木) 公開
2. 2006/10/14(土) ファイルをごみ箱に移動する．を追加．
3. 2006/10/29(日) Windows のエラーメッセージ文字列を取得する．を追加．
4. 2006/12/11(月) (１つ以上の) モードレスダイアログで TAB が効かない！ 準備開始．
5. 2006/12/24(日) ダイアログの座標系 (ダイアログテンプレート単位とダイアログベース単位) を追加．
6. 2007/01/08(月) ダイアログの座標系 (ダイアログテンプレート単位とダイアログベース単位) の誤記訂正．
7. 2007/03/20(火) モードレスダイアログで TAB が効かない！ ようやく内容作成．
8. 2007/05/06(日) ウインドウリサイズ時のちらつきを抑える．を追加．
9. 2007/06/16(土) 閉曲線・多角形の塗りつぶしモード (ALTERNATE と WINDING) 〜 点が閉曲線の内部にあるかどうかを判定する方法 〜 を追加．
10. 2007/06/29(金) ごみ箱の構造 (Windows XP Pro SP2 の場合) を追加 (まだ調査中)．
11. 2007/08/18(土) 外部へのリンクの「Windowsパス名の落とし穴」にコメントを追記． またそれに関連して，「ファイルをごみ箱に移動する．」の pFrom の説明にも追記．
12. 2007/11/04(日) 外部へのリンクに「あなたの知らない259文字越えの世界 (Tatsuの開発室)」を追加．
13. 2009/01/20(火) コントロールのウインドウクラス名一覧に SysLink を追加．
14. 2009/03/28(土) 下記を追加．
    • 実行環境バージョン指定マクロ (Windows SDK v6.1)
    • ウインドウの特徴
    • DestroyWindow() の処理手順
    • ウインドウメッセージ
    • InitCommonControlsEx() のエラー
    • Modifier Keys
15. 2009/07/20(月) TrackMouseEvent()，WM_(NC)MOUSEHOVER，WM_(NC)MOUSELEAVE を追加．
16. 2009/08/11(火) 実行環境バージョン指定マクロ に Windows 7 と IE8 を追加．
17. 2010/06/22(火) CB_GETCURSEL の説明を少し改定．
18. 2010/10/09(土) 「ウインドウメッセージ番号 (WM_*) の範囲」を追加．
19. 2010/10/28(木) WS_POPUP にちょっと追記．
20. 2011/09/11(日) 「ATOM」を追加．
21. 2012/01/15(日) 「_MSC_VER」を追加．
22. 2012/05/06(日) 「DC のマッピングモード」を追加．
23. 2012/07/30(月) 「(１つ以上の) モードレスダイアログで TAB が効かない！」をちょっと改訂．
24. 2012/11/23(金)
    • 「マウスメッセージ」を追加．
    • 「実行環境バージョン指定マクロ」を Windows Kits 8.0 用に更新．
25. 2013/02/09(土) 「閉曲線・多角形の塗りつぶしモード」に，Direct2D1 の塗りつぶしモードを追記．
26. 2013/03/29(金) 「ToolBar」を追加．
27. 2013/06/15(土) 記事の順序変更．
28. 2013/09/14(土) 「実行環境バージョン指定マクロ」を Windows Kits 8.1 用に更新．
29. 2013/10/13(日) 「_MSC_VER」に追記．
30. 2013/10/19(土) 「各種コントロールの ATOM の値」の表と説明を全面改訂．
31. 2013/10/20(日) 「ダイアログの座標系」に，ダイアログベース単位の計算方法を追記．
32. 2013/11/17(日) ウインドウメッセージ 0xC000 〜 0xFFFF についてちょっと追記．
33. 2014/05/01(木) 「各種コントロールの ATOM の値」に英語を併記．(外国のサイトからリンクされているので．)
34. 2014/11/22(土) 「_MSC_VER」に VC2015 と ToolsVersion を追記．
35. 2014/12/06(土) 「_MSC_VER」に Visual Studio 2013 Community を追記．
36. 2015/08/01(土) 「実行環境バージョン指定マクロ」を Windows Kits 10 用に更新．
37. 2016/11/05(土) 「閉曲線・多角形の塗りつぶしモード」に，.NET Framework / Silverlight の塗りつぶしモードを追記．
38. 2017/07/23(日) 「_MSC_VER」に VC2017 Community と ToolsVersion を追記．