`CWnd` クラス

[アーティクル]
04/03/2023

Microsoft Foundation Class ライブラリにあるすべてのウィンドウクラスの基本機能が用意されています。

構文

class CWnd : public CCmdTarget

メンバー

パブリックコンストラクター

名前	説明
`CWnd::CWnd`	`CWnd` オブジェクトを構築します。

パブリックメソッド

名前	説明
`CWnd::accDoDefaultAction`	オブジェクトの既定のアクションを実行するために、フレームワークによって呼び出されます。
`CWnd::accHitTest`	画面上の指定された位置にある子要素または子オブジェクトを取得するために、フレームワークによって呼び出されます。
`CWnd::accLocation`	指定されたオブジェクトの現在の画面位置を取得するために、フレームワークによって呼び出されます。
`CWnd::accNavigate`	コンテナー内の他のユーザーインターフェイス要素を走査するため、可能な場合はそのオブジェクトを取得するために、フレームワークによって呼び出されます。
`CWnd::accSelect`	選択を変更するため、または指定されたオブジェクトのキーボードフォーカスを移動するために、フレームワークによって呼び出されます。
`CWnd::AnimateWindow`	関連付けられたウィンドウオブジェクトをアニメーション化します。
`CWnd::ArrangeIconicWindows`	すべての最小化 (アイコン化) された子ウィンドウを整列します。
`CWnd::Attach`	Windows ハンドルを `CWnd` オブジェクトに関連付けます。
`CWnd::BeginModalState`	フレームウィンドウをモーダルにします。
`CWnd::BeginPaint`	描画用の `CWnd` を準備します。
`CWnd::BindDefaultProperty`	タイプライブラリに示されているように、呼び出し元オブジェクトの既定の単純バインドプロパティを、データソースコントロールに関連付けられているカーソルにバインドします。
`CWnd::BindProperty`	データバインディングコントロールのカーソルバインドプロパティをデータソースコントロールにバインドし、そのリレーションシップを MFC バインドマネージャーに登録します。
`CWnd::BringWindowToTop`	`CWnd` を重なったウィンドウのスタックの最上位に移動します。
`CWnd::CalcWindowRect`	クライアントの四角形からウィンドウ四角形を計算するために呼び出されます。
`CWnd::CancelToolTips`	ツールヒントコントロールを無効にします。
`CWnd::CenterWindow`	ウィンドウをその親ウィンドウの中央に揃えます。
`CWnd::ChangeClipboardChain`	クリップボードビューアーのチェインから `CWnd` を削除します。
`CWnd::CheckDlgButton`	チェックマークをボタンコントロールの横に配置したり、ボタンコントロールから削除したりします。
`CWnd::CheckRadioButton`	指定されたオプションボタンにチェックマークを付け、指定されたボタンのグループにある他のすべてのオプションボタンからチェックマークを削除します。
`CWnd::ChildWindowFromPoint`	子ウィンドウがある場合、指定された点を含む子ウィンドウを判断します。
`CWnd::ClientToScreen`	ディスプレイ上の指定された点または四角形のクライアント座標を画面座標に変換します。
`CWnd::CloseWindow`	ウィンドウを最小化します。
`CWnd::ContinueModal`	ウィンドウのモーダルステータスを継続します。
`CWnd::Create`	`CWnd` オブジェクトに関連付けられる子ウィンドウを作成し、初期化します。
`CWnd::CreateAccessibleProxy`	指定されたオブジェクトの Active Accessibility プロキシを作成します。
`CWnd::CreateCaret`	システムキャレットの新しい形を作成し、そのキャレットの所有権を取得します。
`CWnd::CreateControl`	MFC プログラムでは `CWnd` オブジェクトによって表される ActiveX コントロールを作成します。
`CWnd::CreateEx`	Windows のオーバーラップウィンドウ、ポップアップウィンドウ、または子ウィンドウを作成し、`CWnd` オブジェクトに関連付けます。
`CWnd::CreateGrayCaret`	灰色のブロックでシステムキャレットを作成し、そのキャレットの所有権を取得します。
`CWnd::CreateSolidCaret`	純色のブロックでシステムキャレットを作成し、そのキャレットの所有権を取得します。
`CWnd::DeleteTempMap`	`FromHandle` 関数で作成した一時的な `CWnd` オブジェクトをすべて削除するために、`CWinApp` のアイドル処理ハンドラーによって自動的に呼び出されます。
`CWnd::DestroyWindow`	関連付けられている Windows のウィンドウを破棄します。
`CWnd::Detach`	`CWnd` オブジェクトから Windows のハンドルを切り離し、そのハンドルを返します。
`CWnd::DlgDirList`	リストボックスにファイルリストまたはディレクトリリストを設定します。
`CWnd::DlgDirListComboBox`	コンボボックスにファイルリストまたはディレクトリリストを設定します。
`CWnd::DlgDirSelect`	リストボックスから現在の選択を取得します。
`CWnd::DlgDirSelectComboBox`	コンボボックスから現在の選択を取得します。
`CWnd::DragAcceptFiles`	ドラッグされたファイルがウィンドウで読み込まれることを示します。
`CWnd::DragDetect`	マウスをキャプチャし、ユーザーが左ボタンを離すか、Esc キーを押すか、または指定した点を中心にしたドラッグ四角形の外にマウスを移動するまで、移動を追跡します。
`CWnd::DrawAnimatedRects`	アイコンを開く動作や、ウィンドウの最小化または最大化の動作を、ワイヤフレームの四角形のアニメーションで表します。
`CWnd::DrawCaption`	キャプションを描画します。
`CWnd::DrawMenuBar`	メニューバーを再描画します。
`CWnd::EnableActiveAccessibility`	ユーザー定義の `Active Accessibility` 関数を有効にします。
`CWnd::EnableDynamicLayout`	ユーザーがウィンドウのサイズを変更したときに、子ウィンドウの位置とサイズを動的に調整できるようにします。
`CWnd::EnableD2DSupport`	ウィンドウの `D2D` のサポートを有効または無効にします。このメソッドは、メインウィンドウが初期化される前に呼び出します。
`CWnd::EnableScrollBar`	スクロールバーの矢印の一方または両方を有効または無効にします。
`CWnd::EnableScrollBarCtrl`	兄弟スクロールバーのコントロールを有効または無効にします。
`CWnd::EnableToolTips`	ツールヒントコントロールを有効にします。
`CWnd::EnableTrackingToolTips`	トラッキングモードのツールヒントコントロールを有効にします。
`CWnd::EnableWindow`	マウス入力およびキーボード入力を有効または無効にします。
`CWnd::EndModalLoop`	ウィンドウのモーダルステータスを終了します。
`CWnd::EndModalState`	フレームウィンドウをモーダルからモードレスに変更します。
`CWnd::EndPaint`	描画の終了を示します。
`CWnd::ExecuteDlgInit`	ダイアログリソースを開始します。
`CWnd::FilterToolTipMessage`	ダイアログボックス内のコントロールに関連付けられているタイトルまたはテキストを取得します。
`CWnd::FindWindow`	ウィンドウのハンドルを返します。ウィンドウのハンドルはそのウィンドウ名とウィンドウクラスによって識別されます。
`CWnd::FindWindowEx`	ウィンドウのハンドルを返します。ウィンドウのハンドルはそのウィンドウ名とウィンドウクラスによって識別されます。
`CWnd::FlashWindow`	ウィンドウを 1 回フラッシュします。
`CWnd::FlashWindowEx`	ウィンドウをフラッシュし、追加の機能を実行します。
`CWnd::FromHandle`	ウィンドウのハンドルが指定されている場合、`CWnd` オブジェクトへのポインターを返します。 `CWnd` オブジェクトがハンドルにアタッチされていない場合は、一時的な`CWnd` オブジェクトが作成されてアタッチされます。
`CWnd::FromHandlePermanent`	ウィンドウのハンドルが指定されている場合、`CWnd` オブジェクトへのポインターを返します。
`CWnd::get_accChild`	指定された子の `IDispatch` インターフェイスのアドレスを取得するために、フレームワークによって呼び出されます。
`CWnd::get_accChildCount`	このオブジェクトに属する子の数を取得するために、フレームワークによって呼び出されます。
`CWnd::get_accDefaultAction`	オブジェクトの既定のアクションを記述する文字列を取得するために、フレームワークによって呼び出されます。
`CWnd::get_accDescription`	指定されたオブジェクトの外観を記述する文字列を取得するために、フレームワークによって呼び出されます。
`CWnd::get_accFocus`	キーボードフォーカスを保持するオブジェクトを取得するために、フレームワークによって呼び出されます。
`CWnd::get_accHelp`	オブジェクトの Help プロパティ文字列を取得するためにフレームワークによって呼び出されます。
`CWnd::get_accHelpTopic`	指定されたオブジェクトに関連付けられている `WinHelp` ファイルの完全パスと、そのファイル内の適切なトピックの識別子を取得するために、フレームワークによって呼び出されます。
`CWnd::get_accKeyboardShortcut`	指定されたオブジェクトのショートカットキーまたはアクセスキーを取得するために、フレームワークによって呼び出されます。
`CWnd::get_accName`	指定されたオブジェクトの名前を取得するために、フレームワークによって呼び出されます。
`CWnd::get_accParent`	オブジェクトの親の `IDispatch` インターフェイスを取得するために、フレームワークによって呼び出されます。
`CWnd::get_accRole`	指定されたオブジェクトの役割を記述する情報を取得するために、フレームワークによって呼び出されます。
`CWnd::get_accSelection`	このオブジェクトの選択されている子を取得するために、フレームワークによって呼び出されます。
`CWnd::get_accState`	指定されたオブジェクトの現在の状態を取得するために、フレームワークによって呼び出されます。
`CWnd::get_accValue`	指定されたオブジェクトの値を取得するために、フレームワークによって呼び出されます。
`CWnd::GetActiveWindow`	アクティブなウィンドウを取得します。
`CWnd::GetAncestor`	指定したウィンドウの祖先ウィンドウオブジェクトを取得します。
`CWnd::GetCapture`	マウスキャプチャを持つ `CWnd` を取得します。
`CWnd::GetCaretPos`	キャレットの現在位置を示すクライアント座標を取得します。
`CWnd::GetCheckedRadioButton`	ボタンのグループ内で現在チェックされているオプションボタンの ID を返します。
`CWnd::GetClientRect`	`CWnd` クライアント領域の寸法を取得します。
`CWnd::GetClipboardOwner`	クリップボードの現在のオーナーへのポインターを取得します。
`CWnd::GetClipboardViewer`	クリップボードビューアーのチェインの最初のウィンドウへのポインターを取得します。
`CWnd::GetControlUnknown`	不明な ActiveX コントロールへのポインターを取得します。
`CWnd::GetDC`	クライアント領域のディスプレイコンテキストを取得します。
`CWnd::GetDCEx`	クライアント領域のディスプレイコンテキストを取得し、描画中のクリッピングを有効にします。
`CWnd::GetDCRenderTarget`	`CWnd` ウィンドウのデバイスコンテキスト (DC) レンダーターゲットを取得します。
`CWnd::GetDescendantWindow`	すべての子孫ウィンドウを検索し、指定された ID を持つウィンドウを返します。
`CWnd::GetDesktopWindow`	Windows のデスクトップウィンドウを取得します。
`CWnd::GetDlgCtrlID`	`CWnd` が子ウィンドウの場合、この関数を呼び出すと、その ID 値が返されます。
`CWnd::GetDlgItem`	指定されたダイアログボックスから指定された ID を持つコントロールを取得します。
`CWnd::GetDlgItemInt`	指定されたダイアログボックスにあるコントロールのテキストを整数値に変換します。
`CWnd::GetDlgItemText`	コントロールに関連付けられているキャプションまたはテキストを取得します。
`CWnd::GetDSCCursor`	データソースコントロールの DataSource、UserName、Password、および SQL プロパティで定義されている、基になるカーソルへのポインターを取得します。
`CWnd::GetDynamicLayout`	動的レイアウトマネージャーオブジェクトへのポインターを取得します。
`CWnd::GetExStyle`	ウィンドウの拡張スタイルを返します。
`CWnd::GetFocus`	現在入力フォーカスを持っている `CWnd` へのポインターを取得します。
`CWnd::GetFont`	現在のフォントを取得します。
`CWnd::GetForegroundWindow`	手前のウィンドウ (ユーザーが現在作業しているトップレベルウィンドウ) へのポインターを返します。
`CWnd::GetIcon`	アイコンへのハンドルを取得します。
`CWnd::GetLastActivePopup`	`CWnd` が所有するポップアップウィンドウのうち、直前にアクティブだったウィンドウを調べます。
`CWnd::GetLayeredWindowAttributes`	レイヤードウィンドウの不透明度および透明度のカラーキーを取得します。
`CWnd::GetMenu`	指定されたメニューへのポインターを取得します。
`CWnd::GetNextDlgGroupItem`	コントロールのグループ内で、指定されたコントロールの直前または次に位置するコントロールを検索します。
`CWnd::GetNextDlgTabItem`	指定したコントロールの後 (または前) の `WS_TABSTOP` スタイルを持つ最初のコントロールを取得します。
`CWnd::GetNextWindow`	ウィンドウマネージャーのリストから次 (または前) のウィンドウを返します。
`CWnd::GetOleControlSite`	指定された ActiveX コントロールのカスタムサイトを取得します。
`CWnd::GetOpenClipboardWindow`	現在クリップボードが開いているウィンドウへのポインターを取得します。
`CWnd::GetOwner`	`CWnd` のオーナーへのポインターを取得します。
`CWnd::GetParent`	`CWnd` の親ウィンドウがある場合、そのウィンドウを取得します。
`CWnd::GetParentFrame`	`CWnd` オブジェクトの親フレームウィンドウを取得します。
`CWnd::GetParentOwner`	子ウィンドウの親ウィンドウへのポインターを返します。
`CWnd::GetProperty`	ActiveX コントロールプロパティを取得します。
`CWnd::GetRenderTarget`	このウィンドウに関連付けられているレンダーターゲットを取得します。
`CWnd::GetSafeHwnd`	`m_hWnd`を返します。`this` ポインターが NULL の場合は NULL を返します。
`CWnd::GetSafeOwner`	指定されたウィンドウのセーフオーナーを取得します。
`CWnd::GetScrollBarCtrl`	兄弟スクロールバーのコントロールを返します。
`CWnd::GetScrollBarInfo`	指定されたスクロールバーの情報を取得します。
`CWnd::GetScrollInfo`	`SCROLLINFO` 構造体がスクロールバーについて保持している情報を取得します。
`CWnd::GetScrollLimit`	スクロールバーの限界値を取得します。
`CWnd::GetScrollPos`	スクロールボックスの現在位置を取得します。
`CWnd::GetScrollRange`	指定されたスクロールバーの現在の最小位置と最大位置をコピーします。
`CWnd::GetStyle`	現在のウィンドウスタイルを返します。
`CWnd::GetSystemMenu`	アプリケーションがコピーおよび変更のためにコントロールメニューにアクセスできるようにします。
`CWnd::GetTitleBarInfo`	指定されたタイトルバーの情報を取得します。
`CWnd::GetTopLevelFrame`	ウィンドウのトップレベルのフレームウィンドウを取得します。
`CWnd::GetTopLevelOwner`	トップレベルのウィンドウを取得します。
`CWnd::GetTopLevelParent`	ウィンドウのトップレベルの親ウィンドウを取得します。
`CWnd::GetTopWindow`	`CWnd` に属する第 1 レベルの子ウィンドウを返します。
`CWnd::GetUpdateRect`	`CWnd` 更新領域を完全に囲む最小の四角形の座標を取得します。
`CWnd::GetUpdateRgn`	`CWnd` 更新領域を取得します。
`CWnd::GetWindow`	対象となるウィンドウとの間に指定された関係が成り立つウィンドウを返します。
`CWnd::GetWindowContextHelpId`	ヘルプコンテキスト識別子を取得します。
`CWnd::GetWindowDC`	キャプションバー、メニュー、スクロールバーを含むウィンドウ全体のディスプレイコンテキストを取得します。
`CWnd::GetWindowedChildCount`	関連付けられている子ウィンドウの数を返します。
`CWnd::GetWindowInfo`	ウィンドウに関する情報を返します。
`CWnd::GetWindowlessChildCount`	関連付けられているウィンドウなしの子ウィンドウの数を返します。
`CWnd::GetWindowPlacement`	ウィンドウの表示状態、通常の位置 (復元された位置)、最小化された位置、および最大表示された位置を取得します。
`CWnd::GetWindowRect`	`CWnd` の画面座標を取得します。
`CWnd::GetWindowRgn`	ウィンドウのウィンドウ領域のコピーを取得します。
`CWnd::GetWindowText`	ウィンドウのテキストまたはキャプションタイトル (ある場合) を返します。
`CWnd::GetWindowTextLength`	ウィンドウのテキストまたはキャプションタイトルの長さを返します。
`CWnd::HideCaret`	ディスプレイ画面からキャレットを削除して非表示にします。
`CWnd::HiliteMenuItem`	トップレベル (メニューバー) のメニュー項目の強調表示を設定または解除します。
`CWnd::HtmlHelp`	HTML ヘルプアプリケーションを起動するために呼び出されます。
`CWnd::Invalidate`	クライアント領域全体を無効にします。
`CWnd::InvalidateRect`	指定された四角形を現在の更新領域に追加して、その四角形内のクライアント領域を無効にします。
`CWnd::InvalidateRgn`	指定された領域を現在の更新領域に追加して、その領域内のクライアント領域を無効にします。
`CWnd::InvokeHelper`	ActiveX コントロールメソッドまたはプロパティを呼び出します。
`CWnd::IsChild`	`CWnd` が指定されたウィンドウの子ウィンドウか、または指定されたウィンドウの別の直系の子孫ウィンドウであるかを示します。
`CWnd::IsD2DSupportEnabled`	D2D サポートが有効かどうかを判断します。
`CWnd::IsDialogMessage`	指定されたメッセージがモードレスダイアログボックス用かどうかを判断します。モードレスダイアログボックス用のメッセージである場合は、そのメッセージを処理します。
`CWnd::IsDlgButtonChecked`	ボタンコントロールがチェックされているかどうかを判断します。
`CWnd::IsDynamicLayoutEnabled`	このウィンドウで動的レイアウトが有効かどうかを判断します。動的レイアウトが有効な場合は、ユーザーが親ウィンドウのサイズを変更したときに、子ウィンドウの位置とサイズを変更できます。
`CWnd::IsIconic`	`CWnd` が最小化 (アイコン化) されているかどうかを判断します。
`CWnd::IsTouchWindow`	`CWnd` でタッチ操作がサポートされているかどうかを示します。
`CWnd::IsWindowEnabled`	ウィンドウでマウス入力およびキーボード入力が有効かどうかを判断します。
`CWnd::IsWindowVisible`	ウィンドウが表示可能かどうかを判断します。
`CWnd::IsZoomed`	`CWnd` が最大表示されているかどうかを判断します。
`CWnd::KillTimer`	システムタイマーを中止します。
`CWnd::LockWindowUpdate`	指定されたウィンドウでの描画を無効化、または再有効化します。
`CWnd::MapWindowPoints`	複数の点を `CWnd` の座標空間から他のウィンドウの座標空間へ変換 (マップ) します。
`CWnd::MessageBox`	アプリケーションで用意されたメッセージとキャプションを含むウィンドウを作成し、表示します。
`CWnd::ModifyStyle`	現在のウィンドウスタイルを変更します。
`CWnd::ModifyStyleEx`	ウィンドウの拡張スタイルを変更します。
`CWnd::MoveWindow`	`CWnd` の位置と寸法を変更します。
`CWnd::NotifyWinEvent`	定義済みイベントが発生したことをシステムに通知します。
`CWnd::OnAmbientProperty`	アンビエントプロパティ値を実装します。
`CWnd::OnDrawIconicThumbnailOrLivePreview`	Windows 7 のタブのサムネイルに表示する、またはアプリケーションのピーク用にクライアントで表示するビットマップを取得する必要があるときに、フレームワークによって呼び出されます。
`CWnd::OnHelp`	アプリケーション内で F1 ヘルプを (現在のコンテキストを使って) 処理します。
`CWnd::OnHelpFinder`	`ID_HELP_FINDER`コマンドと`ID_DEFAULT_HELP` コマンドを処理します。
`CWnd::OnHelpIndex`	`ID_HELP_INDEX` コマンドを処理し、既定のヘルプトピックを提供します。
`CWnd::OnHelpUsing`	`ID_HELP_USING` コマンドを処理します。
`CWnd::OnToolHitTest`	点が指定されたツールの外接する四角形内にあるかどうかを判断し、そのツールに関する情報を取得します。
`CWnd::OpenClipboard`	クリップボードを開きます。他のアプリケーションは、Windows `CloseClipboard` 関数が呼び出されるまでクリップボードを変更できません。
`CWnd::PaintWindowlessControls`	コントロールコンテナーのウィンドウなしのコントロールを描画します。
`CWnd::PostMessage`	メッセージをアプリケーションキューに配置し、ウィンドウがメッセージを処理するのを待たずに制御を返します。
`CWnd::PreCreateWindow`	`CWnd` オブジェクトに関連付けられている Windows のウィンドウが作成される前に呼び出されます。
`CWnd::PreSubclassWindow`	`SubclassWindow`が呼び出される前に、他の必要なサブクラス化を実行できるようにします。
`CWnd::PreTranslateMessage`	ウィンドウメッセージが Windows 関数の `TranslateMessage` および `DispatchMessage` にディスパッチされる前に、メッセージにフィルターをかけるために `CWinApp` によって使用されます。
`CWnd::Print`	指定されたデバイスコンテキストで現在のウィンドウを描画します。
`CWnd::PrintClient`	指定されたデバイスコンテキスト (通常はプリンターデバイスコンテキスト) で、さまざまなウィンドウを描画します。
`CWnd::PrintWindow`	表示されているウィンドウを指定されたデバイスコンテキスト (通常はプリンター DC) にコピーします。
`CWnd::RedrawWindow`	クライアント領域内の指定された四角形または領域を更新します。
`CWnd::RegisterTouchWindow`	Windows タッチのサポートを登録または登録解除します。
`CWnd::ReleaseDC`	他のアプリケーションが使用できるように、クライアントデバイスコンテキストおよびウィンドウデバイスコンテキストを解放します。
`CWnd::RepositionBars`	クライアント領域のコントロールバーの位置を変更します。
`CWnd::RunModalLoop`	モーダルステータスであるウィンドウのメッセージを取得、変換、またはディスパッチします。
`CWnd::ScreenToClient`	ディスプレイ上の指定された点または四角形の画面座標をクライアント座標に変換します。
`CWnd::ScrollWindow`	クライアント領域の内容をスクロールします。
`CWnd::ScrollWindowEx`	クライアント領域の内容をスクロールします。 `ScrollWindow` と同様に、追加機能があります。
`CWnd::SendChildNotifyLastMsg`	子ウィンドウがタスクを処理できるように、親ウィンドウから子ウィンドウへ通知メッセージを送信します。
`CWnd::SendDlgItemMessage`	指定されたコントロールにメッセージを送信します。
`CWnd::SendMessage`	`CWnd` オブジェクトにメッセージを送信し、メッセージが処理されるまで待機します。
`CWnd::SendMessageToDescendants`	対象となるウィンドウのすべての子孫ウィンドウにメッセージを送信します。
`CWnd::SendNotifyMessage`	指定されたメッセージをウィンドウに送信し、呼び出し元のスレッドがウィンドウを作成したかどうかに応じて、できるだけ早く制御を返します。
`CWnd::SetActiveWindow`	ウィンドウをアクティブにします。
`CWnd::SetCapture`	以降のすべてのマウス入力を `CWnd` に送信します。
`CWnd::SetCaretPos`	指定された位置にキャレットを移動します。
`CWnd::SetClipboardViewer`	クリップボードの内容が変更されるたびに通知を受けるウィンドウのチェインに `CWnd` を追加します。
`CWnd::SetDlgCtrlID`	ウィンドウのウィンドウ ID またはコントロール ID を設定します (ダイアログボックス内のコントロールだけでなく、子ウィンドウの場合もあります)。
`CWnd::SetDlgItemInt`	コントロールのテキストを、整数値を表現する文字列に設定します。
`CWnd::SetDlgItemText`	指定されたダイアログボックスにあるコントロールのキャプションまたはテキストを設定します。
`CWnd::SetFocus`	入力フォーカスを要求します。
`CWnd::SetFont`	現在のフォントを設定します。
`CWnd::SetForegroundWindow`	ウィンドウを作成したスレッドをフォアグラウンドに置き、そのウィンドウをアクティブにします。
`CWnd::SetIcon`	特定のアイコンへのハンドルを設定します。
`CWnd::SetLayeredWindowAttributes`	レイヤードウィンドウの不透明度および透明度のカラーキーを設定します。
`CWnd::SetMenu`	メニューを指定されたメニューに設定します。
`CWnd::SetOwner`	`CWnd` のオーナーを変更します。
`CWnd::SetParent`	親ウィンドウを変更します。
`CWnd::SetProperty`	ActiveX コントロールプロパティを設定します。
`CWnd::SetRedraw`	`CWnd` の変更内容を再描画したり、または再描画を禁止したりできます。
`CWnd::SetScrollInfo`	スクロールバーの情報を設定します。
`CWnd::SetScrollPos`	スクロールボックスの現在位置を設定します。また、指定されている場合は、新しい位置で表示されるようにスクロールバーを再描画します。
`CWnd::SetScrollRange`	指定されたスクロールバーの最小位置と最大位置の値を設定します。
`CWnd::SetTimer`	トリガーされたときに `WM_TIMER` メッセージを送信するシステムタイマーをインストールします。
`CWnd::SetWindowContextHelpId`	ヘルプコンテキスト識別子を設定します。
`CWnd::SetWindowPlacement`	ウィンドウの表示状態、通常の位置 (復元された位置)、最小化された位置、および最大表示された位置を設定します。
`CWnd::SetWindowPos`	子ウィンドウ、ポップアップウィンドウ、およびトップレベルウィンドウのサイズ、位置、および順序付けを変更します。
`CWnd::SetWindowRgn`	ウィンドウ領域を設定します。
`CWnd::SetWindowText`	ウィンドウテキストまたはキャプションタイトル (ある場合) を指定されたテキストに設定します。
`CWnd::ShowCaret`	ディスプレイ上のキャレット現在位置にキャレットを表示します。キャレットは、表示されると自動的に点滅します。
`CWnd::ShowOwnedPopups`	ウィンドウが所有するすべてのポップアップウィンドウを表示または非表示にします。
`CWnd::ShowScrollBar`	スクロールバーを表示または非表示にします。
`CWnd::ShowWindow`	ウィンドウを表示または非表示にします。
`CWnd::SubclassDlgItem`	Windows コントロールを `CWnd` オブジェクトに関連付け、`CWnd` のメッセージマップを通じてそのオブジェクトにメッセージを送信します。
`CWnd::SubclassWindow`	ウィンドウを `CWnd` オブジェクトに関連付け、その `CWnd` のメッセージマップを通じてメッセージがルーティングされるようにします。
`CWnd::UnlockWindowUpdate`	`CWnd::LockWindowUpdate` でロックされていたウィンドウのロックを解除します。
`CWnd::UnsubclassWindow`	`CWnd` オブジェクトからウィンドウをデタッチします。
`CWnd::UpdateData`	ダイアログボックスのデータを初期化または取得します。
`CWnd::UpdateDialogControls`	ダイアログの各ボタンの状態および他のコントロールの状態を更新します。
`CWnd::UpdateLayeredWindow`	レイヤードウィンドウの位置、サイズ、形状、内容、および透明度を更新します。
`CWnd::UpdateWindow`	クライアント領域を更新します。
`CWnd::ValidateRect`	指定された四角形を現在の更新領域から削除して、その四角形内のクライアント領域を有効にします。
`CWnd::ValidateRgn`	現在の更新領域から指定された領域を削除して、その領域内のクライアント領域を有効にします。
`CWnd::WindowFromPoint`	指定された点を含むウィンドウを識別します。
`CWnd::WinHelp`	WinHelp アプリケーションを起動します。

保護メソッド

名前	説明
`CWnd::Default`	既定のウィンドウプロシージャを呼び出します。既定のウィンドウプロシージャは、アプリケーションが処理しないウィンドウメッセージに対する既定の処理を提供します。
`CWnd::DefWindowProc`	既定のウィンドウプロシージャを呼び出します。既定のウィンドウプロシージャは、アプリケーションが処理しないウィンドウメッセージに対する既定の処理を提供します。
`CWnd::DoDataExchange`	ダイアログデータエクスチェンジとダイアログデータ検証用です。 `UpdateData` によって呼び出されます。
`CWnd::GetCurrentMessage`	ウィンドウが現在処理しているメッセージへのポインターを返します。 `On``Message`メッセージハンドラーメンバー関数内でのみ呼び出す必要があります。
`CWnd::InitDynamicLayout`	ウィンドウの動的レイアウトを初期化するために、フレームワークによって呼び出されます。
`CWnd::LoadDynamicLayoutResource`	リソースファイルから動的レイアウト情報を読み込みます。
`CWnd::OnActivate`	`CWnd` がアクティブまたは非アクティブになるときに呼び出されます。
`CWnd::OnActivateApp`	アプリケーションがアクティブまたは非アクティブになるときに呼び出されます。
`CWnd::OnAppCommand`	ユーザーがアプリケーションのコマンドイベントを生成するときに呼び出されます。
`CWnd::OnAskCbFormatName`	クリップボードオーナーがクリップボードの内容を表示するときに、クリップボードビューアーによって呼び出されます。
`CWnd::OnCancelMode`	`CWnd` でマウスのキャプチャなどの内部モードを取り消すことができるようにするために呼び出されます。
`CWnd::OnCaptureChanged`	マウスキャプチャを失うウィンドウにメッセージを送信します。
`CWnd::OnChangeCbChain`	指定されたウィンドウがチェインから削除されようとしていることを通知します。
`CWnd::OnChangeUIState`	ユーザーインターフェイス (UI) 状態を変更する必要があるときに呼び出されます。
`CWnd::OnChar`	キーストロークが非システム文字に変換されるときに呼び出されます。
`CWnd::OnCharToItem`	`WM_CHAR` メッセージに応答して、`LBS_WANTKEYBOARDINPUT` スタイルを持つ子リストボックスによって呼び出されます。
`CWnd::OnChildActivate`	`CWnd` のサイズや位置が変更されたり、`CWnd` がアクティブになったりした場合に、マルチドキュメントインターフェイス (MDI) 子ウィンドウに対して呼び出されます。
`CWnd::OnChildNotify`	親ウィンドウによって呼び出されます。親ウィンドウにメッセージを送るコントロールが、コントロール通知に対応できるようにします。
`CWnd::OnClipboardUpdate`	クリップボードの内容が変更されたときに呼び出されます。
`CWnd::OnClose`	`CWnd` を終了するシグナルとして呼び出されます。
`CWnd::OnColorizationColorChanged`	非クライアント領域のレンダリングのポリシーが変更されたときに呼び出されます。
`CWnd::OnCommand`	ユーザーがコマンドを選択すると呼び出されます。
`CWnd::OnCompacting`	Windows がシステムメモリの低下を検出すると呼び出されます。
`CWnd::OnCompareItem`	子の並べ替えられたオーナー描画コンボボックスやリストボックス内の新しい項目の相対位置を判断するために、呼び出されます。
`CWnd::OnCompositionChanged`	Desktop Window Manager (DWM) コンポジションを有効にするか無効にするときに、すべてのトップレベルウィンドウに対して呼び出されます。
`CWnd::OnContextMenu`	ウィンドウ内でマウスの右ボタンをクリックすると呼び出されます。
`CWnd::OnCopyData`	あるアプリケーションから他のアプリケーションにデータをコピーします。
`CWnd::OnCreate`	ウィンドウの作成の一部として呼び出されます。
`CWnd::OnCtlColor`	`CWnd` がコントロールの親である場合、コントロールの描画時に呼び出されます。
`CWnd::OnDeadChar`	キーストロークが非システムのデッド文字 (アクセント記号付き文字など) に変換されるときに呼び出されます。
`CWnd::OnDeleteItem`	オーナー描画の子リストボックスやコンボボックスが破棄されるとき、または項目がコントロールから削除されるときに呼び出されます。
`CWnd::OnDestroy`	`CWnd` が破棄されているときに呼び出されます。
`CWnd::OnDestroyClipboard`	Windows `EmptyClipboard` 関数の呼び出しによってクリップボードが空になったときに呼び出されます。
`CWnd::OnDeviceChange`	デバイスやコンピューターのハードウェア構成が変更されたときに、アプリケーションまたはデバイスドライバーに通知します。
`CWnd::OnDevModeChange`	ユーザーがデバイスモードの設定を変更したときに、すべてのトップレベルのウィンドウに対して呼び出されます。
`CWnd::OnDrawClipboard`	クリップボードの内容が変更されるときに呼び出されます。
`CWnd::OnDrawItem`	オーナー描画の子ボタンコントロール、コンボボックスコントロール、リストボックスコントロール、またはメニューの外観を描画する必要があるときに呼び出されます。
`CWnd::OnDropFiles`	ドロップされたファイルを受け取るように登録したウィンドウ上で、ユーザーがマウスの左ボタンを離したときに呼び出されます。
`CWnd::OnEnable`	`CWnd` が有効または無効になるときに呼び出されます。
`CWnd::OnEndSession`	セッションが終了するときに呼び出されます。
`CWnd::OnEnterIdle`	モーダルダイアログボックスまたはメニューがアイドル状態になることをアプリケーションのメインウィンドウプロシージャに通知するために呼び出されます。
`CWnd::OnEnterMenuLoop`	メニューモーダルループに入るときに呼び出されます。
`CWnd::OnEnterSizeMove`	影響を受けるウィンドウが移動またはサイズ変更のモーダルループに入った後に呼び出されます。
`CWnd::OnEraseBkgnd`	ウィンドウの背景を消去する必要があるときに呼び出されます。
`CWnd::OnExitMenuLoop`	メニューモーダルループが終了したときに呼び出されます。
`CWnd::OnExitSizeMove`	影響を受けるウィンドウが移動またはサイズ変更のモーダルループを終了した後に呼び出されます。
`CWnd::OnFontChange`	フォントリソースのプールの変更時に呼び出されます。
`CWnd::OnGetDlgCode`	方向キーおよび Tab キーによる入力そのものをコントロールが処理できるように、そのコントロールに対して呼び出されます。
`CWnd::OnGetMinMaxInfo`	Windows が最大表示されたときの位置や寸法、または最小や最大のトラッキングサイズを知る必要があるときに、必ず呼び出されます。
`CWnd::OnHelpInfo`	ユーザーが F1 キーを押したときに、フレームワークによって呼び出されます。
`CWnd::OnHotKey`	ユーザーがシステム全体でのショートカットキーを押したときに呼び出されます。
`CWnd::OnHScroll`	`CWnd` の水平スクロールバーをクリックすると、呼び出されます。
`CWnd::OnHScrollClipboard`	クリップボードオーナーがクリップボード内のイメージをスクロールし、適切な部分を無効にし、スクロールバーの値を更新する必要がある場合に呼び出されます。
`CWnd::OnIconEraseBkgnd`	`CWnd` が最小化 (アイコン化) され、アイコンを描画する前にアイコンの背景を設定する必要があるときに呼び出されます。
`CWnd::OnInitMenu`	メニューがアクティブになるときに呼び出されます。
`CWnd::OnInitMenuPopup`	ポップアップメニューがアクティブになるときに呼び出されます。
`CWnd::OnInputDeviceChange`	I/O デバイスがシステムで追加または削除されたときに呼び出されます。
`CWnd::OnInputLangChange`	アプリケーションの入力言語が変更されると呼び出されます。
`CWnd::OnInputLangChangeRequest`	ユーザーが新しい入力言語を選択するときに呼び出されます。
`CWnd::OnKeyDown`	非システムキーが押されると呼び出されます。
`CWnd::OnKeyUp`	非システムキーが離されると呼び出されます。
`CWnd::OnKillFocus`	`CWnd` が入力フォーカスを失う直前に呼び出されます。
`CWnd::OnLButtonDblClk`	マウスの左ボタンをダブルクリックすると呼び出されます。
`CWnd::OnLButtonDown`	マウスの左ボタンを押すと呼び出されます。
`CWnd::OnLButtonUp`	マウスの左ボタンを離すと呼び出されます。
`CWnd::OnMButtonDblClk`	マウスの中央ボタンをダブルクリックすると呼び出されます。
`CWnd::OnMButtonDown`	マウスの中央ボタンを押すと呼び出されます。
`CWnd::OnMButtonUp`	マウスの中央ボタンを離すと呼び出されます。
`CWnd::OnMDIActivate`	MDI 子ウィンドウがアクティブまたは非アクティブになるときに呼び出されます。
`CWnd::OnMeasureItem`	オーナー描画の子コンボボックス、リストボックス、またはメニュー項目が作成されるときに呼び出されます。 `CWnd` は、コントロールの大きさを Windows に通知します。
`CWnd::OnMenuChar`	ユーザーが押したメニューのニーモニック文字が、現在のメニューに組み込まれているニーモニックと一致しないときに呼び出されます。
`CWnd::OnMenuDrag`	ユーザーがメニュー項目をドラッグするときに呼び出されます。
`CWnd::OnMenuGetObject`	マウスカーソルがメニュー項目に入るか、項目の中央から項目の上部または下部に移動したときに呼び出されます。
`CWnd::OnMenuRButtonUp`	カーソルがメニュー項目にあるときに、マウスの右ボタンを離すと呼び出されます。
`CWnd::OnMenuSelect`	ユーザーがメニュー項目を選択するときに呼び出されます。
`CWnd::OnMouseActivate`	カーソルが非アクティブウィンドウにあるときに、マウスボタンを押すと呼び出されます。
`CWnd::OnMouseHover`	`TrackMouseEvent`の前の呼び出しで指定された期間、ウィンドウのクライアント領域にカーソルが移動したときに呼び出されます。
`CWnd::OnMouseHWheel`	マウスの水平スクロールホイールが傾いているか、回転したときに呼び出されます。
`CWnd::OnMouseLeave`	`TrackMouseEvent`の前の呼び出しで指定されたウィンドウのクライアント領域からカーソルが離れたときに呼び出されます。
`CWnd::OnMouseMove`	マウスのカーソルの移動時に呼び出されます。
`CWnd::OnMouseWheel`	マウスホイールの回転時に呼び出されます。 Windows NT 4.0 メッセージ処理を使用します。
`CWnd::OnMove`	`CWnd` の位置が変更されると、呼び出されます。
`CWnd::OnMoving`	ユーザーが `CWnd` オブジェクトを移動中であることを示します。
`CWnd::OnNcActivate`	アクティブまたは非アクティブ状態を示すために、非クライアント領域を変更する必要があるときに呼び出されます。
`CWnd::OnNcCalcSize`	クライアント領域のサイズと位置を計算する必要があるときに呼び出されます。
`CWnd::OnNcCreate`	クライアント以外の領域が作成されるときに `OnCreate` する前に呼び出されます。
`CWnd::OnNcDestroy`	非クライアント領域が破棄されるときに呼び出されます。
`CWnd::OnNcHitTest`	`CWnd` がカーソルを含む場合、または `SetCapture` を使用してマウス入力をキャプチャした場合に、マウスを移動するごとに Windows によって呼び出されます。
`CWnd::OnNcLButtonDblClk`	カーソルが `CWnd` の非クライアント領域内にあるときに、マウスの左ボタンをダブルクリックすると呼び出されます。
`CWnd::OnNcLButtonDown`	カーソルが `CWnd` の非クライアント領域内にあるときに、マウスの左ボタンを押すと呼び出されます。
`CWnd::OnNcLButtonUp`	カーソルが `CWnd` の非クライアント領域内にあるときに、マウスの左ボタンを離すと呼び出されます。
`CWnd::OnNcMButtonDblClk`	カーソルが `CWnd` の非クライアント領域内にあるときに、マウスの中央ボタンをダブルクリックすると呼び出されます。
`CWnd::OnNcMButtonDown`	カーソルが `CWnd` の非クライアント領域内にあるときに、マウスの中央ボタンを押すと呼び出されます。
`CWnd::OnNcMButtonUp`	カーソルが `CWnd` の非クライアント領域内にあるときに、マウスの中央ボタンを離すと呼び出されます。
`CWnd::OnNcMouseHover`	`TrackMouseEvent`の前の呼び出しで指定された期間、ウィンドウのクライアント以外の領域にカーソルを置いたときに呼び出されます。
`CWnd::OnNcMouseLeave`	フレームワークは、 `TrackMouseEvent`の前の呼び出しで指定されたウィンドウのクライアント以外の領域からカーソルが離れると、このメンバー関数を呼び出します。
`CWnd::OnNcMouseMove`	`CWnd` の非クライアント領域内でカーソルが移動するときに呼び出されます。
`CWnd::OnNcPaint`	非クライアント領域を描画する必要があるときに呼び出されます。
`CWnd::OnNcRButtonDblClk`	カーソルが `CWnd` の非クライアント領域内にあるときに、マウスの右ボタンをダブルクリックすると呼び出されます。
`CWnd::OnNcRButtonDown`	カーソルが `CWnd` の非クライアント領域内にあるときに、マウスの右ボタンを押すと呼び出されます。
`CWnd::OnNcRButtonUp`	カーソルが `CWnd` の非クライアント領域内にあるときに、マウスの右ボタンを離すと呼び出されます。
`CWnd::OnNcRenderingChanged`	非クライアント領域のレンダリングのポリシーが変更されたときに呼び出されます。
`CWnd::OnNcXButtonDblClk`	カーソルがウィンドウのクライアント以外の領域にあるときに、ユーザーが `XBUTTON1` または `XBUTTON2` をダブルクリックしたときに呼び出されます。
`CWnd::OnNcXButtonDown`	カーソルがウィンドウのクライアント以外の領域にあるときに、ユーザーがマウスの `XBUTTON1` または `XBUTTON2` を押したときに呼び出されます。
`CWnd::OnNcXButtonUp`	カーソルがウィンドウのクライアント以外の領域にあるときに、ユーザーがマウスの `XBUTTON1` または `XBUTTON2` を離したときに呼び出されます。
`CWnd::OnNextMenu`	右方向キーまたは左方向キーでメニューバーとシステムメニューを切り替えたときに呼び出されます。
`CWnd::OnNotify`	コントロールでイベントが発生したこと、またはコントロールが情報を必要としていることを親ウィンドウに通知するために、フレームワークによって呼び出されます。
`CWnd::OnNotifyFormat`	現在のウィンドウが、 `WM_NOTIFY` 通知メッセージで ANSI または Unicode の構造体を受け入れるかどうかを判断するために呼び出されます。
`CWnd::OnPaint`	ウィンドウの一部を再描画するために呼び出されます。
`CWnd::OnPaintClipboard`	クリップボードビューアーのクライアント領域の再描画が必要なときに呼び出されます。
`CWnd::OnPaletteChanged`	カラーパレットを使用するウィンドウによる論理パレットの実体化とクライアント領域の更新を許可するために呼び出されます。
`CWnd::OnPaletteIsChanging`	あるアプリケーションで論理パレットが実体化されるときに、他のアプリケーションに通知します。
`CWnd::OnParentNotify`	子ウィンドウを作成または破棄するか、カーソルが子ウィンドウの上にあるときにマウスボタンをクリックすると呼び出されます。
`CWnd::OnPowerBroadcast`	電源管理イベントが発生したときに呼び出されます。
`CWnd::OnQueryDragIcon`	最小化 (アイコン化) された `CWnd` をユーザーがドラッグするときに呼び出されます。
`CWnd::OnQueryEndSession`	ユーザーが Windows セッションを終了するときに呼び出されます。
`CWnd::OnQueryNewPalette`	もうすぐ入力フォーカスを受け取ることを、`CWnd` に通知します。
`CWnd::OnQueryOpen`	`CWnd` がアイコンであり、ユーザーがそのアイコンを開こうとしたときに呼び出されます。
`CWnd::OnQueryUIState`	ウィンドウのユーザーインターフェイス (UI) 状態を取得するために呼び出されます。
`CWnd::OnRawInput`	現在のウィンドウが生の入力を取得するときに呼び出されます。
`CWnd::OnRButtonDblClk`	マウスの右ボタンをダブルクリックすると呼び出されます。
`CWnd::OnRButtonDown`	マウスの右ボタンを押すと呼び出されます。
`CWnd::OnRButtonUp`	マウスの右ボタンを離すと呼び出されます。
`CWnd::OnRenderAllFormats`	オーナーアプリケーションが破棄され、そのフォーマットすべてのレンダリングが必要なときに呼び出されます。
`CWnd::OnRenderFormat`	遅延レンダリングされた固有フォーマットのレンダリングが必要なときに、クリップボードオーナーに対して呼び出されます。
`CWnd::OnSessionChange`	セッション状態の変更をアプリケーションに通知するために呼び出されます。
`CWnd::OnSetCursor`	マウス入力がキャプチャされず、マウスによってウィンドウ内でカーソルの移動が発生した場合に呼び出されます。
`CWnd::OnSetFocus`	`CWnd` が入力フォーカスを取得すると呼び出されます。
`CWnd::OnSettingChange`	Win32 `SystemParametersInfo` 関数がシステム全体の設定を変更するときに呼び出されます。
`CWnd::OnShowWindow`	`CWnd` が非表示になるか表示されるときに呼び出されます。
`CWnd::OnSize`	`CWnd` のサイズが変更された後に呼び出されます。
`CWnd::OnSizeClipboard`	クリップボードビューアーウィンドウのクライアント領域のサイズが変更されたときに呼び出されます。
`CWnd::OnSizing`	四角形のサイズを変更中であることを示します。
`CWnd::OnSpoolerStatus`	プリントマネージャーのキューでジョブが追加または削除されるたびに、プリントマネージャーから呼び出されます。
`CWnd::OnStyleChanged`	`SetWindowLong` Windows 関数が 1 つ以上のウィンドウのスタイルを変更したことを示します。
`CWnd::OnStyleChanging`	`SetWindowLong` Windows 関数が 1 つ以上のウィンドウのスタイルを変更しようとしていることを示します。
`CWnd::OnSysChar`	キーストロークがシステム文字に変換されるときに呼び出されます。
`CWnd::OnSysColorChange`	システムカラーの設定が変更されたときに、すべてのトップレベルウィンドウで呼び出されます。
`CWnd::OnSysCommand`	ユーザーがコントロールメニューからコマンドを選択するとき、または最大化ボタンまたは最小化ボタンを選択するときに呼び出されます。
`CWnd::OnSysDeadChar`	キーストロークがシステムのデッド文字 (アクセント記号付き文字など) に変換されるときに呼び出されます。
`CWnd::OnSysKeyDown`	ユーザーが Alt キーを押したまま他のキーを押すときに呼び出されます。
`CWnd::OnSysKeyUp`	Alt キーと一緒に押していたキーを離すときに呼び出されます。
`CWnd::OnTCard`	ユーザーが編集可能なボタンをクリックしたときに呼び出されます。
`CWnd::OnTimeChange`	システム時間が変更された後、すべてのトップレベルのウィンドウに対して呼び出されます。
`CWnd::OnTimer`	`SetTimer`で指定された各間隔の後に呼び出されます。
`CWnd::OnTouchInput`	Windows タッチからの 1 つの入力を処理します。
`CWnd::OnTouchInputs`	Windows タッチからの複数の入力を処理します。
`CWnd::OnUniChar`	キーが押されるときに呼び出されます。つまり、現在のウィンドウにはキーボードフォーカスがあり、 `WM_KEYDOWN` メッセージは `TranslateMessage` 関数によって変換されます。
`CWnd::OnUnInitMenuPopup`	ドロップダウンメニューやサブメニューが破棄されたときに呼び出されます。
`CWnd::OnUpdateUIState`	指定したウィンドウとすべての子ウィンドウのユーザーインターフェイス (UI) 状態を変更するときに呼び出されます。
`CWnd::OnUserChanged`	ユーザーがログオンまたはログオフした後に呼び出されます。
`CWnd::OnVKeyToItem`	`WM_KEYDOWN` メッセージに応答して、`CWnd`が所有するリストボックスによって呼び出されます。
`CWnd::OnVScroll`	ウィンドウの垂直スクロールバーをクリックすると呼び出されます。
`CWnd::OnVScrollClipboard`	オーナーがクリップボード内のイメージをスクロールし、適切な部分を無効にし、さらに、スクロールバーの値を更新する必要がある場合に呼び出されます。
`CWnd::OnWindowPosChanged`	`SetWindowPos`または別のウィンドウ管理機能の呼び出しの結果、サイズ、位置、または Z オーダーが変更されたときに呼び出されます。
`CWnd::OnWindowPosChanging`	`SetWindowPos`またはその他のウィンドウ管理機能の呼び出しの結果として、サイズ、位置、または Z オーダーが変更されようとしているときに呼び出されます。
`CWnd::OnWinIniChange`	Windows 初期化ファイル ( `WIN.INI`) が変更された後、最上位のすべてのウィンドウに対して呼び出されます。
`CWnd::OnWndMsg`	ウィンドウのメッセージが処理されたかどうかを示します。
`CWnd::OnXButtonDblClk`	カーソルがウィンドウのクライアント領域にあるときに、ユーザーが `XBUTTON1` または `XBUTTON2` をダブルクリックしたときに呼び出されます。
`CWnd::OnXButtonDown`	カーソルがウィンドウのクライアント領域にあるときに、ユーザーが `XBUTTON1` または `XBUTTON2` を押したときに呼び出されます。
`CWnd::OnXButtonUp`	カーソルがウィンドウのクライアント領域にあるときに、ユーザーが `XBUTTON1` または `XBUTTON2` を離したときに呼び出されます。
`CWnd::PostNcDestroy`	この仮想関数は、ウィンドウが破棄された後、既定の OnNcDestroy 関数によって呼び出されます。
`CWnd::ReflectChildNotify`	メッセージをソースに反映するヘルパー関数。
`CWnd::ReflectLastMsg`	最後のメッセージを子ウィンドウに反映します。
`CWnd::ResizeDynamicLayout`	ウィンドウで動的レイアウトが有効な場合、子ウィンドウのレイアウトを調整するためにウィンドウのサイズが変更されると、フレームワークによって呼び出されます。
`CWnd::WindowProc`	`CWnd` にウィンドウプロシージャを提供します。既定では、メッセージマップを通じてメッセージをディスパッチします。

パブリック演算子

名前	説明
`CWnd::operator HWND`	ウィンドウへのハンドルを取得するために呼び出します。
`CWnd::operator !=`	ウィンドウがハンドルが `m_hWnd`ウィンドウと同じでないかどうかを判断します。
`CWnd::operator ==`	ウィンドウがハンドルが `m_hWnd`ウィンドウと同じかどうかを判断します。

パブリックデータメンバー

名前	説明
`CWnd::m_hWnd`	この `CWnd`に接続されている HWND を示します。

解説

CWnd オブジェクトは、Windows のウィンドウとは異なりますが、両者は密接にリンクされています。 CWnd オブジェクトは、CWnd コンストラクターとデストラクターによって作成され、破棄されます。一方、Windows ウィンドウは、 Create メンバー関数によって作成され、 CWnd 仮想デストラクターによって破棄される Windows 内部のデータ構造です。 DestroyWindow関数は、オブジェクトを破棄せずに Windows ウィンドウを破棄します。

CWnd クラスとメッセージマップメカニズムは、WndProc関数を非表示にします。受信 Windows 通知メッセージは、メッセージマップを介して適切な OnMessage CWnd メンバー関数に自動的にルーティングされます。派生クラスでメンバーの特定のメッセージを処理するには、 OnMessage メンバー関数をオーバーライドします。

CWnd クラスでは、アプリケーションの Windows 子ウィンドウも作成できます。アプリケーション固有のデータを格納するには、CWnd からクラスを派生させ、その派生クラスにメンバー変数を追加します。ウィンドウにメッセージが送られたときに行われる処理を指定するには、派生クラスにメッセージ処理メンバー関数とメッセージマップを実装します。

子ウィンドウは 2 つのステップで作成します。まず、コンストラクター CWnd を呼び出して CWnd オブジェクトを構築し、 Create メンバー関数を呼び出して子ウィンドウを作成し、 CWnd オブジェクトにアタッチします。

ユーザーが子ウィンドウを終了したら、ウィンドウを削除してそのデータ構造体を破棄するために、CWnd オブジェクトを破棄するか、DestroyWindow メンバー関数を呼び出します。

Microsoft Foundation Class ライブラリでは、固有のウィンドウタイプを提供するために、CWnd からさらにクラスが派生されています。これらのクラスの多くは、 CFrameWnd、 CMDIFrameWnd、 CMDIChildWnd、 CView、 CDialogなど、さらに派生するように設計されています。 CButtonなど、CWndから派生したコントロールクラスは、直接使用することも、クラスをさらに派生するために使用することもできます。

CWndの使用方法の詳細については、「Frame WindowsオブジェクトとWindow オブジェクト」を参照してください。

継承階層

CObject

CCmdTarget

CWnd

要件

ヘッダー: afxwin.h

CWnd::accDoDefaultAction

オブジェクトの既定のアクションを実行するために、フレームワークによって呼び出されます。

virtual HRESULT accDoDefaultAction(VARIANT varChild);

パラメーター

varChild
呼び出す既定のアクションがオブジェクトのアクションか、オブジェクトの子要素の 1 つであるかを指定します。このパラメーターには、CHILDID_SELF (オブジェクトの既定のアクションを実行する場合) または子 ID (オブジェクトの子要素の 1 つの既定のアクションを実行する) のいずれかを指定できます。

戻り値

成功したS_OK、失敗した場合は COM エラーコードを返します。 Windows SDK の IAccessible::accDoDefaultAction の「Return Values」を参照してください。

解説

この関数は、MFC の Active Accessibility サポートの一部です。

オブジェクトの既定のアクションを実行するには、 CWnd派生クラスでこの関数をオーバーライドします。詳細については、Windows SDK の IAccessible::accDoDefaultAction を参照してください。

`CWnd::accHitTest`

画面上の指定された位置にある子要素または子オブジェクトを取得するために、フレームワークによって呼び出されます。

virtual HRESULT accHitTest(
    long xLeft,
    long yTop,
    VARIANT* pvarChild);

パラメーター

xLeft
ヒットテストするポイントの X 座標 (画面単位)。

yTop
ヒットテストするポイントの Y 座標 (画面単位)。

pvarChild
xLeftおよびyTopで指定されたポイントにあるオブジェクトを識別する情報を受け取ります。 Windows SDK のIAccessible::accHitTestのpvarIDを参照してください。

戻り値

成功した S_OK 、失敗した場合は COM エラーコードを返します。 Windows SDK のIAccessible::accHitTestの「戻す値」を参照してください。

解説

この関数は、MFC の Active Accessibility サポートの一部です。

ウィンドウのないユーザーインターフェイス要素 (MFC が処理するウィンドウレス ActiveX コントロール以外) がある場合は、 CWnd派生クラスでこの関数をオーバーライドします。

詳細については、Windows SDK の IAccessible::accHitTest に関する記事を参照してください。

`CWnd::accLocation`

指定されたオブジェクトの現在の画面位置を取得するために、フレームワークによって呼び出されます。

virtual HRESULT accLocation(
    long* pxLeft,
    long* pyTop,
    long* pcxWidth,
    long* pcyHeight,
    VARIANT varChild);

パラメーター

pxLeft
オブジェクトの左上隅の x 座標を受け取ります (画面単位)。

pyTop
オブジェクトの左上隅の y 座標を受け取ります (画面単位)。

pcxWidth
オブジェクトの幅 (画面単位) を受け取ります。

pcyHeight
オブジェクトの高さを (画面単位で) 受け取ります。

varChild
取得する場所がオブジェクトの場所か、オブジェクトの子要素の 1 つであるかを指定します。このパラメーターには、 CHILDID_SELF (オブジェクトに関する情報を取得する) または子 ID (オブジェクトの子要素に関する情報を取得する) のいずれかを指定できます。

戻り値

成功したS_OK、失敗した場合は COM エラーコードを返します。 Windows SDK のIAccessible::accLocationの「戻す値」を参照してください。

解説

詳細については、Windows SDK の IAccessible::accLocation に関する記事を参照してください。

`CWnd::accNavigate`

コンテナー内の他のユーザーインターフェイス要素を走査するため、可能な場合はそのオブジェクトを取得するために、フレームワークによって呼び出されます。

virtual HRESULT accNavigate(
    long navDir,
    VARIANT varStart,
    VARIANT* pvarEndUpAt);

パラメーター

navDir
移動する方向を指定します。 Windows SDK のIAccessible::accNavigateのnavDirを参照してください。

varStart
開始オブジェクトを指定します。 Windows SDK のIAccessible::accNavigateのvarStartを参照してください。

pvarEndUpAt
宛先ユーザーインターフェイスオブジェクトに関する情報を受け取ります。 Windows SDK のIAccessible::accNavigateのpvarEndを参照してください。

戻り値

成功した S_OK 、失敗した場合は COM エラーコードを返します。 Windows SDK のIAccessible::accNavigateの「戻す値」を参照してください。

解説

この関数は、MFC の Active Accessibility サポートの一部です。

詳細については、Windows SDK の IAccessible::accNavigate に関する記事を参照してください。

`CWnd::accSelect`

選択を変更するため、または指定されたオブジェクトのキーボードフォーカスを移動するために、フレームワークによって呼び出されます。

virtual HRESULT accSelect(
    long flagsSelect,
    VARIANT varChild);

パラメーター

flagsSelect
現在の選択範囲またはフォーカスを変更する方法を指定します。 Windows SDK のIAccessible::accSelectのflagsSelectを参照してください。

varChild
選択するオブジェクトを指定します。このパラメーターには、 CHILDID_SELF (オブジェクト自体を選択する場合) または子 ID (オブジェクトの子のいずれかを選択する場合) のいずれかを指定できます。

戻り値

成功した S_OK 、失敗した場合は COM エラーコードを返します。 Windows SDK のIAccessible::accSelectの「戻す値」を参照してください。

解説

この関数は、MFC の Active Accessibility サポートの一部です。

詳細については、Windows SDK の IAccessible::accSelect に関する記事を参照してください。

`CWnd::AnimateWindow`

ウィンドウを表示または非表示にするときに特殊効果を生成します。

BOOL AnimateWindow(
    DWORD dwTime,
    DWORD dwFlags);

パラメーター

dwTime
アニメーションの再生にかかる時間をミリ秒単位で指定します。通常、アニメーションの再生には 200 ミリ秒かかります。

dwFlags
アニメーションの種類を指定します。使用可能な値の完全な一覧については、 AnimateWindowを参照してください。

戻り値

関数が正常終了した場合は 0 以外。それ以外の場合は 0。

解説

このメンバー関数は、Windows SDK で説明されているように、関数 AnimateWindowの機能をエミュレートします。

`CWnd::ArrangeIconicWindows`

すべての最小化 (アイコン化) された子ウィンドウを整列します。

UINT ArrangeIconicWindows();

戻り値

関数が成功した場合のアイコンの 1 行の高さ。それ以外の場合は 0。

解説

このメンバー関数は、デスクトップウィンドウにアイコンを配置し、画面全体をカバーします。 GetDesktopWindow メンバー関数は、デスクトップウィンドウオブジェクトへのポインターを取得します。

MDI クライアントウィンドウにアイコンの MDI 子ウィンドウを配置するには、 CMDIFrameWnd::MDIIconArrangeを呼び出します。

例

// arrange minimized MDI child windows
// called from menu item; CMdiChildFrame is derived from CMDIChildWnd
void CMdiChildFrame::OnActionArrangeIconicWindows()
{
   UINT height = GetParent()->ArrangeIconicWindows();   
   TRACE(_T("height = %d\n"), height);
}

`CWnd::Attach`

Windows ウィンドウを CWnd オブジェクトにアタッチします。

BOOL Attach(HWND hWndNew);

パラメーター

hWndNew
Windows ウィンドウへのハンドルを指定します。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

例

この例では、 Attach と Detach を使用して MDI クライアントウィンドウにマップする方法を示します。

// Declare a CWnd member of CMainFrame
public:
CWnd m_wndMDIClient;

// detach MDI client window in CMainFrame destructor
m_wndMDIClient.Detach();

// In CMainFrame::OnCreate, attach MDI client window

if (CMDIFrameWnd::OnCreate(lpCreateStruct) == -1)
   return -1;

// attach MDI client window
if (m_wndMDIClient.Attach(m_hWndMDIClient) == 0)
{
   TRACE(_T("Failed to attach MDIClient.\n"));
   return -1; // fail to create
}

`CWnd::BeginModalState`

フレームウィンドウをモーダルにします。

virtual void BeginModalState();

`CWnd::BeginPaint`

描画の CWnd を準備し、 PAINTSTRUCT データ構造に描画に関する情報を入力します。

CDC* BeginPaint(LPPAINTSTRUCT lpPaint);

パラメーター

lpPaint
描画情報を受け取る PAINTSTRUCT 構造を指します。

戻り値

CWndのデバイスコンテキストを識別します。ポインターは一時的なものであり、 EndPaintのスコープを超えて格納しないでください。

解説

ペイント構造には、更新領域を完全に囲む最小の四角形を持つ RECT データ構造と、背景が消去されたかどうかを指定するフラグが含まれています。

更新領域は、 Invalidate、 InvalidateRect、または InvalidateRgn メンバー関数によって設定され、システムのサイズ変更、移動、作成、スクロール、またはクライアント領域に影響を与えるその他の操作の実行後に行われます。更新リージョンに消去のマークが付いている場合、 BeginPaint は WM_ONERASEBKGND メッセージを送信します。

WM_PAINT メッセージへの応答を除き、BeginPaint メンバー関数を呼び出さないでください。 BeginPaint メンバー関数の各呼び出しには、EndPaint メンバー関数に対する一致する呼び出しが必要です。キャレットが塗りつぶす領域にある場合、 BeginPaint メンバー関数はキャレットを自動的に非表示にして、キャレットが消去されないようにします。

例

// Use BeginPaint and EndPaint when responding to WM_PAINT message
// An alternative method is to use CPaintDC in place of
// BeginPaint and EndPaint
void CMdiView::OnPaint()
{
   PAINTSTRUCT ps;
   CDC *pDC = BeginPaint(&ps);

   pDC->Rectangle(CRect(0, 0, 100, 100));

   EndPaint(&ps);

   // Do not call CView::OnPaint() for painting messages
}

`CWnd::BindDefaultProperty`

データソースコントロールの DataSource、 UserName、 Password、および SQL プロパティによって定義されている基になるカーソルに、呼び出し元オブジェクトの既定の単純バインドプロパティ (エディットコントロールなど) をタイプライブラリでマークされているプロパティにバインドします。

void BindDefaultProperty(
    DISPID dwDispID,
    VARTYPE vtProp,
    LPCTSTR szFieldName,
    CWnd* pDSCWnd);

パラメーター

dwDispID
データソースコントロールにバインドされるデータバインドコントロールのプロパティの DISPID を指定します。

vtProp
バインドするプロパティの型を指定します。たとえば、 VT_BSTR、 VT_VARIANTなどです。

szFieldName
プロパティをバインドするデータソースコントロールによって提供されるカーソル内の列の名前を指定します。

pDSCWnd
プロパティがバインドされるデータソースコントロールをホストするウィンドウをポイントします。 DCS のホストウィンドウのリソース ID を使用して GetDlgItem を呼び出して、このポインターを取得します。

解説

この関数を呼び出す CWnd オブジェクトは、データバインドコントロールである必要があります。

例

BindDefaultProperty は、次のコンテキストで使用できます。

BOOL CMyDlg::OnInitDialog()
{
   CWnd *pDSC = GetDlgItem(IDC_DATASOURCE);
   CWnd *pMyBound = GetDlgItem(IDC_MYBOUNDCTRL1);
   pMyBound->BindDefaultProperty(0x1, VT_BSTR, _T("ContactFirstName"), pDSC);
   return TRUE;
}

`CWnd::BindProperty`

データバインドコントロール (グリッドコントロールなど) のカーソルバインドプロパティをデータソースコントロールにバインドし、その関係を MFC バインドマネージャーに登録します。

void BindProperty(
    DISPID dwDispId,
    CWnd* pWndDSC);

パラメーター

dwDispId
データソースコントロールにバインドされるデータバインドコントロールのプロパティの DISPID を指定します。

pWndDSC
プロパティがバインドされるデータソースコントロールをホストするウィンドウをポイントします。 DCS のホストウィンドウのリソース ID を使用して GetDlgItem を呼び出して、このポインターを取得します。

解説

この関数を呼び出す CWnd オブジェクトは、データバインドコントロールである必要があります。

例

BindProperty は、次のコンテキストで使用できます。

BOOL CMyDlg::OnInitDialog()
{
   CWnd *pDSC = GetDlgItem(IDC_DATASOURCE);
   CWnd *pMyBound = GetDlgItem(IDC_MYBOUNDCTRL2);
   pMyBound->BindProperty(0x1, pDSC);
   return TRUE;
}

`CWnd::BringWindowToTop`

CWnd を重なったウィンドウのスタックの最上位に移動します。

void BringWindowToTop();

解説

また、BringWindowToTop により、ポップアップウィンドウ、トップレベルウィンドウ、および MDI 子ウィンドウがアクティブになります。 BringWindowToTop メンバー関数は、重なったウィンドウによって部分的または完全に隠されているウィンドウを表示する場合に使用します。

この関数は Win32 BringWindowToTop 関数を呼び出すだけです。 SetWindowPos関数を呼び出して、Z オーダーでウィンドウの位置を変更します。 BringWindowToTop 関数では、ウィンドウスタイルが変更され、そのウィンドウがトップレベルウィンドウになることはありません。詳細については、「HWND_TOPとHWND_TOPMOST

例

// Moves MDI child windows to the top when a mouse passes
// over it. CMdiView is derived from CView.
void CMdiView::OnMouseMove(UINT nFlags, CPoint point) 
{
   UNREFERENCED_PARAMETER(nFlags);
   UNREFERENCED_PARAMETER(point);

   GetParentFrame()->BringWindowToTop();
}

`CWnd::CalcWindowRect`

指定したクライアント四角形を含むことができるウィンドウの四角形を計算します。

virtual void CalcWindowRect(
    LPRECT lpClientRect,
    UINT nAdjustType = adjustBorder);

パラメーター

lpClientRect
[入力、出力]四角形構造体へのポインター。入力時に、この構造体にはクライアントの四角形が含まれます。メソッドが完了すると、この構造体には、指定したクライアントの四角形を含むことができるウィンドウの四角形が含まれます。

nAdjustType
[in] CWnd::adjustBorder を使用して、 WS_EX_CLIENTEDGE スタイルなしでウィンドウ座標を計算します。それ以外の場合は、 CWnd::adjustOutsideを使用します。

解説

計算されたウィンドウの四角形のサイズには、メニューバーの領域は含まれません。

その他の使用制限については、「 AdjustWindowRectEx」を参照してください。

例

// Uses CalcWindowRect to determine size for new CFrameWnd
// based on the size of the current view. The end result is a
// top level frame window of the same size as CMdiView's frame.
void CMdiView::OnMyCreateFrame()
{
   CFrameWnd *pFrameWnd = new CFrameWnd;
   CRect myRect;
   GetClientRect(myRect);
   pFrameWnd->Create(NULL, _T("My Frame"));
   pFrameWnd->CalcWindowRect(&myRect, CWnd::adjustBorder);
   pFrameWnd->MoveWindow(0, 0, myRect.Width(), myRect.Height());
   pFrameWnd->ShowWindow(SW_SHOW);
}

`CWnd::CancelToolTips`

ツールヒントが現在表示されている場合は、このメンバー関数を呼び出して、ツールヒントを画面から削除します。

static void PASCAL CancelToolTips(BOOL bKeys = FALSE);

パラメーター

bKeys
TRUE キーが押されたときにツールヒントをキャンセルし、ステータスバーのテキストをデフォルトに設定する。それ以外の場合は FALSE。

解説

Note

このメンバー関数を使用しても、コードによって管理されるツールヒントには影響しません。 CWnd::EnableToolTipsによって管理されるツールヒントコントロールにのみ影響します。

例

// In this example, tool tips were set up to
// pop up when the user moves the mouse
// over this edit control.
// If the mouse is moved to the upper left-hand
// corner, the tool tip would disappear because of
// calling CancelToolTips.
void CMyEdit::OnMouseMove(UINT nFlags, CPoint point)
{
   CRect corner(0, 0, 10, 10);
   if (corner.PtInRect(point))
      CancelToolTips();
   CEdit::OnMouseMove(nFlags, point);
}

`CWnd::CenterWindow`

ウィンドウをその親ウィンドウの中央に揃えます。

void CenterWindow(CWnd* pAlternateOwner = NULL);

パラメーター

pAlternateOwner
(親ウィンドウ以外の) 中央に配置される代替ウィンドウへのポインター。

解説

通常、アプリケーションのメインウィンドウを基準にして、 CDialog::OnInitDialog から中央のダイアログボックスに呼び出されます。既定では、関数は親ウィンドウを基準にして子ウィンドウを中央に配置し、ポップアップウィンドウを所有者に対して相対的に配置します。ポップアップウィンドウが所有されていない場合は、画面を基準にして中央揃えになります。所有者または親ではない特定のウィンドウを基準にしてウィンドウを中央揃えするには、 pAlternateOwner パラメーターを有効なウィンドウに設定できます。画面を基準にして中央揃えにするには、 CWnd::GetDesktopWindow によって返される値を pAlternateOwnerとして渡します。

例

BOOL CAboutDlg::OnInitDialog()
{
   CDialog::OnInitDialog();

   CenterWindow();

   return TRUE;
}

`CWnd::ChangeClipboardChain`

クリップボードビューアーのチェーンからCWndを削除し、チェーン内のCWnd先祖の子孫hWndNext指定されたウィンドウを作成します。

BOOL ChangeClipboardChain(HWND hWndNext);

パラメーター

hWndNext
クリップボードビューアーチェーンの CWnd に続くウィンドウを識別します。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

`CWnd::CheckDlgButton`

ボタンを選択 (チェックマークの横に配置) するか、ボタンをクリア (チェックマークを削除) するか、3 状態ボタンの状態を変更します。

void CheckDlgButton(
    int nIDButton,
    UINT nCheck);

パラメーター

nIDButton
変更するボタンを指定します。

nCheck
実行するアクションを指定します。 nCheckが 0 以外の場合、CheckDlgButton メンバー関数はボタンの横にチェックマークを付けます。0 の場合、チェックマークは削除されます。 3 つの状態のボタンの場合、 nCheck が 2 の場合、ボタンの状態は不確定になります。

解説

CheckDlgButton関数は、指定したボタンにBM_SETCHECKメッセージを送信します。

例

// Sets 3 check buttons in various ways.  Note BST_INDETERMINATE
// requires BS_3STATE or BS_AUTO3STATE in the button's style.
void CMyDlg::OnMarkButtons()
{
   CheckDlgButton(IDC_CHECK1, BST_UNCHECKED);     // 0
   CheckDlgButton(IDC_CHECK2, BST_CHECKED);       // 1
   CheckDlgButton(IDC_CHECK3, BST_INDETERMINATE); // 2
}

`CWnd::CheckRadioButton`

グループ内の特定のラジオボタンを選択 (チェックマークを追加) し、グループ内の他のすべてのラジオボタンをクリア (チェックマークを削除) します。

void CheckRadioButton(
    int nIDFirstButton,
    int nIDLastButton,
    int nIDCheckButton);

パラメーター

nIDFirstButton
グループ内の最初のラジオボタンの整数識別子を指定します。

nIDLastButton
グループ内の最後のラジオボタンの整数識別子を指定します。

nIDCheckButton
チェックするラジオボタンの整数識別子を指定します。

解説

CheckRadioButton関数は、指定したラジオボタンにBM_SETCHECK メッセージを送信します。

例

// Of the 4 radio buttons, selects radio button 3.
void CMyDlg::OnMarkRadio()
{
   CheckRadioButton(IDC_RADIO1, IDC_RADIO4, IDC_RADIO3);
}

`CWnd::ChildWindowFromPoint`

CWndに属する子ウィンドウのうち、指定したポイントを含む子ウィンドウ (存在する場合) を決定します。

CWnd* ChildWindowFromPoint(POINT point) const;

CWnd* ChildWindowFromPoint(
    POINT point,
    UINT nFlags) const;

パラメーター

point
テストするポイントのクライアント座標を指定します。

nflags
スキップする子ウィンドウを指定します。このパラメーターは、次の値と組み合わせて指定できます。

値	意味
`CWP_ALL`	子ウィンドウをスキップしない
`CWP_SKIPINVISIBLE`	非表示の子ウィンドウをスキップする
`CWP_SKIPDISABLED`	無効な子ウィンドウをスキップする
`CWP_SKIPTRANSPARENT`	透明な子ウィンドウをスキップする

戻り値

ポイントを含む子ウィンドウを識別します。指定したポイントがクライアント領域の外部にある場合は NULL 。ポイントがクライアント領域内にあり、どの子ウィンドウにも含まれていない場合は、 CWnd が返されます。

このメンバー関数は、指定したポイントを含む非表示または無効な子ウィンドウを返します。

複数のウィンドウに特定のポイントが含まれている場合があります。ただし、この関数は、ポイントを含む最初に検出されたウィンドウの CWnd* のみを返します。

返される CWnd* は一時的なものであり、後で使用するために格納しないでください。

例

void CMyDlg::OnFindCenterChild() 
{
   CRect rect;
   GetClientRect(&rect);
   CWnd* pWnd = ChildWindowFromPoint(
      CPoint(rect.Width()/2, rect.Height()/2), 
      // Top left is always 0, 0.
      CWP_SKIPINVISIBLE);
   TRACE(_T("Center window is 0x%08x\n"), pWnd->m_hWnd);
}

`CWnd::ClientToScreen`

ディスプレイ上の指定された点または四角形のクライアント座標を画面座標に変換します。

void ClientToScreen(LPPOINT lpPoint) const;  void ClientToScreen(LPRECT lpRect) const;

パラメーター

lpPoint
変換するクライアント座標を含む POINT 構造体または CPoint オブジェクトを指します。

lpRect
変換するクライアント座標を含む RECT 構造体または CRect オブジェクトを指します。

解説

ClientToScreen メンバー関数は、POINTまたはRECT構造体のクライアント座標、lpPointまたはlpRectが指すCPointまたはCRectオブジェクトを使用して新しい画面座標を計算し、構造体内の座標を新しい座標に置き換えます。新しい画面座標は、システムディスプレイの左上隅を基準にしています。

ClientToScreenメンバー関数は、指定されたポイントまたは四角形がクライアント座標にあることを前提としています。

例

// resize dialog to client's size
void CMyDlg::OnSizeToClient()
{
   CRect myRect;
   GetClientRect(&myRect);

   ClientToScreen(myRect);
   MoveWindow(myRect.left, myRect.top,
              myRect.Width(), myRect.Height());
}

`CWnd::CloseWindow`

ウィンドウを最小化します。

void CloseWindow();

解説

このメンバー関数は、Windows SDK で説明されているように、関数 CloseWindowの機能をエミュレートします。

`CWnd::ContinueModal`

このメンバー関数は、モーダル状態を終了するタイミングを決定するために、 RunModalLoop によって呼び出されます。

virtual BOOL ContinueModal();

戻り値

モーダルループを継続する場合は 0 以外。 EndModalLoop が呼び出されたときの 0。

解説

既定では、 EndModalLoop が呼び出されるまで 0 以外の値が返されます。

`CWnd::Create`

指定した子ウィンドウを作成し、 CWnd オブジェクトにアタッチします。

virtual BOOL Create(
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    Const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    CCreateContext* pContext = NULL);

パラメーター

lpszClassName
[in]登録されたシステムウィンドウクラスの名前を含む null で終わる文字列へのポインター。または定義済みのシステムウィンドウクラスの名前。

lpszWindowName
[in]ウィンドウの表示名を含む null で終わる文字列へのポインター。それ以外の場合は、ウィンドウの表示名がない場合は NULL 。

dwStyle
[in] ウィンドウスタイルのビットごとの組み合わせ (OR。 WS_POPUP オプションが有効なスタイルではありません。

rect
[in]親ウィンドウの左上隅を基準としたウィンドウのサイズと位置。

pParentWnd
[in]親ウィンドウへのポインター。

nID
[in]ウィンドウの ID。

pContext
[in]アプリケーションのドキュメントビューアーキテクチャをカスタマイズするために使用される CCreateContext 構造体へのポインター。

戻り値

TRUE メソッドが成功した場合。それ以外の場合は FALSE。

解説

警告

CWnd::PreCreateWindowメニューがNULLされ、スタイルにWS_CHILDが含まれている場合、CREATESTRUCT パラメーターのhMenu メンバーがthis ポインターに割り当てられます。適切な機能を実現するには、ダイアログコントロールに NULLされていない ID があることを確認します。

この変更により、マネージド/ネイティブ相互運用シナリオでのクラッシュが修正されます。 CWnd::CreateのTRACEステートメントは、問題の開発者に警告します。

ウィンドウクラスを登録するには、 AfxRegisterWndClass 関数を使用します。ユーザー定義ウィンドウクラスは、登録されているモジュールで使用できます。

CWnd::OnCreate メソッドは、Create メソッドが戻る前、およびウィンドウが表示される前に呼び出されます。

例

// Dynamically create static control using CWnd::Create,
// instead of with CStatic::Create, which doesn't
// need the "STATIC" class name.
void CMyDlg::OnCreateStatic() 
{
   // m_pWndStatic is a CWnd* member of CMyDlg
   m_pWndStatic = new CWnd;
   m_pWndStatic->Create(_T("STATIC"), _T("Hi"), WS_CHILD | WS_VISIBLE,
       CRect(0, 0, 20, 20), this, 1234);
}

`CWnd::CreateAccessibleProxy`

指定されたオブジェクトの Active Accessibility プロキシを作成します。

virtual HRESULT CreateAccessibleProxy(
    WPARAM wParam,
    LPARAM lParam,
    LRESULT* pResult);

パラメーター

wParam
アクティブなアクセシビリティプロキシによってアクセスされるオブジェクトを識別します。次のいずれかの値を指定できます。

値	意味
`OBJID_CLIENT`	ウィンドウのクライアント領域を参照します。

lParam
追加のメッセージ依存情報を提供します。

pResult
結果コードを格納する LRESULT へのポインター。

解説

指定されたオブジェクトの Active Accessibility プロキシを作成します。

`CWnd::CreateCaret`

システムキャレットの新しい図形を作成し、キャレットの所有権を要求します。

void CreateCaret(CBitmap* pBitmap);

パラメーター

pBitmap
キャレット図形を定義するビットマップを識別します。

解説

ビットマップは、 CBitmap::CreateBitmap メンバー関数、 CreateDIBitmap Windows 関数、または CBitmap::LoadBitmap メンバー関数によって以前に作成されている必要があります。

CreateCaret キャレットを所有しているウィンドウに関係なく、前のキャレット図形がある場合は自動的に破棄されます。作成されると、キャレットは最初は非表示になります。キャレットを表示するには、 ShowCaret メンバー関数を呼び出す必要があります。

システムキャレットは共有リソースです。 CWnd は、入力フォーカスがある場合、またはアクティブな場合にのみキャレットを作成する必要があります。キャレットは、入力フォーカスを失うか非アクティブになる前に破棄する必要があります。

例

// Changes the caret of the edit control in this dialog box
void CMyDlg::OnChangeCaret()
{
   m_pBitmapCaret = new CBitmap;
   m_pBitmapCaret->LoadBitmap(IDB_HAPPY_BITMAP);
   m_MyEdit.CreateCaret(m_pBitmapCaret);
   m_MyEdit.ShowCaret();
}

`CWnd::CreateControl`

このメンバー関数を使用して、MFC プログラムで CWnd オブジェクトによって表される ActiveX コントロールを作成します。

BOOL CreateControl(
    LPCTSTR pszClass,
    LPCTSTR pszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    CFile* pPersist = NULL,
    BOOL bStorage = FALSE,
    BSTR bstrLicKey = NULL);

BOOL CreateControl(
    REFCLSID clsid,
    LPCTSTR pszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    CFile* pPersist = NULL,
    BOOL bStorage = FALSE,
    BSTR bstrLicKey = NULL);

BOOL CreateControl(
    REFCLSID clsid,
    LPCTSTR pszWindowName,
    DWORD dwStyle,
    const POINT* ppt,
    const SIZE* psize,
    CWnd* pParentWnd,
    UINT nID,
    CFile* pPersist = NULL,
    BOOL bStorage = FALSE,
    BSTR bstrLicKey = NULL);

パラメーター

pszClass
この文字列には、クラスの OLE "short name" (ProgID) が含まれている場合があります。たとえば、"CIRC3.Circ3Ctrl.1" のようにします。名前は、コントロールによって登録された同じ名前と一致する必要があります。または、文字列には、中かっこに含まれる CLSIDの文字列形式を含めることがあります。たとえば、"{9DBAFCCF-592F-101B-85CE-00608CEC297B}" のようにします。どちらの場合も、 CreateControl は文字列を対応するクラス ID に変換します。

pszWindowName
コントロールに表示するテキストへのポインター。コントロールの Caption プロパティまたは Text プロパティの値を設定します (存在する場合)。 NULL場合、コントロールの Caption プロパティまたは Text プロパティは変更されません。

dwStyle
Windows スタイル。使用できるスタイルは、[解説] の下に一覧表示されます。

rect
コントロールのサイズと位置を指定します。 CRect オブジェクトまたはRECT構造体のいずれかを指定できます。

ppt
コントロールの左上隅を含む POINT 構造体または CPoint オブジェクトを指します。

pSize
コントロールのサイズを含む SIZE 構造体または CSize オブジェクトを指します

*pParentWnd*
コントロールの親ウィンドウを指定します。 NULLすることはできません。

nID
コントロールの ID を指定します。

pPersist
コントロールの永続的な状態を含む CFile へのポインター。既定値は NULLであり、永続的ストレージから状態を復元せずにコントロールが自身を初期化することを示します。 NULLしない場合は、ストリームまたはストレージのいずれかの形式で、コントロールの永続的なデータを含むCFile派生オブジェクトへのポインターである必要があります。このデータは、クライアントの以前のアクティブ化で保存されている可能性があります。 CFileには他のデータを含めることができますが、読み取り/書き込みポインターは、CreateControlの呼び出し時に永続データの最初のバイトに設定する必要があります。

bStorage
pPersist内のデータをIStorageデータと解釈するか、IStreamデータとして解釈するかを示します。 pPersist内のデータがストレージである場合は、bStorageをTRUEする必要があります。 pPersist内のデータがストリームである場合は、bStorageをFALSEする必要があります。既定値は FALSE です。

bstrLicKey
オプションのライセンスキーデータ。このデータは、ランタイムライセンスキーを必要とするコントロールを作成する場合にのみ必要です。コントロールがライセンスをサポートしている場合は、コントロールの作成を成功させるためにライセンスキーを指定する必要があります。既定値は NULL です。

clsid
コントロールの一意のクラス ID。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

CreateControlは、CWndのウィンドウを作成するCWnd::Create関数の直接のアナログです。 CreateControl では、通常のウィンドウではなく ActiveX コントロールが作成されます。

CreateControlでは、Windows dwStyle フラグのサブセットのみがサポートされています。

WS_VISIBLE 最初に表示されるウィンドウを作成します。通常のウィンドウのように、コントロールをすぐに表示する場合は必須です。
WS_DISABLED 最初に無効になっているウィンドウを作成します。無効なウィンドウは、ユーザーからの入力を受け取ることができません。コントロールに Enabled プロパティがある場合に設定できます。
WS_BORDER 細い線の境界線を持つウィンドウを作成します。コントロールに BorderStyle プロパティがある場合に設定できます。
WS_GROUP コントロールのグループの最初のコントロールを指定します。ユーザーは、方向キーを使用して、グループ内のあるコントロールから次のコントロールにキーボードフォーカスを変更できます。最初のコントロールの後に WS_GROUP スタイルで定義されたすべてのコントロールは、同じグループに属します。 WS_GROUP スタイルの次のコントロールは、グループを終了し、次のグループを開始します。
WS_TABSTOP ユーザーが Tab キーを押したときにキーボードフォーカスを受け取ることができるコントロールを指定します。 Tab キーを押すと、キーボードフォーカスが WS_TABSTOP スタイルの次のコントロールに変更されます。

例

class CGenocx : public CWnd
{
protected:
   DECLARE_DYNCREATE(CGenocx)
public:
   CLSID const &GetClsid()
   {
      static CLSID const clsid = {0x20DD1B9E, 0x87C4, 0x11D1, {0x8B, 0xE3, 0x0, 0x0, 0xF8, 0x75, 0x4D, 0xA1}};
      return clsid;
   }

   // This code is generated by the Control Wizard.
   // It wraps the call to CreateControl in the call to Create.
   virtual BOOL Create(LPCTSTR lpszClassName, LPCTSTR lpszWindowName, DWORD dwStyle,
                       const RECT &rect, CWnd *pParentWnd, UINT nID,
                       CCreateContext *pContext = NULL)
   {
      UNREFERENCED_PARAMETER(pContext);
      UNREFERENCED_PARAMETER(lpszClassName);

      return CreateControl(GetClsid(), lpszWindowName, dwStyle, rect, pParentWnd, nID);
   }

   // remainder of class declaration omitted...

`CWnd::CreateEx`

指定したウィンドウを作成し、 CWnd オブジェクトにアタッチします。

virtual BOOL CreateEx(
    DWORD dwExStyle,
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    int x,
    int y,
    int nWidth,
    int nHeight,
    HWND hWndParent,
    HMENU nIDorHMenu,
    LPVOID lpParam = NULL);

virtual BOOL CreateEx(
    DWORD dwExStyle,
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    LPVOID lpParam = NULL);

パラメーター

dwExStyle
目的のウィンドウスタイルビットごとの組み合わせ (OR)。それ以外の場合は、既定の拡張ウィンドウスタイルに NULL 。

lpszClassName
登録されたシステムウィンドウクラスの名前を含む null で終わる文字列へのポインター。または定義済みのシステムウィンドウクラスの名前。

lpszWindowName
ウィンドウの表示名を含む null で終わる文字列へのポインター。それ以外の場合は、ウィンドウの表示名がない場合は NULL 。

dwStyle
ウィンドウスタイルのビットごとの組み合わせ (OR。それ以外の場合は、既定のウィンドウスタイルにNULL。

x
画面の左側または親ウィンドウからのウィンドウの初期水平方向の距離。

y
画面の上部または親ウィンドウからのウィンドウの最初の垂直方向の距離。

nWidth
ウィンドウの幅 (ピクセル単位)。

nHeight
ウィンドウの高さ (ピクセル単位)。

hwndParent
子ウィンドウの場合、親ウィンドウへのハンドル。それ以外の場合は、ウィンドウに所有者が存在する場合の所有者ウィンドウのハンドル。

nIDorHMenu
子ウィンドウの場合、ウィンドウ ID。それ以外の場合は、ウィンドウのメニューの ID。

lpParam
lpCreateParams フィールドのCWnd::OnCreate メソッドに渡されるユーザーデータへのポインター。

rect
画面または親ウィンドウを基準としたウィンドウのサイズと位置。

pParentWnd
子ウィンドウの場合は、親ウィンドウへのポインター。それ以外の場合は、ウィンドウに所有者が存在する場合は、所有者ウィンドウへのポインター。

nID
子ウィンドウの場合、ウィンドウ ID。それ以外の場合は、ウィンドウのメニューの ID。

戻り値

TRUE メソッドが成功した場合。それ以外の場合は FALSE。

解説

警告

既定の拡張ウィンドウスタイルは WS_EX_LEFT。既定のウィンドウスタイルは WS_OVERLAPPED。

子ウィンドウのディメンションは、親ウィンドウのクライアント領域の左上隅を基準にしています。トップレベルウィンドウのディメンションは、画面の左上隅を基準にしています。

CWnd::OnCreate メソッドは、CreateEx メソッドが戻る前、およびウィンドウが表示される前に呼び出されます。

例

void CMyDlg::OnCreateExtendedControl() 
{
   // m_pWndStaticEx is a CWnd* member of CMyDlg
   m_pWndStaticEx = new CStatic;
   m_pWndStaticEx->CreateEx(WS_EX_CLIENTEDGE, // Make a client edge label.
      _T("STATIC"), _T("Hi"),
      WS_CHILD | WS_TABSTOP | WS_VISIBLE,
      5, 5, 30, 30, m_hWnd, (HMENU)2345);
}

`CWnd::CreateGrayCaret`

システムキャレットの灰色の四角形を作成し、キャレットの所有権を要求します。

void CreateGrayCaret(
    int nWidth,
    int nHeight);

パラメーター

nWidth
キャレットの幅を (論理単位で) 指定します。このパラメーターが 0 の場合、幅はシステム定義のウィンドウ罫線の幅に設定されます。

nHeight
キャレットの高さを (論理単位で) 指定します。このパラメーターが 0 の場合、高さはシステム定義のウィンドウ境界の高さに設定されます。

解説

キャレット図形には、線またはブロックを指定できます。

パラメーターnWidthnHeightキャレットの幅と高さを (論理単位で) 指定します。正確な幅と高さ (ピクセル単位) はマッピングモードによって異なります。

システムのウィンドウ境界の幅または高さは、SM_CXBORDERおよびSM_CYBORDERインデックスを使用して、GetSystemMetrics Windows 関数によって取得できます。ウィンドウ罫線の幅または高さを使用すると、キャレットが高解像度ディスプレイに確実に表示されます。

CreateGrayCaretメンバー関数は、キャレットを所有するウィンドウに関係なく、前のキャレット図形 (存在する場合) を自動的に破棄します。作成されると、キャレットは最初は非表示になります。キャレットを表示するには、 ShowCaret メンバー関数を呼び出す必要があります。

例

// Create a 5x10 gray caret in the edit control.
void CMyDlg::OnCreateGrayCaret()
{
   m_MyEdit.CreateGrayCaret(5, 10);
   m_MyEdit.ShowCaret();
}

`CWnd::CreateSolidCaret`

システムキャレットのソリッド四角形を作成し、キャレットの所有権を要求します。

void CreateSolidCaret(
    int nWidth,
    int nHeight);

パラメーター

nWidth
キャレットの幅を (論理単位で) 指定します。このパラメーターが 0 の場合、幅はシステム定義のウィンドウ罫線の幅に設定されます。

解説

キャレット図形には、線またはブロックを指定できます。

CreateSolidCaretメンバー関数は、キャレットを所有するウィンドウに関係なく、前のキャレット図形 (存在する場合) を自動的に破棄します。作成されると、キャレットは最初は非表示になります。キャレットを表示するには、 ShowCaret メンバー関数を呼び出す必要があります。

例

// Create a 5x10 solid caret in the edit control.
void CMyDlg::OnCreateSolidCaret()
{
   m_MyEdit.CreateSolidCaret(5, 10);
   m_MyEdit.ShowCaret();
}

`CWnd::CWnd`

CWnd オブジェクトを構築します。

CWnd();

解説

CreateExまたはCreateメンバー関数が呼び出されるまで、Windows ウィンドウは作成およびアタッチされません。

`CWnd::Default`

既定のウィンドウプロシージャを呼び出します。

LRESULT Default();

戻り値

送信されるメッセージによって異なります。

解説

既定のウィンドウプロシージャは、アプリケーションが処理しないウィンドウメッセージに対して既定の処理を提供します。このメンバー関数により、すべてのメッセージが確実に処理されます。

例

// This sample shows how to avoid any button handling in base class,
// if any, and call the default window procedure directly.
void CMyDlg::OnLButtonDown(UINT nFlags, CPoint point)
{
   UNREFERENCED_PARAMETER(nFlags);
   UNREFERENCED_PARAMETER(point);

   CWnd::Default();
}

`CWnd::DefWindowProc`

既定のウィンドウプロシージャを呼び出します。このプロシージャは、アプリケーションが処理しないウィンドウメッセージの既定の処理を提供します。

virtual LRESULT DefWindowProc(
    UINT message,
    WPARAM wParam,
    LPARAM lParam);

パラメーター

message
処理する Windows メッセージを指定します。

wParam
メッセージに依存する追加の情報を指定します。

lParam
メッセージに依存する追加の情報を指定します。

戻り値

送信されるメッセージによって異なります。

解説

このメンバー関数により、すべてのメッセージが確実に処理されます。ウィンドウプロシージャで受け取ったパラメーターと同じパラメーターを使用して呼び出す必要があります。

`CWnd::DeleteTempMap`

CWinApp オブジェクトのアイドル時間ハンドラーによって自動的に呼び出されます。

static void PASCAL DeleteTempMap();

解説

FromHandle メンバー関数によって作成された一時的なCWnd オブジェクトを削除します。

例

// DeleteTempMap() is a static member and does not need 
// to be called within the scope of an instantiated CWnd object.
CWnd::DeleteTempMap();

`CWnd::DestroyWindow`

CWnd オブジェクトにアタッチされている Windows ウィンドウを破棄します。

virtual BOOL DestroyWindow();

戻り値

ウィンドウが破棄された場合は 0 以外。それ以外の場合は 0。

解説

DestroyWindow メンバー関数は、ウィンドウに適切なメッセージを送信して非アクティブ化し、入力フォーカスを削除します。また、ウィンドウのメニューが破棄され、アプリケーションキューがフラッシュされ、未処理のタイマーが破棄され、クリップボードの所有権が削除され、ビューアーチェーンの上部にある場合 CWnd クリップボードビューアーチェーンが中断されます。 WM_DESTROYメッセージとWM_NCDESTROYメッセージをウィンドウに送信します。 CWnd オブジェクトは破棄されません。

DestroyWindow はクリーンアップを実行するためのプレースホルダーです。 DestroyWindowは仮想関数であるため、クラスビューの任意のCWnd派生クラスに表示されます。ただし、 CWnd派生クラスでこの関数をオーバーライドしても、 DestroyWindow 必ずしも呼び出されるとは限りません。が MFC コードで呼び出されない場合は、呼び出す場合は、独自のコードで明示的に呼び出す必要があります。

たとえば、CView 派生クラスでDestroyWindowをオーバーライドしたとします。 MFC ソースコードは、CFrameWnd派生クラスのいずれでもDestroyWindowを呼び出さないため、明示的に呼び出さない限り、オーバーライドされたDestroyWindowは呼び出されません。

ウィンドウが任意のウィンドウの親である場合、親ウィンドウが破棄されると、これらの子ウィンドウは自動的に破棄されます。 DestroyWindowメンバー関数は、最初に子ウィンドウを破棄し、次にウィンドウ自体を破棄します。

DestroyWindowメンバー関数は、CDialog::Createによって作成されたモードレスダイアログボックスも破棄します。

破棄される CWnd が子ウィンドウであり、 WS_EX_NOPARENTNOTIFY スタイルが設定されていない場合は、 WM_PARENTNOTIFY メッセージが親に送信されます。

例

// CModeless is a CDialog class representing a modeless dialog
// Destruction of the modeless dialog involves calling DestroyWindow in 
// OnOK() & OnCancel() handlers
void CModeless::OnOK() 
{ 
   if (!UpdateData(TRUE)) 
   {
      TRACE(_T("UpdateData failed during dialog termination\n"));
      // The UpdateData routine will set focus to correct item
      return;
   }
   DestroyWindow();
}

void CModeless::OnCancel()
{
   DestroyWindow();
}

`CWnd::Detach`

CWnd オブジェクトから Windows のハンドルを切り離し、そのハンドルを返します。

HWND Detach();

戻り値

Windows オブジェクトへの HWND 。

例

CWnd::Attach の例を参照してください。

`CWnd::DlgDirList`

リストボックスにファイルリストまたはディレクトリリストを設定します。

int DlgDirList(
    LPTSTR lpPathSpec,
    int nIDListBox,
    int nIDStaticPath,
    UINT nFileType);

パラメーター

lpPathSpec
パスまたはファイル名を含む null で終わる文字列を指します。 DlgDirList は、この文字列を変更します。これは、変更を含めるのに十分な長さである必要があります。詳細については、次の「解説」セクションを参照してください。

nIDListBox
リストボックスの識別子を指定します。 nIDListBoxが 0 の場合、DlgDirListはリストボックスが存在せず、リストボックスの入力を試みないことを前提としています。

nIDStaticPath
現在のドライブとディレクトリの表示に使用する静的テキストコントロールの識別子を指定します。 nIDStaticPathが 0 の場合、DlgDirListはそのようなテキストコントロールが存在しないと見なします。

nFileType
表示するファイルの属性を指定します。次の値を任意に組み合わせて使用できます。

DDL_READWRITE 追加の属性を持たないデータファイルの読み取り/書き込み。
DDL_READONLY 読み取り専用ファイル。
DDL_HIDDEN 隠しファイル。
DDL_SYSTEM システムファイル。
DDL_DIRECTORY ディレクトリ。
DDL_ARCHIVE 史料。
DDL_POSTMSGSLB_DIRフラグ。 LB_DIR フラグが設定されている場合、Windows はDlgDirListによって生成されたメッセージをアプリケーションのキューに配置します。それ以外の場合は、ダイアログボックスプロシージャに直接送信されます。
DDL_DRIVES ドライブ。 DDL_DRIVES フラグが設定されている場合、DDL_EXCLUSIVE フラグは自動的に設定されます。そのため、ドライブとファイルを含むディレクトリ一覧を作成するには、 DlgDirList を 2 回呼び出す必要があります。1 回は DDL_DRIVES フラグを設定し、1 回は残りの一覧のフラグで呼び出します。
DDL_EXCLUSIVE 排他的ビット。排他ビットが設定されている場合は、指定した型のファイルのみが一覧表示されます。それ以外の場合は、指定した種類の通常のファイルとファイルが一覧表示されます。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

DlgDirList は、 LB_RESETCONTENT メッセージと LB_DIR メッセージをリストボックスに送信します。 nIDListBoxによって指定されたリストボックスに、lpPathSpecによって指定されたパスと一致するすべてのファイルの名前が入力されます。

lpPathSpec パラメーターの形式は次のとおりです。

[drive:] [ [\u]directory[\idirectory]...\u] [filename]

この例では、 drive はドライブ文字、 directory は有効なディレクトリ名、 filename は少なくとも 1 つのワイルドカードを含む必要がある有効なファイル名です。ワイルドカードは疑問符 (?) です。これは、任意の文字に一致し、アスタリスク (*) を意味します。これは任意の数の文字に一致します。

lpPathSpecに長さ 0 の文字列を指定した場合、またはディレクトリ名のみを指定してもファイル指定を含まない場合、文字列は "*.*" に変更されます。

lpPathSpecドライブやディレクトリ名が含まれている場合、現在のドライブとディレクトリは、リストボックスが入力される前に、指定されたドライブとディレクトリに変更されます。 nIDStaticPathによって識別されるテキストコントロールも、新しいドライブやディレクトリ名で更新されます。

リストボックスが入力されると、パスのドライブまたはディレクトリ部分を削除することで、 lpPathSpec が更新されます。

例

// If pDialog points to a CDialog object with a list box
// with the identifier IDC_DIRLIST, this call will populate
// the box with only the non-hidden subdirectories in the root
// directory of the C:\ drive.
TCHAR path[MAX_PATH];
_tcscpy_s(path, MAX_PATH, _T("C:\\"));

pDialog->DlgDirList(path, IDC_DIRLIST, 0, DDL_EXCLUSIVE | DDL_DIRECTORY);

`CWnd::DlgDirListComboBox`

コンボボックスにファイルリストまたはディレクトリリストを設定します。

int DlgDirListComboBox(
    LPTSTR lpPathSpec,
    int nIDComboBox,
    int nIDStaticPath,
    UINT nFileType);

パラメーター

lpPathSpec
パスまたはファイル名を含む null で終わる文字列を指します。 DlgDirListComboBox は、この文字列を変更するため、このデータを文字列リテラルの形式にすることはできません。次の「解説」セクションを参照してください。

nIDComboBox
ダイアログボックス内のコンボボックスの識別子を指定します。 nIDComboBoxが 0 の場合、DlgDirListComboBoxはコンボボックスが存在せず、1 つも塗りつぶさないことを前提としています。

nIDStaticPath
現在のドライブとディレクトリの表示に使用する静的テキストコントロールの識別子を指定します。 nIDStaticPathが 0 の場合、DlgDirListComboBoxはそのようなテキストコントロールが存在しないと見なします。

nFileType
表示するファイルの DOS ファイル属性を指定します。次の値を任意に組み合わせて使用できます。

DDL_READWRITE 追加の属性を持たないデータファイルの読み取り/書き込み。
DDL_READONLY 読み取り専用ファイル。
DDL_HIDDEN 隠しファイル。
DDL_SYSTEM システムファイル。
DDL_DIRECTORY ディレクトリ。
DDL_ARCHIVE 史料。
DDL_POSTMSGSCB_DIRフラグ。 CB_DIR フラグが設定されている場合、Windows はDlgDirListComboBoxによって生成されたメッセージをアプリケーションのキューに配置します。それ以外の場合は、ダイアログボックスプロシージャに直接送信されます。
DDL_DRIVES ドライブ。 DDL_DRIVES フラグが設定されている場合、DDL_EXCLUSIVE フラグは自動的に設定されます。そのため、ドライブとファイルを含むディレクトリ一覧を作成するには、 DlgDirListComboBox を 2 回呼び出す必要があります。1 回は DDL_DRIVES フラグを設定し、1 回は残りの一覧のフラグで呼び出します。
DDL_EXCLUSIVE 排他的ビット。排他ビットが設定されている場合は、指定した型のファイルのみが一覧表示されます。それ以外の場合は、指定した種類の通常のファイルとファイルが一覧表示されます。

戻り値

関数の結果を指定します。リストが作成された場合は 0 以外で、空の一覧も含まれます。 0 の戻り値は、入力文字列に有効な検索パスが含まれていないことを意味します。

解説

DlgDirListComboBox は CB_RESETCONTENT メッセージと CB_DIR メッセージをコンボボックスに送信します。 nIDComboBoxで指定されたコンボボックスのリストボックスに、lpPathSpecによって指定されたパスに一致するすべてのファイルの名前が入力されます。

lpPathSpec パラメーターの形式は次のとおりです。

[drive:] [ [\u]directory[\idirectory]...\u] [filename]

この例では、 drive はドライブ文字、 directory は有効なディレクトリ名、 filename は少なくとも 1 つのワイルドカードを含む必要がある有効なファイル名です。ワイルドカードは疑問符 (?) です。これは任意の文字に一致し、アスタリスク (*) です。これは任意の数の文字に一致します。

lpPathSpecに長さ 0 の文字列を指定すると、現在のディレクトリが使用され、lpPathSpecは変更されません。ディレクトリ名のみを指定したが、ファイル指定を含まない場合、文字列は "*" に変更されます。

コンボボックスのリストボックスが入力されると、パスのドライブやディレクトリの部分を削除することで、 lpPathSpec が更新されます。

例

// If pDialog points to a CDialog object with a combo box
// with the identifier IDC_DIRCOMBO, this call will populate
// the box with only the non-hidden subdirectories in the root
// directory of the C:\ drive.

TCHAR szPath[MAX_PATH];
_tcsncpy_s(szPath, MAX_PATH, _T("C:\\"), MAX_PATH);
pDialog->DlgDirListComboBox(szPath, IDC_DIRCOMBO, 0, DDL_EXCLUSIVE | DDL_DIRECTORY);

// Note that the first argument is a string and not a string
// literal. This is necessary because DlgDirListComboBox
// modifies the supplied string. Passing a string literal
// will result in an access violation.

`CWnd::DlgDirSelect`

リストボックスから現在の選択を取得します。

BOOL DlgDirSelect(
    LPTSTR lpString,
    int nIDListBox);

パラメーター

lpString
リストボックスの現在の選択範囲を受け取るバッファーを指します。

nIDListBox
ダイアログボックスのリストボックスの整数 ID を指定します。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

リストボックスが DlgDirList メンバー関数によって入力されていること、および選択内容がドライブ文字、ファイル、またはディレクトリ名であることを前提としています。

DlgDirSelectメンバー関数は、lpStringによって指定されたバッファーに選択範囲をコピーします。選択されていない場合、 lpString は変更されません。

DlgDirSelect は、 LB_GETCURSEL メッセージと LB_GETTEXT メッセージをリストボックスに送信します。

リストボックスから複数のファイル名を返すことを許可しません。リストボックスは複数選択リストボックスにすることはできません。

`CWnd::DlgDirSelectComboBox`

コンボボックスから現在の選択を取得します。

BOOL DlgDirSelectComboBox(
    LPTSTR lpString,
    int nIDComboBox);

パラメーター

lpString
選択したパスを受け取るバッファーを指します。

nIDComboBox
ダイアログボックスのコンボボックスの整数 ID を指定します。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

リストボックスが DlgDirListComboBox メンバー関数によって入力されていること、および選択内容がドライブ文字、ファイル、またはディレクトリ名であることを前提としています。

DlgDirSelectComboBox メンバー関数は、選択範囲を指定したバッファーにコピーします。選択されていない場合、バッファーの内容は変更されません。

DlgDirSelectComboBox は CB_GETCURSEL メッセージと CB_GETLBTEXT メッセージをコンボボックスに送信します。

コンボボックスから複数のファイル名を返すことを許可しません。

`CWnd::DoDataExchange`

ダイアログデータを交換および検証するためにフレームワークによって呼び出されます。

virtual void DoDataExchange(CDataExchange* pDX);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。

解説

この関数を直接呼び出すことはありません。これは、 UpdateData メンバー関数によって呼び出されます。ダイアログボックスのコントロールを初期化したり、ダイアログボックスからデータを取得したりするには、 UpdateData を呼び出します。

CDialogからアプリケーション固有のダイアログクラスを派生させる場合、フレームワークの自動データ交換と検証を利用する場合は、このメンバー関数をオーバーライドする必要があります。変数の追加ウィザードは、ダイアログデータ交換 (DDX) および検証 (DDV) グローバル関数呼び出しの目的の "データマップ" を含む、このメンバー関数のオーバーライドされたバージョンを記述します。

このメンバー関数のオーバーライドされたバージョンを自動的に生成するには、まずダイアログエディターを使用してダイアログリソースを作成し、次にアプリケーション固有のダイアログクラスを派生させます。次に、変数の追加ウィザードを使用して、変数、データ、および検証範囲を新しいダイアログボックスのさまざまなコントロールに関連付けます。その後、データマップを含むオーバーライドされた DoDataExchangeがウィザードによって書き込まれます。変数の追加ウィザードによって生成される DDX/DDV コードブロックの例を次に示します。

void CPenWidthsDlg::DoDataExchange(CDataExchange *pDX)
{
   CDialog::DoDataExchange(pDX);
   DDX_Text(pDX, IDC_THINPENWIDTH, m_nThinWidth);
   DDV_MinMaxInt(pDX, m_nThinWidth, 1, 20);
   DDX_Text(pDX, IDC_THICKPENWIDTH, m_nThickWidth);
   DDV_MinMaxInt(pDX, m_nThickWidth, 1, 20);
}

DoDataExchangeオーバーライドされたメンバー関数は、ソースファイル内のマクロステートメントの前に置く必要があります。

ダイアログデータの交換と検証の詳細については、「フォーム内のデータの表示と操作と Dialog Data Exchange と検証を参照してください。変数の追加ウィザードによって生成されるDDX_マクロとDDV_マクロの詳細については、「テクニカルノート 26を参照してください。

`CWnd::DragAcceptFiles`

アプリケーションのCWinApp::InitInstance関数で、CWnd ポインターを使用してウィンドウ内からこのメンバー関数を呼び出して、ウィンドウが Windows ファイルマネージャーまたはエクスプローラーから削除されたファイルを受け入れることを示します。

void DragAcceptFiles(BOOL bAccept = TRUE);

パラメーター

BAccept
ドラッグされたファイルを受け入れるかどうかを示すフラグ。

解説

bAccept パラメーターを TRUE に設定してDragAcceptFilesを呼び出すウィンドウのみが、Windows メッセージ WM_DROPFILESを処理できると認識しています。たとえば、MDI アプリケーションでは、DragAcceptFiles関数呼び出しでCMDIFrameWnd ウィンドウポインターが使用されている場合、CMDIFrameWnd ウィンドウのみがWM_DROPFILESメッセージを取得します。このメッセージは、開いているすべてのウィンドウに送信 CMDIChildWnd 。 CMDIChildWnd ウィンドウがこのメッセージを受信するには、CMDIChildWnd ウィンドウポインターを使用してDragAcceptFilesを呼び出す必要があります。

ドラッグされたファイルの受信を中止するには、 bAccept を FALSE に設定してメンバー関数を呼び出します。

`CWnd::DragDetect`

マウスをキャプチャし、ユーザーが左ボタンを離すか、Esc キーを押すか、または指定した点を中心にしたドラッグ四角形の外にマウスを移動するまで、移動を追跡します。

BOOL DragDetect(POINT pt) const;

パラメーター

pt
マウスの初期位置 (画面座標)。この関数は、この点を使用してドラッグ四角形の座標を決定します。

戻り値

ユーザーが左ボタンを押したままドラッグ四角形の外側にマウスを移動した場合、戻り値は 0 以外です。

ユーザーが左ボタンを押しながらドラッグ四角形の外側にマウスを移動しなかった場合、戻り値は 0 になります。

解説

このメンバー関数は、Windows SDK で説明されているように、関数 DragDetectの機能をエミュレートします。

`CWnd::DrawAnimatedRects`

アイコンを開く動作や、ウィンドウの最小化または最大化の動作を、ワイヤフレームの四角形のアニメーションで表します。

BOOL DrawAnimatedRects(
    int idAni,
    CONST RECT* lprcFrom,
    CONST RECT* lprcTo);

パラメーター

idAni
アニメーションの種類を指定します。 IDANI_CAPTIONを指定すると、ウィンドウキャプションは、lprcFromで指定された位置からlprcToで指定された位置までアニメーション化されます。この効果は、ウィンドウの最小化または最大化に似ています。

lprcFrom
アイコンまたは最小化されたウィンドウの場所とサイズを指定する RECT 構造体へのポインター。

lprcTo
復元されたウィンドウの場所とサイズを指定する RECT 構造体へのポインター

戻り値

関数が正常終了した場合は 0 以外。それ以外の場合は 0。

解説

このメンバー関数は、Windows SDK で説明されているように、関数 DrawAnimatedRectsの機能をエミュレートします。

`CWnd::DrawCaption`

ウィンドウのキャプションを描画します。

BOOL DrawCaption(
    CDC* pDC,
    LPCRECT lprc,
    UINT uFlags);

パラメーター

pDC
デバイスコンテキストへのポインター。この関数は、このデバイスコンテキストにウィンドウキャプションを描画します。

lprc
ウィンドウキャプションの外接する四角形を指定する RECT 構造体へのポインター。

uFlags
描画オプションを指定します。値の完全な一覧については、 DrawCaptionを参照してください。

戻り値

関数が正常終了した場合は 0 以外。それ以外の場合は 0。

解説

このメンバー関数は、Windows SDK で説明されているように、関数 DrawCaptionの機能をエミュレートします。

`CWnd::DrawMenuBar`

メニューバーを再描画します。

void DrawMenuBar();

解説

Windows がウィンドウを作成した後にメニューバーが変更された場合は、この関数を呼び出して、変更されたメニューバーを描画します。

例

CWnd::GetMenu の例を参照してください。

`CWnd::EnableActiveAccessibility`

ユーザー定義の Active Accessibility 関数を有効にします。

void EnableActiveAccessibility();

解説

MFC の既定の Active Accessibility サポートは、ActiveX コントロールを含む標準のウィンドウとコントロールに対して十分です。ただし、 CWnd派生クラスにウィンドウなしのユーザーインターフェイス要素が含まれている場合、MFC にはそれらの要素を知る方法はありません。その場合は、クラスの適切な Active Accessibility メンバー関数をオーバーライドし、クラスのコンストラクターで EnableActiveAccessibility を呼び出す必要があります。

`CWnd::EnableDynamicLayout`

動的レイアウトマネージャーを有効または無効にします。動的レイアウトが有効な場合は、ユーザーがウィンドウのサイズを変更したときに、子ウィンドウの位置とサイズを動的に調整できます。

void EnableDynamicLayout(BOOL bEnable = TRUE);

パラメーター

bEnable
TRUE 動的レイアウトを有効にする場合。動的レイアウトを無効にする FALSE 。

解説

動的レイアウトを有効にする場合は、このメソッドを呼び出す以外にも必要な作業があります。ウィンドウ内のコントロールがサイズ変更にどのように応答するかを指定する、動的レイアウト情報も提供する必要があります。この情報は、コントロールごとに、リソースエディターで指定することも、プログラムで指定することもできます。「ダイナミックレイアウトを参照してください。

`CWnd::EnableD2DSupport`

ウィンドウの D2D のサポートを有効または無効にします。このメソッドは、メインウィンドウが初期化される前に呼び出します。

void EnableD2DSupport(
    BOOL bEnable = TRUE,
    BOOL bUseDCRenderTarget = FALSE);

パラメーター

bEnable
ウィンドウの D2D のサポートをオンにするかオフにするかを指定します。

bUseDCRenderTarget
デバイスコンテキスト (DC) レンダーターゲットを使用するかどうかの種類、 CDCRenderTarget。 FALSE の場合、CHwndRenderTarget が使用されます。

`CWnd::EnableScrollBar`

スクロールバーの矢印の一方または両方を有効または無効にします。

BOOL EnableScrollBar(
    int nSBFlags,
    UINT nArrowFlags = ESB_ENABLE_BOTH);

パラメーター

nSBFlags
スクロールバーの種類を指定します。次のいずれかの値になります。

SB_BOTH ウィンドウに関連付けられている水平スクロールバーと垂直スクロールバーの矢印を有効または無効にします。
SB_HORZ ウィンドウに関連付けられている水平スクロールバーの矢印を有効または無効にします。
SB_VERT ウィンドウに関連付けられている垂直スクロールバーの矢印を有効または無効にします。

nArrowFlags
スクロールバーの矢印を有効にするか無効にするか、どの矢印を有効または無効にするかを指定します。次のいずれかの値になります。

ESB_ENABLE_BOTH スクロールバーの両方の矢印を有効にします (既定)。
ESB_DISABLE_LTUP 水平スクロールバーの左矢印または垂直スクロールバーの上矢印を無効にします。
ESB_DISABLE_RTDN 水平スクロールバーの右矢印または垂直スクロールバーの下矢印を無効にします。
ESB_DISABLE_BOTH スクロールバーの両方の矢印を無効にします。

戻り値

矢印が指定されたとおりに有効または無効になっている場合は 0 以外。それ以外の場合は 0 です。これは、矢印が既に要求された状態であるか、エラーが発生したことを示します。

`CWnd::EnableScrollBarCtrl`

このウィンドウのスクロールバーを有効または無効にします。

void EnableScrollBarCtrl(
    int nBar,
    BOOL bEnable = TRUE);

パラメーター

nBar
スクロールバー識別子。

bEnable
スクロールバーを有効にするか無効にするかを指定します。

解説

ウィンドウに兄弟スクロールバーコントロールがある場合は、そのスクロールバーが使用されます。それ以外の場合は、ウィンドウ独自のスクロールバーが使用されます。

`CWnd::EnableToolTips`

特定のウィンドウのツールヒントを有効にします。

BOOL EnableToolTips(BOOL bEnable = TRUE);

パラメーター

bEnable
ツールヒントコントロールを有効にするか無効にするかを指定します。 TRUE コントロールを有効にします。 FALSE コントロールを無効にします。

戻り値

TRUE ツールヒントが有効な場合。それ以外の場合は FALSE。

解説

OnToolHitTestをオーバーライドして、ウィンドウのTOOLINFO構造体または構造体を提供します。

Note

CToolBarなどの一部のウィンドウには、OnToolHitTestの組み込み実装が用意されています。

この構造の詳細については、Windows SDK の TOOLINFO を参照してください。

EnableToolTipsを呼び出すだけでは、親ウィンドウがCFrameWndから派生している場合を除き、子コントロールのツールヒントを表示するには不十分です。これは、 CFrameWnd が TTN_NEEDTEXT 通知の既定のハンドラーを提供するためです。親ウィンドウが CFrameWndから派生していない場合、つまり、ダイアログボックスまたはフォームビューの場合、 TTN_NEEDTEXT ツールヒント通知のハンドラーを指定しない限り、子コントロールのツールヒントは正しく表示されません。「ツールのヒント」を参照してください。

EnableToolTipsによってウィンドウに提供される既定のツールヒントには、テキストが関連付けされていません。ツールヒントを表示するテキストを取得するために、ツールヒントウィンドウが表示される直前に、 TTN_NEEDTEXT 通知がツールヒントコントロールの親ウィンドウに送信されます。 TOOLTIPTEXT構造体のpszText メンバーに値を割り当てるためのハンドラーがこのメッセージに存在しない場合、ツールヒントのテキストは表示されません。

例

// From message map for CMdiView, a CView-derived class
ON_NOTIFY_EX_RANGE(TTN_NEEDTEXTW, 0, 0xFFFF, &CMdiView::OnToolTipNotify)
ON_NOTIFY_EX_RANGE(TTN_NEEDTEXTA, 0, 0xFFFF, &CMdiView::OnToolTipNotify)

void CMdiView::OnInitialUpdate()
{
   CView::OnInitialUpdate();

   m_Edit.Create(ES_MULTILINE | WS_CHILD | WS_VISIBLE | WS_TABSTOP | WS_BORDER,
                 CRect(10, 10, 100, 100), this, IDC_TTEDIT);
   EnableToolTips(TRUE); // enable tool tips for view
}

//Notification handler
BOOL CMdiView::OnToolTipNotify(UINT id, NMHDR *pNMHDR, LRESULT *pResult)
{
   UNREFERENCED_PARAMETER(id);
   UNREFERENCED_PARAMETER(pResult);

   // need to handle both ANSI and UNICODE versions of the message
   TOOLTIPTEXTA *pTTTA = (TOOLTIPTEXTA*)pNMHDR;
   TOOLTIPTEXTW *pTTTW = (TOOLTIPTEXTW*)pNMHDR;
   CStringA strTipText;
   UINT_PTR nID = pNMHDR->idFrom;
   if (pNMHDR->code == TTN_NEEDTEXTA && (pTTTA->uFlags & TTF_IDISHWND) ||
       pNMHDR->code == TTN_NEEDTEXTW && (pTTTW->uFlags & TTF_IDISHWND))
   {
      // idFrom is actually the HWND of the tool
      nID = ::GetDlgCtrlID((HWND)nID);
   }

   if (nID != 0) // will be zero on a separator
      strTipText.Format("Control ID = %d", nID);

   if (pNMHDR->code == TTN_NEEDTEXTA)
   {
      strncpy_s(pTTTA->szText, sizeof(pTTTA->szText), strTipText,
                strTipText.GetLength() + 1);
   }
   else
   {
      ::MultiByteToWideChar(CP_ACP, 0, strTipText, strTipText.GetLength() + 1,
                            pTTTW->szText, sizeof(pTTTW->szText) / (sizeof pTTTW->szText[0]));
   }

   return TRUE; // message was handled
}

`CWnd::EnableTrackingToolTips`

追跡ツールヒントを有効または無効にします。

BOOL EnableTrackingToolTips(BOOL bEnable = TRUE);

パラメーター

bEnable
追跡ツールヒントを有効にするか無効にするかを指定します。このパラメーターが TRUE場合、追跡ツールのヒントが有効になります。このパラメーターが FALSE場合、追跡ツールのヒントは無効になります。

戻り値

EnableWindow メンバー関数が呼び出される前の状態を示します。ウィンドウが以前に無効になっていた場合、戻り値は 0 以外です。ウィンドウが以前に有効になっていたか、エラーが発生した場合、戻り値は 0 です。

解説

追跡ツールヒントは、画面上に動的に配置できるツールヒントウィンドウです。位置を迅速に更新すると、ツールヒントウィンドウがスムーズに移動するか、"追跡" するように見えます。この機能は、ポインターの移動時にポインターの位置に従うツールヒントテキストが必要な場合に便利です。

`CWnd::EnableWindow`

マウス入力およびキーボード入力を有効または無効にします。

BOOL EnableWindow(BOOL bEnable = TRUE);

パラメーター

bEnable
指定されたウィンドウを有効にするか無効にするかを指定します。このパラメーターが TRUE場合、ウィンドウが有効になります。このパラメーターが FALSE場合、ウィンドウは無効になります。

戻り値

解説

入力を無効にすると、マウスクリックやキーストロークなどの入力は無視されます。入力が有効になっている場合、ウィンドウはすべての入力を処理します。

有効な状態が変化している場合、この関数が戻る前に WM_ENABLE メッセージが送信されます。

無効にした場合、すべての子ウィンドウは暗黙的に無効になりますが、メッセージ WM_ENABLE 送信されません。

アクティブ化する前に、ウィンドウを有効にする必要があります。たとえば、アプリケーションがモードレスダイアログボックスを表示していて、メインウィンドウを無効にしている場合、ダイアログボックスが破棄される前にメインウィンドウを有効にする必要があります。それ以外の場合は、別のウィンドウが入力フォーカスを取得し、アクティブになります。子ウィンドウが無効になっている場合は、Windows がマウスメッセージを取得するウィンドウを決定しようとしたときに無視されます。

既定では、ウィンドウは作成時に有効になります。アプリケーションは、Createまたは CreateEx メンバー関数でWS_DISABLED スタイルを指定して、最初に無効になっているウィンドウを作成できます。ウィンドウが作成されたら、アプリケーションで EnableWindow メンバー関数を使用して、ウィンドウを有効または無効にすることもできます。

アプリケーションでは、この関数を使用して、ダイアログボックス内のコントロールを有効または無効にすることができます。無効になっているコントロールは、入力フォーカスを受け取ることも、ユーザーがアクセスすることもできません。

例

//CMyFileDialog is a CFileDialog-derived class
//OnInitDialog is the handler for WM_INITDIALOG
BOOL CMyFileDialog::OnInitDialog()
{
   CFileDialog::OnInitDialog();

   CWnd *pWndParent = GetParent();

   //make sure you add #include <dlgs.h> for IDs 'edt1' & 'stc3'

   //disables the 'file name' edit and static control
   //of the standard file open dialog

   //get handle of 'file name' combobox control & disable it
   CWnd *pWnd = pWndParent->GetDlgItem(cmb13);
   pWnd->EnableWindow(FALSE);

   //get handle of 'file name' static control & disable it
   pWnd = pWndParent->GetDlgItem(stc3);
   pWnd->EnableWindow(FALSE);

   return TRUE;
}

`CWnd::EndModalLoop`

RunModalLoopの呼び出しを終了します。

virtual void EndModalLoop(int nResult);

パラメーター

nResult
RunModalLoopの呼び出し元に返される値を格納します。

解説

nResult パラメーターは、RunModalLoopから戻り値に伝達されます。

`CWnd::EndModalState`

フレームウィンドウをモーダルからモードレスに変更します。

virtual void EndModalState();

`CWnd::EndPaint`

指定されたウィンドウで描画の終了をマークします。

void EndPaint(LPPAINTSTRUCT lpPaint);

パラメーター

lpPaint
BeginPaint メンバー関数によって取得された描画情報を含むPAINTSTRUCT構造体を指します。

解説

EndPaint メンバー関数は、BeginPaint メンバー関数の呼び出しごとに必要ですが、描画が完了した後にのみ必要です。

キャレットが BeginPaint メンバー関数によって非表示にされた場合、 EndPaint はキャレットを画面に復元します。

例

CWnd::BeginPaint の例を参照してください。

`CWnd::ExecuteDlgInit`

ダイアログリソースを開始します。

BOOL ExecuteDlgInit(LPCTSTR lpszResourceName);
BOOL ExecuteDlgInit(LPVOID lpResource);

パラメーター

lpszResourceName
リソースの名前を指定する null で終わる文字列へのポインター。

lpResource
リソースへのポインター。

戻り値

TRUE ダイアログリソースが実行される場合。それ以外の場合は FALSE。

解説

ExecuteDlgInit は、実行中のモジュールにバインドされたリソース、または他のソースからのリソースを使用します。これを実現するために、ExecuteDlgInitAfxFindResourceHandleを呼び出してリソースハンドルを検索します。 MFC アプリケーションが共有 DLL (MFCx0[U][D].DLL) を使用していない場合、 AfxFindResourceHandle は AfxGetResourceHandleを呼び出し、実行可能ファイルの現在のリソースハンドルを返します。 MFCx0[U][D].DLLを使用する MFC アプリケーションの場合、 AfxFindResourceHandle は、適切なリソースハンドルを探して共有および MFC 拡張 DLL の CDynLinkLibrary オブジェクトリストを走査します。

`CWnd::FilterToolTipMessage`

ツールヒントメッセージを表示するためにフレームワークによって呼び出されます。

void FilterToolTipMessage(MSG* pMsg);

パラメーター

pMsg
ツールヒントメッセージへのポインター。

解説

ほとんどの MFC アプリケーションでは、このメソッドはフレームワークによって PreTranslateMessage および EnableToolTipsから呼び出されるため、自分で呼び出す必要はありません。

ただし、一部の ActiveX コントロールなどの特定のアプリケーションでは、これらのメソッドがフレームワークによって呼び出されない可能性があるため、自分で FilterToolTipMessage 呼び出す必要があります。詳細については、「ツールヒントの作成のメソッド」を参照してください。

`CWnd::FindWindow`

ウィンドウクラスがlpszClassNameによって指定され、ウィンドウ名またはタイトルがlpszWindowNameによって与えられる最上位レベルのCWndを返します。

static CWnd* PASCAL FindWindow(
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName);

パラメーター

lpszClassName
ウィンドウのクラス名 ( WNDCLASS 構造体) を指定する null で終わる文字列を指します。 lpClassNameがNULLの場合、すべてのクラス名が一致します。

lpszWindowName
ウィンドウ名 (ウィンドウのタイトル) を指定する null で終わる文字列を指します。 lpWindowNameがNULLの場合、すべてのウィンドウ名が一致します。

戻り値

指定したクラス名とウィンドウ名を持つウィンドウを識別します。そのようなウィンドウが見つからない場合は NULL 。

CWnd* は一時的なものであり、後で使用するために保存しないでください。

解説

この関数で、子ウィンドウは検索されません。

例

// activate an application with a window with a specific class name
BOOL CMyApp::FirstInstance()
{
   CWnd *pWndPrev, *pWndChild;

   // Determine if a window with the class name exists...
   pWndPrev = CWnd::FindWindow(_T("MyNewClass"), NULL);
   if (NULL != pWndPrev)
   {
      // If so, does it have any popups?
      pWndChild = pWndPrev->GetLastActivePopup();

      // If iconic, restore the main window
      if (pWndPrev->IsIconic())
         pWndPrev->ShowWindow(SW_RESTORE);

      // Bring the main window or its popup to the foreground
      pWndChild->SetForegroundWindow();

      // and you are done activating the other application
      return FALSE;
   }

   return TRUE;
}

`CWnd::FindWindowEx`

クラス名とウィンドウ名が指定した文字列と一致するウィンドウオブジェクトを取得します。

static CWnd* FindWindowEx(
    HWND hwndParent,
    HWND hwndChildAfter,
    LPCTSTR lpszClass,
    LPCTSTR lpszWindow);

パラメーター

hwndParent
子ウィンドウを検索する親ウィンドウへのハンドル。

hwndChildAfter
子ウィンドウへのハンドル。検索は、Z オーダーの次の子ウィンドウで始まります。子ウィンドウは、子孫ウィンドウだけでなく、 hwndParentの直接の子ウィンドウである必要があります。

lpszClass
RegisterClassまたはRegisterClassExへの以前の呼び出しによって作成されたクラス名またはクラスアトムを指定する null で終わる文字列へのポインター。

lpszWindow
ウィンドウ名 (ウィンドウのタイトル) を指定する null で終わる文字列へのポインター。このパラメーターが NULLの場合、すべてのウィンドウ名が一致します。

戻り値

関数が成功した場合、戻り値は、指定されたクラスとウィンドウ名を持つウィンドウオブジェクトへのポインターです。関数が失敗した場合、戻り値は NULL。

解説

このメンバー関数は、Windows SDK で説明されているように、関数 FindWindowExの機能をエミュレートします。

`CWnd::FlashWindow`

指定したウィンドウを 1 回点滅します。

BOOL FlashWindow(BOOL bInvert);

パラメーター

bInvert
CWndをフラッシュするか、元の状態に戻すかを指定します。 bInvertがTRUEされている場合、CWndは一方の状態から他方の状態にフラッシュされます。 bInvertがFALSEされている場合、ウィンドウは元の状態 (アクティブまたは非アクティブ) に返されます。

戻り値

FlashWindow メンバー関数の呼び出し前にウィンドウがアクティブであった場合は 0 以外、それ以外の場合は 0。

解説

連続して点滅する場合は、システムタイマーを作成し、 FlashWindowを繰り返し呼び出します。 CWndを点滅させるということは、タイトルバーの外観を、CWndが非アクティブ状態からアクティブな状態に変わっていたかのように、またはその逆に変更することを意味します。 (非アクティブなタイトルバーがアクティブなタイトルバーに変わり、アクティブなタイトルバーが非アクティブなタイトルバーに変わります)。

通常、ウィンドウは点滅して、ユーザーに注意が必要だが、現在は入力フォーカスがないことを通知します。

bInvert パラメーターは、ウィンドウが入力フォーカスを取得していて、点滅しなくなった場合にのみFALSEする必要があります。入力フォーカスの取得を待機している間、連続する呼び出しでTRUEする必要があります。

この関数は、最小化されたウィンドウでは常に 0 以外の値を返します。ウィンドウが最小化されている場合、 FlashWindow はウィンドウのアイコンを点滅します。最小化されたウィンドウでは bInvert は無視されます。

例

BOOL CPenWidthsDlg::OnInitDialog()
{
   CDialog::OnInitDialog();

   // set timer to cause dialog to flash
   SetTimer(1, 500, NULL);
   return TRUE; // return TRUE unless you set the focus to a control
}

void CPenWidthsDlg::OnTimer(UINT_PTR nIDEvent)
{
   // cause the dialog to flash
   FlashWindow(TRUE);
   CDialog::OnTimer(nIDEvent);
}

`CWnd::FlashWindowEx`

指定されたウィンドウを点滅します。

BOOL FlashWindowEx(
    DWORD dwFlags,
    UINT uCount,
    DWORD dwTimeout);

パラメーター

*dwFlags*
フラッシュの状態を指定します。値の完全な一覧については、 FLASHWINFO 構造を参照してください。

uCount
ウィンドウを点滅させる回数を指定します。

dwTimeout
ウィンドウが点滅する速度をミリ秒単位で指定します。 dwTimeoutが 0 の場合、関数は既定のカーソルの点滅速度を使用します。

戻り値

戻り値は、 FlashWindowEx 関数の呼び出し前のウィンドウの状態を指定します。ウィンドウキャプションが呼び出しの前にアクティブとして描画された場合、戻り値は 0 以外です。それ以外の場合、戻り値は 0 です。

解説

このメソッドは、Windows SDK で説明されているように、関数 FlashWindowExの機能をエミュレートします。

`CWnd::FromHandle`

ウィンドウのハンドルが指定されている場合、CWnd オブジェクトへのポインターを返します。 CWnd オブジェクトがハンドルにアタッチされていない場合は、一時的なCWnd オブジェクトが作成されてアタッチされます。

static CWnd* PASCAL FromHandle(HWND hWnd);

パラメーター

hWnd
Windows ウィンドウの HWND 。

戻り値

ポインターは一時的なものであり、後で使用するために格納しないでください。

`CWnd::FromHandlePermanent`

ウィンドウのハンドルが指定されている場合、CWnd オブジェクトへのポインターを返します。

static CWnd* PASCAL FromHandlePermanent(HWND hWnd);

パラメーター

hWnd
Windows ウィンドウの HWND 。

戻り値

CWnd オブジェクトを指すポインターです。

解説

CWnd オブジェクトがハンドルにアタッチされていない場合は、NULLが返されます。

この関数は、 FromHandleとは異なり、一時オブジェクトを作成しません。

`CWnd::get_accChild`

指定された子の IDispatch インターフェイスのアドレスを取得するために、フレームワークによって呼び出されます。

virtual HRESULT get_accChild(
    VARIANT varChild,
    IDispatch** ppdispChild);

パラメーター

varChild
IDispatch インターフェイスを取得する子を識別します。

ppdispChild
子オブジェクトの IDispatch インターフェイスのアドレスを受け取ります。

戻り値

成功した S_OK 、失敗した場合は COM エラーコードを返します。 Windows SDK のIAccessible::get_accChildの「戻す値」を参照してください。

解説

この関数は、MFC の Active Accessibility サポートの一部です。

詳細については、Windows SDK の IAccessible::get_accChild に関する記事を参照してください。

`CWnd::get_accChildCount`

このオブジェクトに属する子の数を取得するために、フレームワークによって呼び出されます。

virtual HRESULT get_accChildCount(long* pcountChildren);

パラメーター

pcountChildren
子の数を受け取ります。

戻り値

成功した S_OK 、失敗した場合は COM エラーコードを返します。 Windows SDK のIAccessible::get_accChildCountの「戻す値」を参照してください。

解説

この関数は、MFC の Active Accessibility サポートの一部です。

ウィンドウのないユーザーインターフェイス要素 (MFC が処理するウィンドウレス ActiveX コントロール以外) がある場合は、 CWnd派生クラスでこの関数をオーバーライドします。基底クラスのバージョンを呼び出し、ウィンドウ化されていない子要素を追加します。

詳細については、Windows SDK の IAccessible::get_accChildCount に関する記事を参照してください。

`CWnd::get_accDefaultAction`

オブジェクトの既定のアクションを記述する文字列を取得するために、フレームワークによって呼び出されます。

virtual HRESULT get_accDefaultAction(
    VARIANT varChild,
    BSTR* pszDefaultAction);

パラメーター

varChild
取得する既定のアクションがオブジェクトのアクションか、オブジェクトの子要素の 1 つであるかを指定します。このパラメーターには、 CHILDID_SELF (オブジェクトに関する情報を取得する) または子 ID (オブジェクトの子要素に関する情報を取得する) のいずれかを指定できます。

pszDefaultAction
指定したオブジェクトの既定のアクションを説明するローカライズされた文字列を受け取る BSTR のアドレス。このオブジェクトに既定のアクションがない場合は NULL 。

戻り値

成功したS_OK、失敗した場合は COM エラーコードを返します。 Windows SDK の IAccessible::get_accDefaultAction の戻す値を参照してください。

解説

この関数は、MFC の Active Accessibility サポートの一部です。

オブジェクトの既定のアクションを記述するには、 CWnd派生クラスでこの関数をオーバーライドします。

詳細については、Windows SDK の IAccessible::get_accDefaultAction に関する記事を参照してください。

`CWnd::get_accDescription`

指定されたオブジェクトの外観を記述する文字列を取得するために、フレームワークによって呼び出されます。

virtual HRESULT get_accDescription(
    VARIANT varChild,
    BSTR* pszDescription);

パラメーター

varChild
取得する説明がオブジェクトの説明か、オブジェクトの子要素の 1 つであるかを指定します。このパラメーターには、 CHILDID_SELF (オブジェクトに関する情報を取得する) または子 ID (オブジェクトの子要素に関する情報を取得する) のいずれかを指定できます。

pszDescription
指定したオブジェクトを説明するローカライズされた文字列を受け取る BSTR のアドレス。このオブジェクトの説明が使用できない場合は NULL 。

戻り値

成功した S_OK 、失敗した場合は COM エラーコードを返します。 Windows SDK のIAccessible::get_accDescriptionの「戻す値」を参照してください。

解説

この関数は、MFC の Active Accessibility サポートの一部です。

オブジェクトを記述するには、 CWnd派生クラスでこの関数をオーバーライドします。基本クラスのバージョンを呼び出し、説明を追加します。

詳細については、Windows SDK の IAccessible::get_accDescription に関する記事を参照してください。

`CWnd::get_accFocus`

キーボードフォーカスを保持するオブジェクトを取得するために、フレームワークによって呼び出されます。

virtual HRESULT get_accFocus(VARIANT* pvarChild);

パラメーター

pvarChild
フォーカスがあるオブジェクトに関する情報を受け取ります。 Windows SDK のIAccessible::get_accFocusのpvarIDを参照してください。

戻り値

成功した S_OK 、失敗した場合は COM エラーコードを返します。 Windows SDK のIAccessible::get_accFocusの「戻す値」を参照してください。

解説

この関数は、MFC の Active Accessibility サポートの一部です。

詳細については、Windows SDK の IAccessible::get_accFocus に関する記事を参照してください。

`CWnd::get_accHelp`

オブジェクトの Help プロパティ文字列を取得するためにフレームワークによって呼び出されます。

virtual HRESULT get_accHelp(
    VARIANT varChild,
    BSTR* pszHelp);

パラメーター

varChild
取得するヘルプ情報がオブジェクトのヘルプ情報か、オブジェクトの子要素の 1 つであるかを指定します。このパラメーターには、 CHILDID_SELF (オブジェクトに関する情報を取得する) または子 ID (オブジェクトの子要素に関する情報を取得する) のいずれかを指定できます。

pszHelp
指定したオブジェクトのヘルプ情報を含むローカライズされた文字列を受け取る BSTR のアドレス。ヘルプ情報が使用できない場合は NULL 。

戻り値

成功した S_OK 、失敗した場合は COM エラーコードを返します。 Windows SDK のIAccessible::get_accHelpの「戻す値」を参照してください。

解説

この関数は、MFC の Active Accessibility サポートの一部です。

オブジェクトのヘルプテキストを提供するには、 CWnd派生クラスでこの関数をオーバーライドします。

詳細については、Windows SDK の IAccessible::get_accHelp に関する記事を参照してください。

`CWnd::get_accHelpTopic`

指定したオブジェクトに関連付けられている WinHelp ファイルの完全なパスと、そのファイル内の適切なトピックの識別子を取得するために、フレームワークによって呼び出されます。

virtual HRESULT get_accHelpTopic(
    BSTR* pszHelpFile,
    VARIANT varChild,
    long* pidTopic);

パラメーター

pszHelpFile
指定したオブジェクトに関連付けられたWinHelp ファイルの完全なパスを受け取るBSTRのアドレス (存在する場合)。

varChild
取得するヘルプトピックがオブジェクトのヘルプトピックか、オブジェクトの子要素の 1 つであるかを指定します。このパラメーターには、 CHILDID_SELF (オブジェクトのヘルプトピックを取得する場合) または子 ID (オブジェクトの子要素の 1 つについてヘルプトピックを取得する場合) のいずれかを指定できます。

pidTopic
指定したオブジェクトに関連付けられているヘルプファイルトピックを識別します。 Windows SDK のIAccessible::get_accHelpTopicのpidTopicを参照してください。

戻り値

成功した S_OK 、失敗した場合は COM エラーコードを返します。 Windows SDK のIAccessible::get_accHelpTopicの「戻す値」を参照してください。

解説

この関数は、MFC の Active Accessibility サポートの一部です。

オブジェクトに関するヘルプ情報を提供するには、 CWnd派生クラスでこの関数をオーバーライドします。

詳細については、Windows SDK の IAccessible::get_accHelpTopic に関する記事を参照してください。

`CWnd::get_accKeyboardShortcut`

指定されたオブジェクトのショートカットキーまたはアクセスキーを取得するために、フレームワークによって呼び出されます。

virtual HRESULT get_accKeyboardShortcut(
    VARIANT varChild,
    BSTR* pszKeyboardShortcut);

パラメーター

varChild
取得するキーボードショートカットがオブジェクトのキーボードショートカットか、オブジェクトの子要素の 1 つであるかを指定します。このパラメーターには、 CHILDID_SELF (オブジェクトに関する情報を取得する) または子 ID (オブジェクトの子要素に関する情報を取得する) のいずれかを指定できます。

pszKeyboardShortcut
キーボードショートカットを識別するローカライズされた文字列を受け取る BSTR のアドレス。指定したオブジェクトにキーボードショートカットが関連付けられていない場合は NULL 。

戻り値

成功した S_OK 、失敗した場合は COM エラーコードを返します。 Windows SDK のIAccessible::get_accKeyboardShortcutの「戻す値」を参照してください。

解説

この関数は、MFC の Active Accessibility サポートの一部です。

オブジェクトのキーボードショートカットを識別するには、 CWnd派生クラスでこの関数をオーバーライドします。

詳細については、Windows SDK の IAccessible::get_accKeyboardShortcut に関する記事を参照してください。

`CWnd::get_accName`

指定されたオブジェクトの名前を取得するために、フレームワークによって呼び出されます。

virtual HRESULT get_accName(
    VARIANT varChild,
    BSTR* pszName);

パラメーター

varChild
取得する名前がオブジェクトの名前か、オブジェクトの子要素のいずれかであるかを指定します。このパラメーターには、 CHILDID_SELF (オブジェクトに関する情報を取得する) または子 ID (オブジェクトの子要素に関する情報を取得する) のいずれかを指定できます。

pszName
指定したオブジェクトの名前を含む文字列を受け取る BSTR のアドレス。

戻り値

成功した S_OK 、失敗した場合は COM エラーコードを返します。 Windows SDK のIAccessible::get_accNameの「戻す値」を参照してください。

解説

この関数は、MFC の Active Accessibility サポートの一部です。

CWnd派生クラスでこの関数をオーバーライドして、オブジェクトの名前を返します。

詳細については、Windows SDK の IAccessible::get_accName に関する記事を参照してください。

`CWnd::get_accParent`

オブジェクトの親の IDispatch インターフェイスを取得するために、フレームワークによって呼び出されます。

virtual HRESULT get_accParent(IDispatch** ppdispParent);

パラメーター

ppdispParent
親オブジェクトの IDispatch インターフェイスのアドレスを受け取ります。この変数は、親が存在しない場合、または子がその親にアクセスできない場合に NULL に設定されます。

戻り値

成功した場合は S_OK を返し、失敗した場合は COM エラーコードを返します。 Windows SDK のIAccessible::get_accParentの「戻す値」を参照してください。

解説

この関数は、MFC の Active Accessibility サポートの一部です。

ほとんどの場合、この関数をオーバーライドする必要はありません。

詳細については、Windows SDK の IAccessible::get_accParent に関する記事を参照してください。

`CWnd::get_accRole`

指定されたオブジェクトの役割を記述する情報を取得するために、フレームワークによって呼び出されます。

virtual HRESULT get_accRole(
    VARIANT varChild,
    VARIANT* pvarRole);

パラメーター

varChild
取得するロール情報がオブジェクトの情報か、オブジェクトの子要素の 1 つであるかを指定します。このパラメーターには、 CHILDID_SELF (オブジェクトに関する情報を取得する) または子 ID (オブジェクトの子要素に関する情報を取得する) のいずれかを指定できます。

pvarRole
ロール情報を受け取ります。 Windows SDK のIAccessible::get_accRoleのpvarRoleを参照してください。

戻り値

成功した S_OK 、失敗した場合は COM エラーコードを返します。 Windows SDK のIAccessible::get_accRoleの「戻す値」を参照してください。

解説

この関数は、MFC の Active Accessibility サポートの一部です。

詳細については、Windows SDK の IAccessible::get_accRole に関する記事を参照してください。

`CWnd::get_accSelection`

このオブジェクトの選択されている子を取得するために、フレームワークによって呼び出されます。

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

パラメーター

pvarChildren
選択されている子に関する情報を受け取ります。 Windows SDK のIAccessible::get_accSelectionのpvarChildrenを参照してください。

戻り値

成功したS_OK、失敗した場合は COM エラーコードを返します。 Windows SDK のIAccessible::get_accSelectionの「戻す値」を参照してください。

解説

この関数は、MFC の Active Accessibility サポートの一部です。

詳細については、Windows SDK の IAccessible::get_accSelection に関する記事を参照してください。

`CWnd::get_accState`

指定されたオブジェクトの現在の状態を取得するために、フレームワークによって呼び出されます。

virtual HRESULT get_accState(
    VARIANT varChild,
    VARIANT* pvarState);

パラメーター

varChild
取得する状態情報がオブジェクトの状態情報か、オブジェクトの子要素の 1 つであるかを指定します。このパラメーターには、 CHILDID_SELF (オブジェクトに関する情報を取得する) または子 ID (オブジェクトの子要素に関する情報を取得する) のいずれかを指定できます。

pvarState
オブジェクトの状態に関する情報を受け取ります。 Windows SDK のIAccessible::get_accStateのpvarStateを参照してください。

戻り値

成功した S_OK 、失敗した場合は COM エラーコードを返します。 Windows SDK のIAccessible::get_accStateの「戻す値」を参照してください。

解説

この関数は、MFC の Active Accessibility サポートの一部です。

詳細については、Windows SDK の IAccessible::get_accState に関する記事を参照してください。

`CWnd::get_accValue`

指定されたオブジェクトの値を取得するために、フレームワークによって呼び出されます。

virtual HRESULT get_accValue(
    VARIANT varChild,
    BSTR* pszValue);

パラメーター

varChild
取得する値情報がオブジェクトの情報か、オブジェクトの子要素の 1 つであるかを指定します。このパラメーターには、 CHILDID_SELF (オブジェクトに関する情報を取得する) または子 ID (オブジェクトの子要素に関する情報を取得する) のいずれかを指定できます。

pszValue
オブジェクトの現在の値を含むローカライズされた文字列を受け取る BSTR のアドレス。

戻り値

成功した S_OK 、失敗した場合は COM エラーコードを返します。 Windows SDK のIAccessible::get_accValueの「戻す値」を参照してください。

解説

この関数は、MFC の Active Accessibility サポートの一部です。

詳細については、Windows SDK の IAccessible::get_accValue に関する記事を参照してください。

`CWnd::GetActiveWindow`

アクティブウィンドウへのポインターを取得します。

static CWnd* PASCAL GetActiveWindow();

戻り値

アクティブなウィンドウ。呼び出し時にウィンドウがアクティブでなかった場合は NULL 。ポインターは一時的なものであり、後で使用するために格納しないでください。

解説

アクティブウィンドウは、現在の入力フォーカスを持つウィンドウか、 SetActiveWindow メンバー関数によって明示的にアクティブになっているウィンドウです。

`CWnd::GetAncestor`

指定したウィンドウの祖先ウィンドウオブジェクトを取得します。

CWnd* GetAncestor(UINT gaFlags) const;

パラメーター

gaFlags
取得する先祖を指定します。使用可能な値の完全な一覧については、 GetAncestorを参照してください。

戻り値

関数が成功した場合、戻り値は先祖ウィンドウオブジェクトへのポインターです。関数が失敗した場合、戻り値は NULL。

解説

このメンバー関数は、Windows SDK で説明されているように、関数 GetAncestorの機能をエミュレートします。

`CWnd::GetCapture`

マウスキャプチャがあるウィンドウを取得します。

static CWnd* PASCAL GetCapture();

戻り値

マウスキャプチャがあるウィンドウを識別します。ウィンドウにマウスキャプチャがない場合は NULL 。

戻り値は一時的なものであり、後で使用するために格納しないでください。

解説

特定の時点でマウスキャプチャを行うウィンドウは 1 つだけです。 SetCapture メンバー関数が呼び出されると、ウィンドウはマウスキャプチャを受け取ります。このウィンドウは、カーソルが境界線内にあるかどうかにかかわらず、マウス入力を受け取ります。

`CWnd::GetCaretPos`

キャレットの現在位置のクライアント座標を取得し、 CPointとして返します。

static CPoint PASCAL GetCaretPos();

戻り値

CPoint キャレットの位置の座標を含むオブジェクト。

解説

キャレット位置は、 CWnd ウィンドウのクライアント座標で指定されます。

`CWnd::GetCheckedRadioButton`

指定したグループ内の現在チェックされているラジオボタンの ID を取得します。

int GetCheckedRadioButton(
    int nIDFirstButton,
    int nIDLastButton);

パラメーター

nIDFirstButton
グループ内の最初のラジオボタンの整数識別子を指定します。

nIDLastButton
グループ内の最後のラジオボタンの整数識別子を指定します。

戻り値

チェックされたラジオボタンの ID。何も選択されていない場合は 0。

`CWnd::GetClientRect`

CWnd クライアント領域のクライアント座標を、lpRectが指す構造体にコピーします。

void GetClientRect(LPRECT lpRect) const;

パラメーター

lpRect
クライアント座標を受け取る RECT 構造体または CRect オブジェクトを指します。 leftとtopのメンバーは 0 になります。 rightメンバーとbottom メンバーには、ウィンドウの幅と高さが含まれます。

解説

クライアント座標で、クライアント領域の左上隅と右下隅を指定します。クライアント座標は CWnd クライアント領域の左上隅を基準とするため、左上隅の座標は (0,0) になります。

例

CWnd::IsIconic の例を参照してください。

`CWnd::GetClipboardOwner`

クリップボードの現在の所有者を取得します。

static CWnd* PASCAL GetClipboardOwner();

戻り値

関数が成功した場合にクリップボードを所有するウィンドウを識別します。それ以外の場合は、NULL となります。

返されるポインターは一時的な場合があり、後で使用するために格納しないでください。

解説

クリップボードには、現在所有されていない場合でもデータを含めることができます。

`CWnd::GetClipboardViewer`

クリップボードビューアーチェーンの最初のウィンドウを取得します。

static CWnd* PASCAL GetClipboardViewer();

戻り値

成功した場合にクリップボードを表示する現在のウィンドウを識別します。それ以外の場合 NULL (ビューアーがない場合など)。

返されるポインターは一時的な場合があり、後で使用するために格納しないでください。

`CWnd::GetControlUnknown`

このメンバー関数を呼び出して、不明な OLE コントロールへのポインターを取得します。

LPUNKNOWN GetControlUnknown();

戻り値

このCWnd オブジェクトによって表される OLE コントロールのIUnknown インターフェイスへのポインター。このオブジェクトが OLE コントロールを表さない場合、戻り値は NULL。

解説

この IUnknown ポインターを解放しないでください。通常は、コントロールの特定のインターフェイスを取得するために使用します。

GetControlUnknownによって返されるインターフェイスポインターは参照カウントされません。以前にIUnknown::AddRefを呼び出していない限り、ポインターでIUnknown::Releaseを呼び出さないでください。

例

// The following code fragment is taken from CMyDlg::OnInitDialog
// CMyDlg is a CDialog-derived class.

// IDC_MSACALCTRL1 is the ID of the Calendar control OCX embedded
// on this dialog
CWnd *pWndCal = GetDlgItem(IDC_MSACALCTRL1);

// Use the IUnknown of the control
LPUNKNOWN pUnk = pWndCal->GetControlUnknown();

// From there get the IDispatch interface of control
LPDISPATCH pDisp = NULL;
pUnk->QueryInterface(IID_IDispatch, (LPVOID*)&pDisp);

// use IDispatch method to invoke the control's functionality

`CWnd::GetCurrentMessage`

ウィンドウが現在処理しているメッセージへのポインターを返します。 OnMessage メッセージハンドラーメンバー関数内でのみ呼び出す必要があります。

static const MSG* PASCAL GetCurrentMessage();

戻り値

ウィンドウが現在処理中のメッセージを含む MSG 構造体へのポインターを返します。 OnMessage ハンドラー内でのみ呼び出す必要があります。

例

CMDIFrameWnd::MDICascade の例を参照してください。

`CWnd::GetDC`

CWndに指定されたクラススタイルに応じて、クライアント領域の共通、クラス、またはプライベートデバイスコンテキストへのポインターを取得します。

CDC* GetDC();

戻り値

成功した場合は、 CWnd クライアント領域のデバイスコンテキストを識別します。それ以外の場合、戻り値は NULL。ポインターは一時的なものであり、後で使用するために格納しないでください。

解説

一般的なデバイスコンテキストの場合、 GetDC は取得されるたびにコンテキストに既定の属性を割り当てます。クラスおよびプライベートコンテキストの場合、 GetDC は以前に割り当てられた属性は変更されません。デバイスコンテキストは、クライアント領域に描画する後続のグラフィックスデバイスインターフェイス (GDI) 関数で使用できます。

デバイスコンテキストがウィンドウクラスに属していない限り、描画後にコンテキストを解放するには、 ReleaseDC メンバー関数を呼び出す必要があります。

CWnd クラスに属するデバイスコンテキストは、CS_CLASSDC、CS_OWNDC、またはCS_PARENTDCがクラスの登録時にWNDCLASS構造体のスタイルとして指定された場合、GetDC メンバー関数によって返されます。

`CWnd::GetDCEx`

CWnd ウィンドウのデバイスコンテキストのハンドルを取得します。

CDC* GetDCEx(
    CRgn* prgnClip,
    DWORD flags);

パラメーター

prgnClip
クライアントウィンドウの表示領域と組み合わせることができるクリッピング領域を識別します。

flags
次のいずれかのプリセット値を設定できます。

DCX_CACHEOWNDCまたはCLASSDC ウィンドウではなく、キャッシュからデバイスコンテキストを返します。 CS_OWNDC と CS_CLASSDC がオーバーライドされます。
DCX_CLIPCHILDRENCWnd ウィンドウの下にあるすべての子ウィンドウの表示領域を除外します。
DCX_CLIPSIBLINGSCWnd ウィンドウの上にあるすべての兄弟ウィンドウの表示領域を除外します。
DCX_EXCLUDERGNprgnClipによって識別されるクリッピング領域を、返されたデバイスコンテキストの表示領域から除外します。
DCX_INTERSECTRGN 返されたデバイスコンテキストの可視領域内の prgnClip によって識別されるクリッピング領域と交差します。
DCX_LOCKWINDOWUPDATE このウィンドウを除外する LockWindowUpdate 呼び出しが有効な場合でも描画を許可します。この値は、追跡中の描画に使用されます。
DCX_PARENTCLIP 親ウィンドウの表示領域を使用し、親ウィンドウの WS_CLIPCHILDREN ビットと WS_PARENTDC スタイルビットを無視します。この値は、デバイスコンテキストの配信元を CWnd ウィンドウの左上隅に設定します。
DCX_WINDOW クライアントの四角形ではなく、ウィンドウの四角形に対応するデバイスコンテキストを返します。

戻り値

関数が成功した場合の、指定されたウィンドウのデバイスコンテキスト。それ以外の場合は NULL。

解説

デバイスコンテキストは、後続の GDI 関数でクライアント領域に描画するために使用できます。

この関数は、 GetDC 関数の拡張機能であり、ウィンドウのデバイスコンテキストをクリップする方法と方法の詳細をアプリケーションで制御できます。

デバイスコンテキストがウィンドウクラスに属していない限り、描画後にコンテキストを解放するには、 ReleaseDC 関数を呼び出す必要があります。一般的なデバイスコンテキストはいつでも 5 つしか使用できないので、デバイスコンテキストを解放できないと、他のアプリケーションがデバイスコンテキストにアクセスできなくなる可能性があります。

キャッシュされたデバイスコンテキストを取得するには、アプリケーションで DCX_CACHEを指定する必要があります。 DCX_CACHEが指定されておらず、ウィンドウが CS_OWNDC でも CS_CLASSDCでもない場合、この関数は NULLを返します。

CS_CLASSDC、CS_OWNDC、またはCS_PARENTDCスタイルがクラスの登録時にWNDCLASS構造体で指定された場合、特殊な特性を持つデバイスコンテキストがGetDCEx関数によって返されます。

これらの特性の詳細については、Windows SDK の WNDCLASS 構造の説明を参照してください。

`CWnd::GetDCRenderTarget`

CWnd ウィンドウのデバイスコンテキスト (DC) レンダーターゲットを取得します。

CDCRenderTarget* GetDCRenderTarget();

戻り値

関数が成功した場合の、指定されたウィンドウのデバイスコンテキストレンダーターゲット。それ以外の場合は NULL。

解説

`CWnd::GetDescendantWindow`

このメンバー関数を呼び出して、指定された ID で指定された子孫ウィンドウを検索します。

CWnd* GetDescendantWindow(
    int nID,
    BOOL bOnlyPerm = FALSE) const;

パラメーター

nID
取得するコントロールまたは子ウィンドウの識別子を指定します。

bOnlyPerm
返されるウィンドウを一時的に使用できるかどうかを指定します。 TRUE場合は、永続的ウィンドウのみを返すことができます。FALSE場合、関数は一時ウィンドウを返すことができます。一時ウィンドウの詳細については、「テクニカルノート 3を参照してください。

戻り値

CWnd オブジェクトへのポインター。子ウィンドウが見つからない場合はNULL。

解説

このメンバー関数は、直下の子ウィンドウだけでなく、子ウィンドウのツリー全体を検索します。

`CWnd::GetDesktopWindow`

Windows デスクトップウィンドウを返します。

static CWnd* PASCAL GetDesktopWindow();

戻り値

Windows デスクトップウィンドウを識別します。このポインターは一時的な場合があり、後で使用するために格納しないでください。

解説

デスクトップウィンドウは画面全体を覆い、すべてのアイコンとその他のウィンドウが描画される領域です。

`CWnd::GetDlgCtrlID`

ダイアログボックス内のコントロールの値だけでなく、任意の子ウィンドウのウィンドウまたはコントロール ID 値を返します。

int GetDlgCtrlID() const;

戻り値

関数が成功した場合の CWnd 子ウィンドウの数値識別子。それ以外の場合は 0。

解説

最上位のウィンドウには ID 値がないため、 CWnd が最上位ウィンドウの場合、この関数の戻り値は無効です。

例

CWnd::OnCtlColor の例を参照してください。

`CWnd::GetDlgItem`

ダイアログボックスまたはその他のウィンドウで、指定したコントロールまたは子ウィンドウへのポインターを取得します。

CWnd* GetDlgItem(int nID) const;

void GetDlgItem(
    int nID,
    HWND* phWnd) const;

パラメーター

nID
取得するコントロールまたは子ウィンドウの識別子を指定します。

phWnd
子ウィンドウへのポインター。

戻り値

指定されたコントロールまたは子ウィンドウへのポインター。 nID パラメーターによって指定された整数 ID を持つコントロールが存在しない場合、値はNULL。

返されるポインターは一時的な場合があり、後で使用するために格納しないでください。

解説

通常、返されるポインターは、 nIDによって識別されるコントロールの型にキャストされます。

例

// uses GetDlgItem to return a pointer to a user interface control
CEdit *pBoxOne;
pBoxOne = (CEdit*)GetDlgItem(IDC_MYEDIT);
GotoDlgCtrl(pBoxOne);

`CWnd::GetDlgItemInt`

nIDによって識別されるコントロールのテキストを取得します。

UINT GetDlgItemInt(
    int nID,
    BOOL* lpTrans = NULL,
    BOOL bSigned = TRUE) const;

パラメーター

nID
変換するダイアログボックスコントロールの整数識別子を指定します。

lpTrans
変換されたフラグを受け取るブール変数を指します。

bSigned
取得する値に署名するかどうかを指定します。

戻り値

ダイアログボックス項目テキストの変換された値を指定します。 0 は有効な戻り値であるため、 lpTrans を使用してエラーを検出する必要があります。符号付き戻り値が必要な場合は、 int 型としてキャストします。

変換された数値が INT_MAX (符号付き数値の場合) または UINT_MAX (符号なし) より大きい場合、関数は 0 を返します。

数値以外の文字が発生し、上記の最大値を超えるなどのエラーが発生した場合、 GetDlgItemInt は、 lpTransが指す場所に 0 をコピーします。エラーがない場合、 lpTrans は 0 以外の値を受け取ります。 lpTransがNULLされている場合、GetDlgItemIntはエラーについて警告しません。

解説

指定したダイアログボックス内の指定したコントロールのテキストを整数値に変換します。その際、テキストの先頭に余分なスペースを取り除き、10 進数を変換します。テキストの末尾に達するか、数値以外の文字が検出されると、翻訳が停止します。

bSignedがTRUEされている場合、GetDlgItemIntはテキストの先頭にマイナス記号 (-) があるかどうかを確認し、テキストを符号付きの番号に変換します。それ以外の場合は、符号なし値が作成されます。

WM_GETTEXT メッセージをコントロールに送信します。

`CWnd::GetDlgItemText`

このメンバー関数を呼び出して、ダイアログボックス内のコントロールに関連付けられているタイトルまたはテキストを取得します。

int GetDlgItemText(
    int nID,
    LPTSTR lpStr,
    int nMaxCount) const;

int GetDlgItemText(
    int nID,
    CString& rString) const;

パラメーター

nID
タイトルを取得するコントロールの整数識別子を指定します。

lpStr
コントロールのタイトルまたはテキストを受け取るバッファーをポイントします。

nMaxCount
lpStrにコピーする文字列の最大長 (文字数) を指定します。文字列が nMaxCountより長い場合は、切り捨てられます。

rString
CStringへの参照。

戻り値

バッファーにコピーされる実際の文字数を指定します。終端の null 文字は含まれません。テキストがコピーされない場合、値は 0 です。

解説

GetDlgItemTextメンバー関数は、lpStrが指す場所にテキストをコピーし、コピーしたバイト数を返します。

`CWnd::GetDSCCursor`

このメンバー関数を呼び出して、データソースコントロールの DataSource、 UserName、 Password、および SQL プロパティによって定義されている基になるカーソルへのポインターを取得します。

IUnknown* GetDSCCursor();

戻り値

データソースコントロールによって定義されているカーソルへのポインター。 MFC はポインターの AddRef の呼び出しを処理します。

解説

返されたポインターを使用して、データバインドグリッドコントロールなどの複雑なデータバインドコントロールの ICursor プロパティを設定します。データソースコントロールは、最初のバインドされたコントロールがカーソルを要求するまでアクティブになりません。これは、 GetDSCCursor の呼び出しによって明示的に発生するか、MFC バインドマネージャーによって暗黙的に発生する可能性があります。どちらの場合も、GetDSCCursorを呼び出し、返されたポインターから IUnknown へのReleaseを呼び出すことによって、データソースコントロールを強制的にアクティブにすることができます。アクティブ化すると、データソースコントロールは基になるデータソースへの接続を試みます。返されるポインターは、次のコンテキストで使用できます。

例

BOOL CMyDlg::OnInitDialog()
{
   // Find the child controls on the dialog
   HRESULT hr = E_FAIL;
   CWnd *pDSC = GetDlgItem(IDC_DATASOURCE);
   CWnd *pListWnd = GetDlgItem(IDC_DBLIST1);
   IUnknown *punkList = pListWnd->GetControlUnknown();
   IDBList *pList = NULL;

   if (NULL != punkList)
   {
      hr = punkList->QueryInterface(__uuidof(IDBList), (void **)&pList);
   }

   if (SUCCEEDED(hr))
   {
      // Tell the MFC binding manager that we are
      // binding DISPID 3 to the data-source control.
      pListWnd->BindProperty(0x3, pDSC);

      // Tell the listbox which field to expose as its bound column
      pList->put_BoundColumn(_T("ContactFirstName"));

      // Tell the listbox which cursor and column to populate its list from
      pList->put_ListField(_T("ContactFirstName"));

      IUnknown *punkCursor = pDSC->GetDSCCursor();
      if (NULL != punkCursor)
      {
         punkCursor->Release();
      }

      pList->Release();
      return TRUE;
   }

`CWnd::GetDynamicLayout`

動的レイアウトマネージャーオブジェクトへのポインターを取得します。

CMFCDynamicLayout* GetDynamicLayout();

戻り値

動的レイアウトマネージャーオブジェクトへのポインター。動的レイアウトが有効になっていない場合は NULL 。

解説

ウィンドウオブジェクトは、返されたポインターを所有し、その有効期間を管理します。そのため、ポインターはオブジェクトへのアクセスにのみ使用する必要があります。ポインターを削除したり、ポインターを永続的に格納したりしないでください。

`CWnd::GetExStyle`

ウィンドウの拡張スタイルを返します。

DWORD GetExStyle() const;

戻り値

ウィンドウの拡張スタイル。 MFC で使用される拡張ウィンドウスタイルの詳細については、「 Extended Window Styles」を参照してください。

`CWnd::GetFocus`

現在入力フォーカスがある CWnd へのポインターを取得します。

static CWnd* PASCAL GetFocus();

戻り値

現在のフォーカスがあるウィンドウへのポインター。フォーカスウィンドウがない場合は NULL 。

ポインターは一時的なものであり、後で使用するために格納しないでください。

`CWnd::GetFont`

WM_GETFONT メッセージをウィンドウに送信して、現在のフォントを取得します。

CFont* GetFont() const;

戻り値

ウィンドウの現在のフォントにアタッチされている CFont オブジェクトへのポインター。

解説

ウィンドウが WM_GETFONT メッセージを処理しない限り、このメソッドは効果がありません。 CWndから派生した多くの MFC クラスは、WM_GETFONT メッセージのメッセージハンドラーを含む定義済みのウィンドウクラスにアタッチされているため、このメッセージを処理します。このメソッドを使用するには、 CWnd から派生したクラスで、 WM_GETFONT メッセージのメソッドハンドラーを定義する必要があります。

`CWnd::GetForegroundWindow`

フォアグラウンドウィンドウ (ユーザーが現在作業しているウィンドウ) へのポインターを返します。

static CWnd* PASCAL GetForegroundWindow();

戻り値

フォアグラウンドウィンドウへのポインター。これは、一時的な CWnd オブジェクトである可能性があります。

解説

フォアグラウンドウィンドウは、トップレベルウィンドウ (フレームウィンドウまたはダイアログボックス) にのみ適用されます。

`CWnd::GetIcon`

このメンバー関数を呼び出して、大きな (32 x 32) または小さい (16 x 16) アイコンのハンドルを取得します ( bBigIconで示されます)。

HICON GetIcon(BOOL bBigIcon) const;

パラメーター

bBigIcon
TRUE場合は 32 ピクセル x 32 ピクセルのアイコンを指定し、FALSE場合は 16 ピクセル x 16 ピクセルのアイコンを指定します。

戻り値

アイコンにへのハンドル。失敗した場合は、 NULLを返します。

`CWnd::GetLastActivePopup`

CWnd が所有するポップアップウィンドウのうち、直前にアクティブだったウィンドウを調べます。

CWnd* GetLastActivePopup() const;

戻り値

最近アクティブなポップアップウィンドウを識別します。次のいずれかの条件が満たされている場合、戻り値はウィンドウ自体になります。

ウィンドウ自体は最近アクティブでした。
ウィンドウはポップアップウィンドウを所有していません。
ウィンドウは最上位レベルのウィンドウではないか、別のウィンドウによって所有されています。

ポインターは一時的なものであり、後で使用するために格納しないでください。

例

CWnd::FindWindow の例を参照してください。

`CWnd::GetLayeredWindowAttributes`

レイヤードウィンドウの不透明度および透明度のカラーキーを取得します。

BOOL GetLayeredWindowAttributes(
    COLORREF* pcrKey,
    BYTE* pbAlpha,
    DWORD* pdwFlags) const;

パラメーター

pcrKey
レイヤーウィンドウの作成時に使用する透明度カラーキーを受け取る COLORREF 値へのポインター。ウィンドウによってこの色で塗りつぶされたすべてのピクセルは透明になります。これは、引数が必要ない場合に NULL できます。

pbAlpha
レイヤーウィンドウの不透明度を表すために使用されるアルファ値を受け取る BYTE へのポインター。 pbAlphaによって参照される変数が 0 の場合、ウィンドウは完全に透明になります。 pbAlphaによって参照される変数が 255 の場合、ウィンドウは不透明になります。これは、引数が必要ない場合に NULL できます。

pdwFlags
レイヤーフラグを受け取る DWORD へのポインター。これは、引数が必要ない場合に NULL できます。使用可能な値の完全な一覧については、 'GetLayeredWindowAttributes を参照してください。

戻り値

関数が正常終了した場合は 0 以外。それ以外の場合は 0。

解説

このメンバー関数は、Windows SDK で説明されているように、関数 GetLayeredWindowAttributesの機能をエミュレートします。

`CWnd::GetMenu`

このウィンドウのメニューへのポインターを取得します。

CMenu* GetMenu() const;

戻り値

メニューを識別します。 CWndにメニューがない場合、値はNULLされます。 CWndが子ウィンドウの場合、戻り値は未定義です。

返されるポインターは一時的な場合があり、後で使用するために格納しないでください。

解説

子ウィンドウにはメニューがないため、この関数は使用しないでください。

例

void CMainFrame::OnCwndDeletefilemenu()
{
   // This example deletes the leftmost popup menu or leftmost
   // popup menu item from the application's main window.
   CWnd *pMain = AfxGetMainWnd();

   // The main window _can_ be NULL, so this code
   // doesn't ASSERT and actually tests.
   if (pMain != NULL)
   {
      // Get the main window's menu
      CMenu *pMenu = pMain->GetMenu();

      // If there is a menu and it has items, we'll
      // delete the first one.
      if (pMenu != NULL && pMenu->GetMenuItemCount() > 0)
      {
         pMenu->DeleteMenu(0, MF_BYPOSITION);
         // force a redraw of the menu bar
         pMain->DrawMenuBar();
      }

      // No need to delete pMenu because it is an MFC
      // temporary object.
   }
}

`CWnd::GetMenuBarInfo`

指定したメニューバーに関する情報を取得します。

BOOL GetMenuBarInfo(
    LONG idObject,
    LONG idItem,
    PMENUBARINFO pmbi) const;

パラメーター

idObject
メニューオブジェクトを指定します。使用可能な値の一覧については、 GetMenuBarInfoを参照してください。

idItem
情報を取得する項目を指定します。このパラメーターが 0 の場合、関数はメニュー自体に関する情報を取得します。このパラメーターが 1 の場合、関数はメニューの最初の項目に関する情報などを取得します。

pmbi
情報を受け取る MENUBARINFO 構造体へのポインター。

戻り値

関数が正常終了した場合は 0 以外。それ以外の場合は 0。

解説

このメンバー関数は、Windows SDK で説明されているように、関数 GetMenuBarInfoの機能をエミュレートします。

`CWnd::GetNextDlgGroupItem`

ダイアログボックス内のコントロールのグループ内で、前のコントロールまたは次のコントロールを検索します。

CWnd* GetNextDlgGroupItem(
    CWnd* pWndCtl,
    BOOL bPrevious = FALSE) const;

COleControlSiteOrWnd* GetNextDlgGroupItem(
    COleControlSiteOrWnd* pCurSiteOrWnd = NULL) const;

パラメーター

pWndCtl
検索の開始点として使用するコントロールを識別します。

bPrevious
ダイアログボックスでコントロールのグループを検索する関数の方法を指定します。 TRUE場合、関数はグループ内の前のコントロールを検索します。FALSE場合は、グループ内の次のコントロールを検索します。

pCurSiteOrWnd
COleControlSiteOrWnd コントロールを識別します。 COleControlSiteOrWndの詳細については、「Remarks」を参照してください。

戻り値

メンバー関数が成功した場合は、グループ内の前または次のコントロールへのポインター。

返されるポインターは一時的な場合があり、後で使用するために格納しないでください。

解説

コントロールのグループは、 WS_GROUP スタイルで作成されたコントロールから始まり、 WS_GROUP スタイルで作成されなかった最後のコントロールで終わります。

既定では、 GetNextDlgGroupItem メンバー関数は、グループ内の次のコントロールへのポインターを返します。 pWndCtlがグループ内の最初のコントロールを識別し、bPreviousがTRUE場合、GetNextDlgGroupItemはグループ内の最後のコントロールへのポインターを返します。

Note

MFC ではウィンドウレスの ActiveX コントロール、標準の ActiveX コントロール、およびウィンドウがサポートされているため、 HWND のみがコントロールを参照するだけでは十分ではなくなりました。 COleControlSiteOrWnd オブジェクトには、次のように、ウィンドウ化された ActiveX コントロール、ウィンドウなしの ActiveX コントロール、またはウィンドウとしてオブジェクトを識別する情報が含まれています。

コントロールまたはウィンドウの種類	情報の識別
ウィンドウ化された ActiveX コントロール	`HWND`を格納し、COleControlSite オブジェクトを関連付けます。 `COleControlSiteOrWnd`の`m_hWnd` メンバーはコントロールの`HWND`に設定され、`m_pSite`メンバーはコントロールの`COleControlSite`を指します。
ウィンドウレス ActiveX コントロール	`HWND`を含まない。 `COleControlSiteOrWnd`の`m_pSite` メンバーはコントロールの`COleControlSite`を指し、`m_hWnd` メンバーは`NULL`。
標準ウィンドウ	`HWND`のみを含みます。 `COleControlSiteOrWnd`の`m_hWnd` メンバーはウィンドウの HWND に設定され、`m_pSite` メンバーは`NULL`。

`CWnd::GetNextDlgTabItem`

WS_TABSTOP スタイルで作成され、指定したコントロールの前または後に作成された最初のコントロールへのポインターを取得します。

CWnd* GetNextDlgTabItem(
    CWnd* pWndCtl,
    BOOL bPrevious = FALSE) const;

COleControlSiteOrWnd* GetNextDlgTabItem(
    COleControlSiteOrWnd* pCurSiteOrWnd,
    BOOL bPrevious) const;

パラメーター

pWndCtl
検索の開始点として使用するコントロールを識別します。

pCurSiteOrWnd
COleControlSiteOrWnd コントロールを識別します。 COleControlSiteOrWnd の詳細については、「CWnd::GetNextDlgGroupItem」を参照してください。

bPrevious
関数がダイアログボックスを検索する方法を指定します。 TRUE場合、関数はダイアログボックスで前のコントロールを検索します。FALSE場合は、次のコントロールを検索します。

戻り値

メンバー関数が成功した場合、 WS_TABSTOP スタイルを持つ前または次のコントロールへのポインター。

返されるポインターは一時的な場合があり、後で使用するために格納しないでください。

COleControlSiteOrWnd の詳細については、「CWnd::GetNextDlgGroupItem」を参照してください。

`CWnd::GetNextWindow`

ウィンドウマネージャーの一覧で次の (または前の) ウィンドウを検索します。

CWnd* GetNextWindow(UINT nFlag = GW_HWNDNEXT) const;

パラメーター

nFlag
関数が次のウィンドウまたは前のウィンドウへのポインターを返すかどうかを指定します。 GW_HWNDNEXT、ウィンドウマネージャーの一覧のCWnd オブジェクトに続くウィンドウを返すか、ウィンドウマネージャーの一覧の前のウィンドウを返すGW_HWNDPREVを指定できます。

戻り値

メンバー関数が成功した場合に、ウィンドウマネージャーの一覧の次の (または前の) ウィンドウを識別します。

返されるポインターは一時的な場合があり、後で使用するために格納しないでください。

解説

ウィンドウマネージャーの一覧には、最上位のすべてのウィンドウ、関連する子ウィンドウ、および任意の子ウィンドウの子ウィンドウのエントリが含まれています。

CWndが最上位ウィンドウの場合、関数は次の (または前の) 最上位ウィンドウを検索します。CWndが子ウィンドウの場合、関数は次の (または前の) 子ウィンドウを検索します。

`CWnd::GetOleControlSite`

指定された ActiveX コントロールのカスタムサイトを取得します。

COleControlSite* GetOleControlSite(UINT idControl) const;

パラメーター

idControl
ActiveX コントロールの ID。

`CWnd::GetOpenClipboardWindow`

現在クリップボードが開いているウィンドウのハンドルを取得します。

static CWnd* PASCAL GetOpenClipboardWindow();

戻り値

関数が成功した場合にクリップボードが開いているウィンドウのハンドル。それ以外の場合は NULL。

`CWnd::GetOwner`

ウィンドウの所有者へのポインターを取得します。

CWnd* GetOwner() const;

戻り値

CWnd オブジェクトを指すポインターです。

解説

ウィンドウに所有者がない場合は、親ウィンドウオブジェクトへのポインターが既定で返されます。所有者と所有するユーザーの関係は、いくつかの重要な側面で親子の側面と異なることを注意してください。たとえば、親を持つウィンドウは、その親ウィンドウのクライアント領域に限定されます。所有しているウィンドウは、デスクトップ上の任意の場所に描画できます。

この関数の所有権の概念は、 GetWindowの所有権の概念とは異なります。

`CWnd::GetParent`

子ウィンドウの親ウィンドウ (存在する場合) へのポインターを取得するには、この関数を呼び出します。

CWnd* GetParent() const;

戻り値

Windows SDK の GetParent の「戻り値」セクションを参照してください。

解説

GetParent関数は、直接の親へのポインターを返します (存在する場合)。これに対し、 GetParentOwner 関数は、子ウィンドウではない ( WS_CHILD スタイルを持たない) 最も近い親ウィンドウまたは所有者ウィンドウへのポインターを返します。子ウィンドウ内に子ウィンドウ GetParent があり、別の結果 GetParentOwner 返される場合。

`CWnd::GetParentFrame`

このメンバー関数を呼び出して、親フレームウィンドウを取得します。

CFrameWnd* GetParentFrame() const;

戻り値

成功した場合のフレームウィンドウへのポインター。それ以外の場合は NULL。

解説

メンバー関数は、 CFrameWnd (または派生クラス) オブジェクトが見つかるまで親チェーンを検索します。

`CWnd::GetParentOwner`

このメンバー関数を呼び出して、子ウィンドウの親ウィンドウまたは所有者ウィンドウへのポインターを取得します。

CWnd* GetParentOwner() const;

戻り値

CWnd オブジェクトを指すポインターです。 CWnd オブジェクトがハンドルにアタッチされていない場合は、一時的なCWnd オブジェクトが作成されてアタッチされます。ポインターは一時的なものであり、後で使用するために格納しないでください。

解説

GetParentOwner は、子ウィンドウではない ( WS_CHILD スタイルを持たない) 最も直接的な親ウィンドウまたは所有者ウィンドウへのポインターを返します。現在の所有者ウィンドウは、 SetOwnerで設定できます。既定では、ウィンドウの親は所有者です。

これに対し、 GetParent 関数は、子ウィンドウであるかどうかに関係なく、直接の親へのポインターを返します。子ウィンドウ内に子ウィンドウ GetParent があり、別の結果 GetParentOwner 返される場合。

`CWnd::GetProperty`

このメンバー関数を呼び出して、 dwDispIDで指定された ActiveX コントロールプロパティを取得します。

void GetProperty(
    DISPID dwDispID,
    VARTYPE vtProp,
    void* pvProp)const;

パラメーター

dwDispID
取得するプロパティを識別します。

vtProp
取得するプロパティの型を指定します。使用可能な値については、 COleDispatchDriver::InvokeHelperの「解説」セクションを参照してください。

pvProp
プロパティ値を受け取る変数のアドレス。これは、 vtPropによって指定される型と一致する必要があります。

解説

GetProperty は、 pvPropを介して値を返します。

Note

この関数は、ActiveX コントロールを表す CWnd オブジェクトでのみ呼び出す必要があります。

ActiveX コントロールコンテナーでこのメンバー関数を使用する方法の詳細については、「 ActiveX コントロールコンテナー: ActiveX コントロールコンテナーでの ActiveX コントロールのプログラミング」を参照してください。

`CWnd::GetRenderTarget`

このウィンドウに関連付けられているレンダーターゲットを取得します。

CHwndRenderTarget* GetRenderTarget();

戻り値

レンダーターゲットまたは NULLへのポインター。

`CWnd::GetSafeHwnd`

this ポインターがNULLされている場合は、m_hWndまたはNULLを返します。

HWND GetSafeHwnd() const;

戻り値

ウィンドウのウィンドウハンドルを返します。 CWndがウィンドウにアタッチされていない場合、またはNULL CWnd ポインターで使用されている場合は、NULLを返します。

例

CWnd::SubclassWindow の例を参照してください。

`CWnd::GetSafeOwner`

このメンバー関数を呼び出して、ダイアログボックスまたはその他のモーダルウィンドウに使用する所有者ウィンドウを取得します。

static CWnd* GetSafeOwner(
    CWnd* pParent = NULL,
    HWND* pWndTop = NULL);

パラメーター

pParent
親 CWnd ウィンドウへのポインター。 NULL でもかまいません。

pWndTop
現在上部にあるウィンドウへのポインター。 NULL でもかまいません。

戻り値

指定されたウィンドウの安全な所有者へのポインター。

解説

安全な所有者は、 pParentの最初の子以外の親ウィンドウです。 pParentがNULLされている場合は、スレッドのメインウィンドウ (AfxGetMainWnd 経由で取得) を使用して所有者を検索します。

Note

フレームワーク自体は、この関数を使用して、所有者が指定されていないダイアログボックスとプロパティシートの適切な所有者ウィンドウを決定します。

`CWnd::GetScrollBarCtrl`

指定した兄弟スクロールバーまたは分割ウィンドウへのポインターを取得するには、このメンバー関数を呼び出します。

virtual CScrollBar* GetScrollBarCtrl(int nBar) const;

パラメーター

nBar
スクロールバーの種類を指定します。このパラメーターは、次のいずれかの値を受け取ることができます。

SB_HORZ 水平スクロールバーの位置を取得します。
SB_VERT 垂直スクロールバーの位置を取得します。

戻り値

兄弟スクロールバーコントロール。存在しない場合は NULL 。

解説

このメンバー関数は、ウィンドウの作成時に WS_HSCROLL ビットまたは WS_VSCROLL ビットが設定されたときに作成されたスクロールバーでは動作しません。この関数の CWnd 実装は、単に NULLを返します。 CViewなどの派生クラスは、記述された機能を実装します。

`CWnd::GetScrollBarInfo`

指定されたスクロールバーの情報を取得します。

BOOL GetScrollBarInfo(
    LONG idObject,
    PSCROLLBARINFO psbi) const;

パラメーター

idObject
メニューオブジェクトを指定します。使用可能な値の一覧については、 GetScrollBarInfoを参照してください。

psbi
情報を受け取る SCROLLBARINFO 構造体へのポインター。

戻り値

関数が正常終了した場合は 0 以外。それ以外の場合は 0。

解説

このメンバー関数は、Windows SDK で説明されているように、関数 GetScrollBarInfoの機能をエミュレートします。

`CWnd::GetScrollInfo`

このメンバー関数を呼び出して、 SCROLLINFO 構造体がスクロールバーに関して保持する情報を取得します。

BOOL GetScrollInfo(
    int nBar,
    LPSCROLLINFO lpScrollInfo,
    UINT nMask = SIF_ALL);

パラメーター

nBar
スクロールバーがコントロールであるか、ウィンドウの非クライアント領域の一部であるかを指定します。非クライアント領域の一部である場合、 nBar は、スクロールバーが水平方向、垂直方向、またはその両方に配置されているかどうかを示します。次のいずれかである必要があります。

SB_CTL スクロールバーコントロールのパラメーターを取得します。 m_hWnd データメンバーは、スクロールバーコントロールのハンドルである必要があります。
SB_HORZ ウィンドウの標準水平スクロールバーのパラメーターを取得します。
SB_VERT ウィンドウの標準の垂直スクロールバーのパラメーターを取得します。

lpScrollInfo
SCROLLINFO 構造体へのポインター。この構造の詳細については、Windows SDK を参照してください。

nMask
取得するスクロールバーのパラメーターを指定します。既定値は、 SIF_PAGE、 SIF_POS、 SIF_TRACKPOS、および SIF_RANGEの組み合わせを指定します。 nMask値の詳細については、SCROLLINFOを参照してください。

戻り値

メッセージが値を取得した場合、戻り値は TRUE。それ以外の場合は、FALSE となります。

解説

GetScrollInfo を使用すると、アプリケーションは 32 ビットのスクロール位置を使用できます。

SCROLLINFO構造体には、スクロールバーに関する情報 (スクロールの最小位置と最大位置、ページサイズ、スクロールボックスの位置 (つまみ) など) が含まれます。構造体の既定値の変更の詳細については、Windows SDK の SCROLLINFO 構造に関するトピックを参照してください。

スクロールバーの位置 ( CWnd::OnHScroll および CWnd::OnVScroll を示す MFC Windows メッセージハンドラーは、16 ビットの位置データのみを提供します。 GetScrollInfo と SetScrollInfo は、32 ビットのスクロールバー位置データを提供します。したがって、アプリケーションは、CWnd::OnHScrollまたはCWnd::OnVScrollの処理中にGetScrollInfoを呼び出して、32 ビットのスクロールバー位置データを取得できます。

`CWnd::GetScrollLimit`

このメンバー関数を呼び出して、スクロールバーの最大スクロール位置を取得します。

int GetScrollLimit(int nBar);

パラメーター

nBar
スクロールバーの種類を指定します。このパラメーターは、次のいずれかの値を受け取ることができます。

SB_HORZ 水平スクロールバーのスクロール制限を取得します。
SB_VERT 垂直スクロールバーのスクロール制限を取得します。

戻り値

成功した場合のスクロールバーの最大位置を指定します。それ以外の場合は 0。

`CWnd::GetScrollPos`

スクロールバーのスクロールボックスの現在位置を取得します。

int GetScrollPos(int nBar) const;

パラメーター

nBar
調べるスクロールバーを指定します。このパラメーターは、次のいずれかの値を受け取ることができます。

SB_HORZ 水平スクロールバーの位置を取得します。
SB_VERT 垂直スクロールバーの位置を取得します。

戻り値

成功した場合にスクロールバー内のスクロールボックスの現在位置を指定します。それ以外の場合は 0。

解説

現在の位置は、現在のスクロール範囲に依存する相対値です。たとえば、スクロール範囲が 50 ~ 100 で、スクロールボックスがバーの中央にある場合、現在の位置は 75 です。

`CWnd::GetScrollRange`

指定したスクロールバーの現在の最小および最大スクロールバーの位置を、 lpMinPos および lpMaxPosで指定された場所にコピーします。

void GetScrollRange(
    int nBar,
    LPINT lpMinPos,
    LPINT lpMaxPos) const;

パラメーター

nBar
調べるスクロールバーを指定します。このパラメーターは、次のいずれかの値を受け取ることができます。

SB_HORZ 水平スクロールバーの位置を取得します。
SB_VERT 垂直スクロールバーの位置を取得します。

lpMinPos
最小位置を受け取る整数変数を指します。

lpMaxPos
最大位置を受け取る整数変数を指します。

解説

CWndにスクロールバーがない場合、GetScrollRange メンバー関数は 0 をコピーしてlpMinPosし、lpMaxPosします。

標準スクロールバーの既定の範囲は 0 ~ 100 です。スクロールバーコントロールの既定の範囲は空です (両方の値は 0 です)。

`CWnd::GetStyle`

現在のウィンドウスタイルを返します。

DWORD GetStyle() const;

戻り値

ウィンドウのスタイル。 MFC で使用されるウィンドウスタイルの詳細については、「 Window スタイル」を参照してください。

`CWnd::GetSystemMenu`

アプリケーションがコピーおよび変更のためにコントロールメニューにアクセスできるようにします。

CMenu* GetSystemMenu(BOOL bRevert) const;

パラメーター

bRevert
実行するアクションを指定します。 bRevertがFALSEされている場合、GetSystemMenuは現在使用中の [コントロール] メニューのコピーへのハンドルを返します。このコピーは、最初は [コントロール] メニューと同じですが、変更できます。 bRevertがTRUEされている場合、GetSystemMenuコントロールメニューが既定の状態にリセットされます。前の変更された可能性があるコントロールメニュー (存在する場合) は破棄されます。この場合、戻り値は未定義です。

戻り値

bRevertがFALSEされている場合は、[コントロール] メニューのコピーを識別します。 bRevertがTRUE場合、戻り値は未定義です。

返されるポインターは一時的な場合があり、後で使用するために格納しないでください。

解説

コントロールメニューの独自のコピーを作成するために GetSystemMenu を使用しないウィンドウは、標準のコントロールメニューを受け取ります。

GetSystemMenu メンバー関数によって返されるポインターは、CMenu::AppendMenu、CMenu::InsertMenu、またはCMenu::ModifyMenu関数と共に使用して、[コントロール] メニューを変更できます。

コントロールメニューには、最初は、 SC_CLOSE、 SC_MOVE、 SC_SIZEなど、さまざまな ID 値で識別される項目が含まれています。 [コントロール] メニューの項目は、 WM_SYSCOMMAND メッセージを生成します。定義済みのすべてのコントロールメニュー項目には、0xF000より大きい ID 番号があります。アプリケーションがコントロールメニューに項目を追加する場合は、F000 未満の ID 番号を使用する必要があります。

Windows では、標準の [コントロール] メニューでアイテムが自動的に使用できなくなる場合があります。 CWnd は、メニューが表示される前に送信される WM_INITMENU メッセージに応答することで、独自の選択または使用不可を実行できます。

例

// The following code fragment is taken from CMyDlg::OnInitDialog
// CMyDlg is derived from CDialog

// Add "About..." menu item to system menu.

// IDM_ABOUTBOX must be in the system command range.
ASSERT((IDM_ABOUTBOX & 0xFFF0) == IDM_ABOUTBOX);
ASSERT(IDM_ABOUTBOX < 0xF000);

CMenu *pSysMenu = GetSystemMenu(FALSE);
if (pSysMenu != NULL)
{
   CString strAboutMenu;
   strAboutMenu.LoadString(IDS_ABOUT);
   if (!strAboutMenu.IsEmpty())
   {
      pSysMenu->AppendMenu(MF_SEPARATOR);
      pSysMenu->AppendMenu(MF_STRING, IDM_ABOUTBOX, strAboutMenu);
   }
}

// Set the icon for this dialog. The framework does this automatically
// when the application's main window is not a dialog
SetIcon(m_hIcon, TRUE);  // Set big icon
SetIcon(m_hIcon, FALSE); // Set small icon

`CWnd::GetTitleBarInfo`

指定されたタイトルバーの情報を取得します。

BOOL GetTitleBarInfo(PTITLEBARINFO pti) const;

パラメーター

pti
情報を受け取る TITLEBARINFO 構造体へのポインター。

解説

このメンバー関数は、Windows SDK で説明されているように、関数 GetTitleBarInfoの機能をエミュレートします。

`CWnd::GetTopLevelFrame`

このメンバー関数を呼び出して、ウィンドウの最上位フレームウィンドウ (存在する場合) を取得します。

CFrameWnd* GetTopLevelFrame() const;

戻り値

ウィンドウの最上位フレームウィンドウを識別します。

返されるポインターは一時的な場合があり、後で使用するために格納しないでください。

解説

CWndにウィンドウがアタッチされていない場合、またはその最上位の親がCFrameWnd派生オブジェクトでない場合、この関数はNULLを返します。

`CWnd::GetTopLevelOwner`

最上位ウィンドウを取得するには、このメンバー関数を呼び出します。

CWnd* GetTopLevelOwner() const;

戻り値

最上位のウィンドウを識別します。返されるポインターは一時的な場合があり、後で使用するために格納しないでください。

解説

最上位のウィンドウは、デスクトップの子であるウィンドウです。 CWndにウィンドウがアタッチされていない場合、この関数はNULLを返します。

`CWnd::GetTopLevelParent`

このメンバー関数を呼び出して、ウィンドウの最上位の親を取得します。

CWnd* GetTopLevelParent() const;

戻り値

ウィンドウの最上位の親ウィンドウを識別します。

返されるポインターは一時的な場合があり、後で使用するために格納しないでください。

解説

GetTopLevelParent は GetTopLevelFrame と GetTopLevelOwnerに似ていますが、現在の所有者ウィンドウとして設定された値は無視されます。

`CWnd::GetTopWindow`

CWndに属する最上位の子ウィンドウを検索します。

CWnd* GetTopWindow() const;

戻り値

子ウィンドウのリンクされたリスト内の最上位の子ウィンドウ CWnd 識別します。子ウィンドウが存在しない場合、値は NULL。

返されるポインターは一時的な場合があり、後で使用するために格納しないでください。

解説

CWndに子がない場合、この関数はNULLを返します。

`CWnd::GetUpdateRect`

更新領域を完全に囲む最小の四角形の座標を取得します。

BOOL GetUpdateRect(
    LPRECT lpRect,
    BOOL bErase = FALSE);

パラメーター

lpRect
更新領域を囲む更新プログラムのクライアント座標を受け取るCRect オブジェクトまたはRECT構造体を指します。

CWnd内に更新リージョンが存在するかどうかを判断するには、このパラメーターを NULL に設定します。 lpRectがNULLの場合、更新領域が存在する場合は GetUpdateRect メンバー関数は 0 以外の値を返し、存在しない場合は 0 を返します。これにより、 WM_PAINT メッセージが無効な領域から生じたかどうかを判断する方法が提供されます。このパラメーターは、Windows バージョン 3.0 以前の NULL に設定しないでください。

bErase
更新リージョンの背景を消去するかどうかを指定します。

戻り値

更新リージョンの状態を指定します。更新領域が空でない場合、値は 0 以外です。それ以外の場合は 0。

lpRect パラメーターが NULL に設定されている場合、更新領域が存在する場合、戻り値は 0 以外の値になります。それ以外の場合は 0 です。

解説

CS_OWNDC スタイルでCWndが作成され、マッピングモードがMM_TEXTされていない場合、GetUpdateRect メンバー関数は論理座標で四角形を提供します。それ以外の場合、 GetUpdateRect はクライアント座標で四角形を提供します。更新領域がない場合、 GetUpdateRect は四角形を空に設定します (すべての座標を 0 に設定します)。

bErase パラメーターは、更新リージョンの背景GetUpdateRect消去するかどうかを指定します。 bEraseがTRUEされ、更新リージョンが空でない場合、背景は消去されます。バックグラウンドを消去するには、GetUpdateRectWM_ERASEBKGNDメッセージを送信します。

BeginPaint メンバー関数によって取得される更新四角形は、GetUpdateRect メンバー関数によって取得された四角形と同じです。

BeginPaintメンバー関数は更新リージョンを自動的に検証するため、BeginPaintの呼び出しの直後に行われたGetUpdateRectの呼び出しは空の更新領域を取得します。

`CWnd::GetUpdateRgn`

pRgnによって識別されるリージョンに更新リージョンを取得します。

int GetUpdateRgn(
    CRgn* pRgn,
    BOOL bErase = FALSE);

パラメーター

pRgn
更新リージョンを識別します。

bErase
背景を消去し、子ウィンドウの非クライアント領域を描画するかどうかを指定します。値が FALSEの場合、描画は行われません。

戻り値

結果の領域の種類を示す短整数フラグを指定します。この値は、次のいずれかを受け取ることができます。

SIMPLEREGION 領域に重複する罫線はありません。
COMPLEXREGION 領域に重複する罫線があります。
NULLREGION リージョンが空です。
ERROR リージョンは作成されませんでした。

解説

この領域の座標は、左上隅 (クライアント座標) に対する相対座標です。

BeginPaintメンバー関数は更新リージョンを自動的に検証するため、BeginPaintの呼び出しの直後に行われたGetUpdateRgnの呼び出しは空の更新領域を取得します。

`CWnd::GetWindow`

要求されたウィンドウへのポインターを返します。存在しない場合は NULL します。

CWnd* GetWindow(UINT nCmd) const;

パラメーター

*nCmd*
CWndと返されるウィンドウの間のリレーションシップを指定します。次のいずれかの値を受け取ることができます。

GW_CHILD 最初の子ウィンドウ CWnd 識別します。
GW_HWNDFIRSTCWndが子ウィンドウの場合は、最初の兄弟ウィンドウを返します。それ以外の場合は、リスト内の最初の最上位ウィンドウが返されます。
GW_HWNDLASTCWndが子ウィンドウの場合は、最後の兄弟ウィンドウを返します。それ以外の場合は、一覧の最後の最上位ウィンドウが返されます。
GW_HWNDNEXT ウィンドウマネージャーの一覧の次のウィンドウを返します。
GW_HWNDPREV ウィンドウマネージャーの一覧の前のウィンドウを返します。
GW_OWNERCWnd所有者を識別します。

戻り値

返されるポインターは一時的な場合があり、後で使用するために格納しないでください。

`CWnd::GetWindowContextHelpId`

このメンバー関数を呼び出して、ウィンドウに関連付けられているヘルプコンテキスト識別子 (存在する場合) を取得します。

DWORD GetWindowContextHelpId() const;

戻り値

ヘルプコンテキスト識別子。ウィンドウに何もない場合は 0 を返します。

`CWnd::GetWindowedChildCount`

関連付けられている子ウィンドウの数を取得するには、このメンバー関数を呼び出します。

long GetWindowedChildCount();

戻り値

CWnd オブジェクトに関連付けられている子ウィンドウの数。

`CWnd::GetWindowDC`

キャプションバー、メニュー、スクロールバーなど、ウィンドウ全体の表示コンテキストを取得します。

CDC* GetWindowDC();

戻り値

関数が成功した場合に、特定のウィンドウの表示コンテキストを識別します。それ以外の場合は NULL。

返されるポインターは一時的な場合があり、後で使用するために格納しないでください。 ReleaseDC は、 GetWindowDCへの呼び出しが成功するたびに 1 回呼び出す必要があります。

解説

コンテキストの原点はクライアント領域ではなくCWndの左上隅であるため、ウィンドウ表示コンテキストではCWndの任意の場所に描画できます。

既定の属性は、コンテキストを取得するたびに表示コンテキストに割り当てられます。以前の属性は失われます。

GetWindowDC は、 CWnd 非クライアント領域内の特殊な描画効果に使用することを目的としています。任意のウィンドウの非クライアント領域での描画はお勧めしません。

GetSystemMetrics Windows 関数を使用すると、キャプションバー、メニュー、スクロールバーなど、クライアント以外の領域のさまざまな部分の寸法を取得できます。

描画が完了したら、 ReleaseDC メンバー関数を呼び出して表示コンテキストを解放する必要があります。表示コンテキストを解放しないと、同時に開くことができるデバイスコンテキストの数に制限があるため、アプリケーションによって要求された描画に重大な影響を与えます。

`CWnd::GetWindowInfo`

ウィンドウに関する情報を取得します。

BOOL GetWindowInfo(PWINDOWINFO pwi) const;

パラメーター

pwi
WINDOWINFO 構造体へのポインター。

解説

このメンバー関数は、Windows SDK で説明されているように、関数 GetWindowInfoの機能をエミュレートします。

`CWnd::GetWindowlessChildCount`

関連付けられているウィンドウなしの子ウィンドウの数を取得します。

long GetWindowlessChildCount();

戻り値

CWnd オブジェクトに関連付けられたウィンドウなしの子ウィンドウの数。

`CWnd::GetWindowPlacement`

ウィンドウの表示状態、通常の位置 (復元された位置)、最小化された位置、および最大表示された位置を取得します。

BOOL GetWindowPlacement(WINDOWPLACEMENT* lpwndpl) const;

パラメーター

lpwndpl
表示状態と位置情報を受け取る WINDOWPLACEMENT 構造体を指します。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

この関数によって取得されるWINDOWPLACEMENT構造体のflags メンバーは常に 0 です。 CWndを最大化すると、WINDOWPLACEMENTのshowCmd メンバーがSW_SHOWMAXIMIZEDされます。ウィンドウが最小化されている場合は、 SW_SHOWMINIMIZED。それ以外の場合は SW_SHOWNORMAL 。

`CWnd::GetWindowRect`

CWnd オブジェクトの外接する四角形の寸法を、lpRectが指す構造体にコピーします。

void GetWindowRect(LPRECT lpRect) const;

パラメーター

lpRect
左上と右下隅の画面座標を受け取るCRectオブジェクトまたはRECT構造体をポイントします。

解説

寸法は、表示画面の左上隅を基準とした画面座標で指定されます。キャプション、境界線、スクロールバーの寸法 (存在する場合) が含まれます。

`CWnd::GetWindowRgn`

このメンバー関数を呼び出して、ウィンドウのウィンドウ領域を取得します。

int GetWindowRgn(HRGN hRgn)const;

パラメーター

hRgn
ウィンドウ領域へのハンドル。

戻り値

戻り値は、関数が取得する領域の型を指定します。次のいずれかの値を指定できます。

NULLREGION リージョンが空です。
SIMPLEREGION 領域は 1 つの四角形です。
COMPLEXREGION 領域は複数の四角形です。
ERROR エラーが発生しました。リージョンは影響を受けません。

解説

ウィンドウ領域は、オペレーティングシステムが描画を許可するウィンドウ内の領域を決定します。オペレーティングシステムでは、ウィンドウ領域の外部にあるウィンドウの一部は表示されません。

ウィンドウのウィンドウ領域の座標は、ウィンドウのクライアント領域ではなく、ウィンドウの左上隅を基準にしています。

ウィンドウのウィンドウ領域を設定するには、 CWnd::SetWindowRgnを呼び出します。

`CWnd::GetWindowText`

CWndキャプションタイトル (タイトルがある場合) を、lpszStringBufが指すバッファーまたはコピー先の文字列rStringにコピーします。

int GetWindowText(
    LPTSTR lpszStringBuf,
    int nMaxCount) const;

void GetWindowText(
    CString& rString) const;

パラメーター

lpszStringBuf
ウィンドウのタイトルのコピーされた文字列を受け取るバッファーを指します。

nMaxCount
バッファーにコピーする最大文字数 (終端の null 文字を含む) を指定します。文字列が nMaxCountで指定された文字数より長い場合は、切り捨てられます。

rString
ウィンドウのタイトルのコピーされた文字列を受け取る CString オブジェクト。

戻り値

コピーした文字列の長さを、終端の null 文字を含まない文字数で指定します。 CWndにキャプションがない場合、またはキャプションが空の場合は 0 です。

解説

CWnd オブジェクトがコントロールの場合、GetWindowText メンバー関数はキャプションをコピーするのではなく、コントロール内のテキストをコピーします。

このメンバー関数により、 WM_GETTEXT メッセージが CWnd オブジェクトに送信されます。

例

CWnd::SetWindowText の例を参照してください。

`CWnd::GetWindowTextLength`

CWnd オブジェクトキャプションタイトルの長さを返します。

int GetWindowTextLength() const;

戻り値

null 終端文字を含まない文字でテキストの長さを指定します。このようなテキストが存在しない場合、値は 0 です。

解説

CWndがコントロールの場合、GetWindowTextLength メンバー関数はキャプションではなく、コントロール内のテキストの長さを返します。

このメンバー関数により、 WM_GETTEXTLENGTH メッセージが CWnd オブジェクトに送信されます。

例

CWnd::SetWindowText の例を参照してください。

`CWnd::HideCaret`

ディスプレイ画面からキャレットを削除して非表示にします。

void HideCaret();

解説

キャレットは表示されなくなりましたが、 ShowCaret メンバー関数を使用して再び表示できます。キャレットを非表示にしても、現在の図形は破棄されません。

非表示は累積的です。 HideCaretが 5 回連続して呼び出された場合、キャレットが表示される前に、ShowCaret メンバー関数を 5 回呼び出す必要があります。

`CWnd::HiliteMenuItem`

最上位 (メニューバー) メニュー項目から強調表示を強調表示または削除します。

BOOL HiliteMenuItem(
    CMenu* pMenu,
    UINT nIDHiliteItem,
    UINT nHilite);

パラメーター

pMenu
強調表示する項目を含む最上位メニューを識別します。

nIDHiliteItem
nHilite パラメーターの値に応じて、強調表示するメニュー項目を指定します。

nHilite
メニュー項目を強調表示するか、強調表示を削除するかを指定します。 MF_BYCOMMANDまたはMF_BYPOSITIONとMF_HILITEまたはMF_UNHILITEの組み合わせにすることができます。値は、ビットごとの OR 演算子を使用して結合できます。これらの値には次の意味があります。

MF_BYCOMMANDnIDHiliteItemをメニュー項目 ID (既定の解釈) として解釈します。
MF_BYPOSITIONnIDHiliteItemをメニュー項目の 0 から始まるオフセットとして解釈します。
MF_HILITE アイテムを強調表示します。この値が指定されていない場合、強調表示は項目から削除されます。
MF_UNHILITE アイテムから強調表示を削除します。

戻り値

メニュー項目が強調表示されたかどうかを指定します。項目が強調表示されている場合は 0 以外。それ以外の場合は 0。

解説

MF_HILITEフラグとMF_UNHILITE フラグは、このメンバー関数でのみ使用できます。CMenu::ModifyMenu メンバー関数では使用できません。

`CWnd::HtmlHelp`

このメンバー関数を呼び出して、HTMLHelp アプリケーションを呼び出します。

virtual void HtmlHelp(
    DWORD_PTR dwData,
    UINT nCmd = 0x000F);

パラメーター

dwData
追加のデータを指定します。使用される値は、 nCmd パラメーターの値によって異なります。

nCmd
要求されるヘルプの種類を指定します。使用可能な値の一覧と、 dwData パラメーターへの影響については、Windows SDK の HTML ヘルプ API リファレンスで説明されている uCommand パラメーターを参照してください。

解説

詳細については、「 CWinApp::HtmlHelp 」を参照してください。

`CWnd::InitDynamicLayout`

ウィンドウの動的レイアウトを初期化するために、フレームワークによって呼び出されます。

void InitDynamicLayout();

解説

このメソッドを直接呼び出さないでください。

`CWnd::Invalidate`

CWndのクライアント領域全体を無効にします。

void Invalidate(BOOL bErase = TRUE);

パラメーター

bErase
更新領域内の背景を消去するかどうかを指定します。

解説

クライアント領域は、次の WM_PAINT メッセージが発生したときに描画対象としてマークされます。 WM_PAINT メッセージがValidateRectまたはメンバー関数によって発生する前に、リージョンValidateRgn検証することもできます。

bErase パラメーターは、更新領域の処理時に、更新領域内の背景を消去するかどうかを指定します。 bEraseがTRUEの場合、BeginPaintメンバー関数が呼び出されたときに背景が消去されます。bEraseがFALSEされている場合、背景は変更されません。更新リージョンの任意の部分に対して bErase が TRUE されている場合、特定の部分だけでなく、リージョン全体の背景が消去されます。

windows は、CWnd更新リージョンが空ではなく、そのウィンドウのアプリケーションキューに他のメッセージがない場合に常に、WM_PAINT メッセージを送信します。

例

CWnd::UpdateWindow の例を参照してください。

`CWnd::InvalidateRect`

その四角形を CWnd 更新領域に追加して、指定された四角形内のクライアント領域を無効にします。

void InvalidateRect(
    LPCRECT lpRect,
    BOOL bErase = TRUE);

パラメーター

lpRect
更新領域に追加する四角形 (クライアント座標) を含むCRect オブジェクトまたはRECT構造体を指します。 lpRectがNULL場合、クライアント領域全体がリージョンに追加されます。

bErase
更新領域内の背景を消去するかどうかを指定します。

解説

無効になった四角形は、更新領域内の他のすべての領域と共に、次の WM_PAINT メッセージが送信されたときに描画対象としてマークされます。無効化された領域は、次の WM_PAINT 呼び出しが発生したときにリージョンが処理されるまで、または ValidateRect または ValidateRgn メンバー関数によってリージョンが検証されるまで、更新リージョン蓄積されます。

`CWnd::InvalidateRgn`

特定のリージョン内のクライアント領域を、 CWndの現在の更新リージョンに追加して無効にします。

void InvalidateRgn(
    CRgn* pRgn,
    BOOL bErase = TRUE);

パラメーター

pRgn
更新リージョンに追加するリージョンを識別する CRgn オブジェクトへのポインター。リージョンにはクライアント座標があると見なされます。このパラメーターが NULL場合、クライアント領域全体が更新リージョンに追加されます。

bErase
更新領域内の背景を消去するかどうかを指定します。

解説

無効化されたリージョンと更新リージョン内の他のすべての領域は、次に WM_PAINT メッセージが送信されたときに描画対象としてマークされます。無効な領域は、 WM_PAINT メッセージが次に送信されるときにリージョンが処理されるまで、または ValidateRect または ValidateRgn メンバー関数によってリージョンが検証されるまで、更新リージョンに蓄積されます。

指定されたリージョンは、いずれかのリージョン関数によって以前に作成されている必要があります。

`CWnd::InvokeHelper`

このメンバー関数を呼び出して、wFlagsで指定されたコンテキストで、dwDispIDで指定された ActiveX Control メソッドまたはプロパティを呼び出します。

void AFX_CDECL InvokeHelper(
    DISPID dwDispID,
    WORD wFlags,
    VARTYPE vtRet,
    void* pvRet,
    const BYTE* pbParamInfo,
    ... );

パラメーター

dwDispID
呼び出されるメソッドまたはプロパティを識別します。

wFlags
IDispatch::Invokeの呼び出しのコンテキストを記述するフラグ。

vtRet
戻り値の型を指定します。使用可能な値については、 COleDispatchDriver::InvokeHelperの「解説」セクションを参照してください。

pvRet
プロパティ値または戻り値を受け取る変数のアドレス。これは、 vtRetによって指定される型と一致する必要があります。

pbParamInfo
pbParamInfoに従うパラメーターの型を指定するバイトの null で終わる文字列へのポインター。使用可能な値については、 COleDispatchDriver::InvokeHelperの「解説」セクションを参照してください。

...
pbParamInfoで指定された型のパラメーターの変数リスト。

解説

pbParamInfo パラメーターは、メソッドまたはプロパティに渡されるパラメーターの型を指定します。引数の変数リストは、構文宣言の ... によって表されます。

この関数は、パラメーターを VARIANTARG 値に変換し、ActiveX コントロールで IDispatch::Invoke メソッドを呼び出します。 IDispatch::Invoke の呼び出しに失敗すると、この関数は、例外をスローします。 IDispatch::Invokeによって返されるSCODE (状態コード) がDISP_E_EXCEPTION場合、この関数はCOleException オブジェクトをスローし、それ以外の場合はCOleDispatchExceptionをスローします。

Note

この関数は、ActiveX コントロールを表す CWnd オブジェクトでのみ呼び出す必要があります。

`CWnd::IsChild`

pWndによって指定されたウィンドウが子ウィンドウであるか、CWndの他の直接の子孫であるかを示します。

BOOL IsChild(const CWnd* pWnd) const;

パラメーター

pWnd
テストするウィンドウを識別します。

戻り値

関数の結果を指定します。 pWndで識別されるウィンドウが CWnd の子ウィンドウの場合、値は 0 以外の値です。それ以外の場合は 0 です。

解説

子ウィンドウは、CWnd オブジェクトが元のポップアップウィンドウから子ウィンドウに至る親ウィンドウのチェーン内にある場合、CWndの直接の子孫です。

`CWnd::IsD2DSupportEnabled`

D2D サポートが有効かどうかを判断します。

BOOL IsD2DSupportEnabled();

戻り値

TRUE 機能が有効になっている場合。それ以外の場合は FALSE。

`CWnd::IsDialogMessage`

このメンバー関数を呼び出して、指定されたメッセージがモードレスダイアログボックスを対象としているかどうかを判断します。その場合、この関数はメッセージを処理します。

BOOL IsDialogMessage(LPMSG lpMsg);

パラメーター

lpMsg
チェックするメッセージを含む MSG 構造体を指します。

戻り値

メンバー関数が特定のメッセージを処理したかどうかを指定します。メッセージが処理されている場合は 0 以外です。それ以外の場合は 0。戻り値が 0 の場合は、基底クラスの CWnd::PreTranslateMessage メンバー関数を呼び出してメッセージを処理します。 CWnd::PreTranslateMessage メンバー関数のオーバーライドでは、コードは次のようになります。

BOOL CAboutDlg::PreTranslateMessage(MSG *pMsg)
{
   if (IsDialogMessage(pMsg))
      return TRUE;
   else
      return CDialog::PreTranslateMessage(pMsg);
}

解説

IsDialogMessage関数は、メッセージを処理するときに、キーボードメッセージをチェックし、対応するダイアログボックスの選択コマンドに変換します。たとえば、TAB キーは次のコントロールまたはコントロールのグループを選択し、下方向キーはグループ内の次のコントロールを選択します。

IsDialogMessageによって処理されたメッセージは、既に処理されているため、TranslateMessageまたは windows 関数DispatchMessage渡す必要があります。

`CWnd::IsDlgButtonChecked`

ボタンコントロールの横にチェックマークがあるかどうかを判断します。

UINT IsDlgButtonChecked(int nIDButton) const;

パラメーター

nIDButton
ボタンコントロールの整数識別子を指定します。

戻り値

指定されたコントロールがチェックされている場合は 0 以外、チェックされていない場合は 0。チェックできるのはラジオボタンとチェックボックスのみです。 3 つの状態ボタンの場合、ボタンが不確定の場合、戻り値は 2 になります。このメンバー関数は、プッシュボタンの 0 を返します。

解説

ボタンが 3 状態コントロールの場合、メンバー関数は、ボタンが淡色表示、チェック、またはどちらも行われるかどうかを判断します。

`CWnd::IsDynamicLayoutEnabled`

このウィンドウで動的レイアウトが有効かどうかを判断します。動的レイアウトが有効な場合は、ユーザーが親ウィンドウのサイズを変更したときに、子ウィンドウの位置とサイズを変更できます。

BOOL IsDynamicLayoutEnabled() const;

戻り値

TRUE 動的レイアウトが有効な場合。それ以外の場合は FALSE。

解説

`CWnd::IsIconic`

CWndを最小化するかどうかを指定します (アイコン)。

BOOL IsIconic() const;

戻り値

CWndが最小化されている場合は 0 以外、それ以外の場合は 0。

例

void CAboutDlg::OnPaint()
{
   // This code, normally emitted by the Application Wizard for a dialog-
   // based project for the dialog's WM_PAINT handler, runs only if the
   // window is iconic. The window erases the icon's area, then
   // paints the icon referenced by m_hIcon.
   if (IsIconic())
   {
      CPaintDC dc(this); // device context for painting

      SendMessage(WM_ICONERASEBKGND, (WPARAM)dc.GetSafeHdc(), 0);

      // Center icon in client rectangle
      int cxIcon = GetSystemMetrics(SM_CXICON);
      int cyIcon = GetSystemMetrics(SM_CYICON);
      CRect rect;
      GetClientRect(&rect);
      int x = (rect.Width() - cxIcon + 1) / 2;
      int y = (rect.Height() - cyIcon + 1) / 2;

      // Draw the icon
      dc.DrawIcon(x, y, m_hIcon);
   }
   else
   {
      CDialog::OnPaint();
   }
}

`CWnd::IsTouchWindow`

CWnd でタッチ操作がサポートされているかどうかを示します。

BOOL IsTouchWindow() const;

戻り値

TRUE タッチサポート CWnd 場合は。それ以外の場合は FALSE。

解説

`CWnd::IsWindowEnabled`

マウスとキーボードの入力 CWnd 有効にするかどうかを指定します。

BOOL IsWindowEnabled() const;

戻り値

CWndが有効な場合は 0 以外、それ以外の場合は 0。

例

//change the background color of an edit control on the dialog
HBRUSH CMyDlg::OnCtlColor(CDC *pDC, CWnd *pWnd, UINT nCtlColor)
{
   HBRUSH hbr = CDialog::OnCtlColor(pDC, pWnd, nCtlColor);

   if (pWnd->GetDlgCtrlID() == IDC_MYEDIT)
   {
      if (pWnd->IsWindowEnabled())
      {
         // Red brush for the background...
         pDC->SetBkColor(RGB(255, 0, 0));
         // m_pRedBrush is the CBrush object initialized with a red brush
         // using CreateSolidBrush
         return (HBRUSH)m_RedBrush.GetSafeHandle();
      }
      else
      {
         // Blue brush for the background...
         pDC->SetBkColor(RGB(0, 0, 255));
         // m_pBlueBrush is the CBrush object initialized with a blue
         // brush using CreateSolidBrush
         return (HBRUSH)m_BlueBrush.GetSafeHandle();
      }
   }

   return hbr;
}

`CWnd::IsWindowVisible`

指定されたウィンドウの表示状態を決定します。

BOOL IsWindowVisible() const;

戻り値

CWndが表示されている場合は 0 以外 (WS_VISIBLE スタイルビットが設定され、親ウィンドウが表示されます)。戻り値は WS_VISIBLE スタイルビットの状態を反映するため、 CWnd が他のウィンドウによって完全に隠されている場合でも、戻り値は 0 以外の場合があります。

解説

ウィンドウには、 WS_VISIBLE スタイルビットによって示される表示状態があります。このスタイルビットを ShowWindow メンバー関数の呼び出しで設定すると、ウィンドウが表示され、ウィンドウにスタイルビットが設定されている限り、ウィンドウへの後続の描画が表示されます。

WS_VISIBLE スタイルを持つウィンドウへの描画は、ウィンドウが他のウィンドウで覆われている場合、または親ウィンドウでクリップされている場合は表示されません。

例

// This example uses the CWnd::IsWindowVisible() function to
// determine if a dialog box is visible. If it is not, it calls
// CWnd::ShowWindow with the SW_SHOWNORMAL command.
void CMainFrame::DisplayModeless()
{
   if(!m_Modeless.IsWindowVisible())
   {
      m_Modeless.ShowWindow(SW_SHOWNORMAL);
   }
}

// This example uses the CWnd::IsWindowVisible() function to
// determine if a dialog box is visible. If it is, it calls
// CWnd::ShowWindow with the SW_HIDE command.
void CMainFrame::HideModeless()
{
   if(m_Modeless.IsWindowVisible())
   {
      m_Modeless.ShowWindow(SW_HIDE);
   }
}

`CWnd::IsZoomed`

CWndが最大化されているかどうかを判断します。

BOOL IsZoomed() const;

戻り値

CWndが最大化されている場合は 0 以外、それ以外の場合は 0。

`CWnd::KillTimer`

SetTimerへの以前の呼び出しからnIDEventによって識別されたタイマーイベントを強制終了します。

BOOL KillTimer(UINT_PTR nIDEvent);

パラメーター

nIDEvent
SetTimerに渡されるタイマーイベントの値。

戻り値

関数の結果を指定します。イベントが強制終了された場合、値は 0 以外です。 KillTimer メンバー関数が指定されたタイマーイベントを見つけられなかった場合は 0 です。

解説

タイマーに関連付けられている保留中の WM_TIMER メッセージは、メッセージキューから削除されません。

例

CWnd::SetTimer の例を参照してください。

`CWnd::LoadDynamicLayoutResource`

リソースファイルから動的レイアウト情報を読み込むために、フレームワークによって呼び出されます。

BOOL LoadDynamicLayoutResource(LPCTSTR lpszResourceName);

パラメーター

lpszResourceName
このウィンドウの目的の動的レイアウト情報が含まれているリソースの名前。

戻り値

正常終了した場合は 0 以外を返します。エラーが発生した場合は 0 です。

解説

このメソッドを直接呼び出さないでください。

`CWnd::LockWindowUpdate`

指定されたウィンドウ内の描画を無効にします。

BOOL LockWindowUpdate();

戻り値

正常終了した場合は 0 以外を返します。エラーが発生した場合、または LockWindowUpdate 関数を使用して別のウィンドウをロックした場合は 0 です。

解説

ロックされたウィンドウは移動できません。一度にロックできるウィンドウは 1 つだけです。 LockWindowUpdateでロックされているウィンドウのロックを解除するには、UnlockWindowUpdateを呼び出します。

ロックされたウィンドウ (またはロックされた子ウィンドウ) を持つアプリケーションが Windows 関数 GetDC、 GetDCEx、または BeginPaint を呼び出すと、呼び出された関数は、可視領域が空のデバイスコンテキストを返します。これは、アプリケーションが UnlockWindowUpdate メンバー関数を呼び出してウィンドウのロックを解除するまで発生します。

ウィンドウの更新がロックされている間、システムは、ロックされたウィンドウに関連付けられているデバイスコンテキストに対する描画操作の外接する四角形を追跡します。描画を再び有効にすると、ロックされたウィンドウとその子ウィンドウでこの外接する四角形が無効になり、最終的な WM_PAINT メッセージが強制的に画面を更新します。ウィンドウの更新がロックされている間に図面が発生しなかった場合、領域は無効ではありません。

LockWindowUpdateメンバー関数は、指定されたウィンドウを非表示にせず、WS_VISIBLE スタイルビットをクリアしません。

`CWnd::m_hWnd`

この CWndに接続されている Windows ウィンドウのハンドル。

HWND m_hWnd;

解説

m_hWnd データメンバーは、HWND型のパブリック変数です。

`CWnd::MapWindowPoints`

複数の点を CWnd の座標空間から他のウィンドウの座標空間へ変換 (マップ) します。

void MapWindowPoints(
    CWnd* pwndTo,
    LPRECT lpRect) const;

void MapWindowPoints(
    CWnd* pwndTo,
    LPPOINT lpPoint,
    UINT nCount) const;

パラメーター

pwndTo
ポイントが変換されるウィンドウを識別します。このパラメーターが NULLの場合、ポイントは画面座標に変換されます。

lpRect
ポイントを変換する四角形を指定します。この関数の最初のバージョンは、Windows 3.1 以降でのみ使用できます。

lpPoint
変換するポイントのセットを含む POINT 構造体の配列へのポインター。

nCount
lpPointが指す配列内のPOINT構造体の数を指定します。

`CWnd::MessageBox`

アプリケーションが指定したメッセージとキャプションに加えて、 Message-Box Styles リストで説明されている定義済みのアイコンとプッシュボタンの組み合わせを含むウィンドウを作成して表示します。

int MessageBox(
    LPCTSTR lpszText,
    LPCTSTR lpszCaption = NULL,
    UINT nType = MB_OK);

パラメーター

lpszText
表示するメッセージを含む CString オブジェクトまたは null で終わる文字列を指します。

lpszCaption
メッセージボックスのキャプションに使用する CString オブジェクトまたは null で終わる文字列を指します。 lpszCaptionがNULLの場合は、既定のキャプション "Error" が使用されます。

nType
メッセージボックスの内容と動作を指定します。

戻り値

このメソッドは、Windows SDK で定義されている MessageBox 関数を利用します。このメソッドは、この関数を呼び出した結果を返します。

解説

このメンバー関数の代わりにグローバル関数 AfxMessageBox を使用して、アプリケーションにメッセージボックスを実装します。

メッセージボックスで使用できるさまざまなシステムアイコンを次に示します。

アイコン	マクロ
	`MB_ICONHAND`、`MB_ICONSTOP`、`MB_ICONERROR`
	MB_ICONQUESTION
	MB_ICONEXCLAMATIONとMB_ICONWARNING
	MB_ICONASTERISKとMB_ICONINFORMATION

例

void CMainFrame::OnDisplayErrorMessage()
{
   // This displays a message box with the title "Error"
   // and the message "Help, Something went wrong."
   // The error icon is displayed in the message box, along with
   // an OK button.
   MessageBox(_T("Help, Something went wrong."), _T("Error"),
              MB_ICONERROR | MB_OK);
}

`CWnd::ModifyStyle`

ウィンドウのスタイルを変更するには、このメンバー関数を呼び出します。

BOOL ModifyStyle(
    DWORD dwRemove,
    DWORD dwAdd,
    UINT nFlags = 0);

パラメーター

dwRemove
スタイルの変更中に削除するウィンドウスタイルを指定します。

dwAdd
スタイルの変更中に追加するウィンドウスタイルを指定します。

nFlags
SetWindowPosに渡すフラグ。SetWindowPos呼び出す必要がない場合は 0。既定値は 0 です。プリセットフラグの一覧については、「解説」セクションを参照してください。

戻り値

スタイルが正常に変更された場合は 0 以外。それ以外の場合は 0。

解説

追加または削除するスタイルは、ビットごとの OR (|) 演算子を使用して結合できます。使用可能なウィンドウスタイルの詳細については、Windows SDK Window スタイルおよび CreateWindow に関するトピックを参照してください。

nFlagsが 0 以外の場合、ModifyStyleは Windows API 関数SetWindowPosを呼び出し、nFlagsと次の 4 つのプリセットフラグを組み合わせてウィンドウを再描画します。

SWP_NOSIZE 現在のサイズを保持します。
SWP_NOMOVE 現在の位置を保持します。
SWP_NOZORDER 現在の Z オーダーを保持します。
SWP_NOACTIVATE ウィンドウをアクティブにしません。

ウィンドウの拡張スタイルを変更するには、「 ModifyStyleEx」を参照してください。

Note

特定のコントロールの一部のスタイル (編集コントロールの ES_READONLY スタイルなど) では、コントロールが特別な内部処理を実行する必要があるため、 ModifyStyle でスタイルが適切に変更されない場合があります。このような場合は、スタイルを変更する対応するメッセージが使用可能になります (前述の例 EM_SETREADONLY )。

例

// This example adds the WS_CLIPCHILDREN style to the window.
// No Styles are removed from the window.
void CMyView::OnInitialUpdate()
{
   CView::OnInitialUpdate();
   ModifyStyle(0, WS_CLIPCHILDREN);
}

`CWnd::ModifyStyleEx`

ウィンドウの拡張スタイルを変更するには、このメンバー関数を呼び出します。

BOOL ModifyStyleEx(
    DWORD dwRemove,
    DWORD dwAdd,
    UINT nFlags = 0);

パラメーター

dwRemove
スタイルの変更中に削除する拡張スタイルを指定します。

dwAdd
スタイルの変更中に追加する拡張スタイルを指定します。

戻り値

スタイルが正常に変更された場合は 0 以外。それ以外の場合は 0。

解説

追加または削除するスタイルは、ビットごとの OR (|) 演算子を使用して組み合わせることができます。使用可能な拡張スタイルの詳細についてはこの書籍および Windows SDK のCreateWindowExに関するトピックを参照してください。

nFlagsが 0 以外の場合、ModifyStyleExは Windows API 関数SetWindowPosを呼び出し、nFlagsと次の 4 つのプリセットフラグを組み合わせてウィンドウを再描画します。

SWP_NOSIZE 現在のサイズを保持します。
SWP_NOMOVE 現在の位置を保持します。
SWP_NOZORDER 現在の Z オーダーを保持します。
SWP_NOACTIVATE ウィンドウをアクティブにしません。

通常のウィンドウスタイルを使用してウィンドウを変更するには、「 ModifyStyle」を参照してください。

例

// This example would make the dialog box transparent by
// changing the dialog window's extended styles.
int CAboutDlg::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
   if (CDialog::OnCreate(lpCreateStruct) == -1)
      return -1;

   ModifyStyleEx(0, WS_EX_TRANSPARENT);   
   
   return 0;
}

`CWnd::MoveWindow`

位置と寸法を変更します。

void MoveWindow(
    int x,
    int y,
    int nWidth,
    int nHeight,
    BOOL bRepaint = TRUE);

void MoveWindow(
    LPCRECT lpRect,
    BOOL bRepaint = TRUE);

パラメーター

x
CWndの左側の新しい位置を指定します。

y
CWndの上部の新しい位置を指定します。

nWidth
CWndの新しい幅を指定します。

nHeight
CWndの新しい高さを指定します。

bRepaint
CWndを再描画するかどうかを指定します。 TRUE場合、CWndは通常どおり、OnPaint メッセージハンドラーでWM_PAINT メッセージを受信します。このパラメーターが FALSEされている場合、どのような種類の再描画も行われません。これは、クライアント領域、非クライアント領域 (タイトルとスクロールバーを含む)、および CWndの移動の結果として発見された親ウィンドウの任意の部分に適用されます。このパラメーターを FALSEする場合、アプリケーションは、再描画する必要がある CWnd と親ウィンドウの部分を明示的に無効化または再描画する必要があります。

lpRect
新しいサイズと位置を指定する CRect オブジェクトまたは RECT 構造体。

解説

最上位レベルの CWnd オブジェクトの場合、 x パラメーターと y パラメーターは画面の左上隅を基準にしています。子 CWnd オブジェクトの場合、親ウィンドウのクライアント領域の左上隅を基準にした相対値です。

MoveWindow関数は、WM_GETMINMAXINFO メッセージを送信します。このメッセージを処理 CWnd 、可能な限り大きいウィンドウと最小のウィンドウの既定値を変更する機会が与えられます。 MoveWindowメンバー関数のパラメーターがこれらの値を超える場合は、WM_GETMINMAXINFO ハンドラーの最小値または最大値に置き換えることができます。

例

CWnd::ClientToScreen の例を参照してください。

`CWnd::NotifyWinEvent`

定義済みイベントが発生したことをシステムに通知します。クライアントアプリケーションがイベントのフック関数を登録している場合、システムはクライアントのフック関数を呼び出します。

void NotifyWinEvent(
    DWORD event,
    LONG idObjectType,
    LONG idObject);

パラメーター

event
発生したイベントを指定します。この値は、 event 定数のいずれかである必要があります。

idObjectType
イベントを生成したオブジェクトの種類を識別します。この値は、定義済みのオブジェクト識別子またはカスタムオブジェクト ID 値のいずれかです。

idObject
イベントがオブジェクトによって生成されたか、オブジェクトの子要素によって生成されたかを識別します。この値が CHILDID_SELF場合、イベントはオブジェクト自体によって生成されました。そうでない場合、この値はイベントを生成した要素の子 ID です。

解説

このメンバー関数は、Windows SDK で説明されているように、関数 NotifyWinEventの機能をエミュレートします。

`CWnd::OnActivate`

フレームワークは、 CWnd オブジェクトがアクティブ化または非アクティブ化されるときに、このメンバー関数を呼び出します。

afx_msg void OnActivate(
    UINT nState,
    CWnd* pWndOther,
    BOOL bMinimized);

パラメーター

nState
CWnd がアクティブ化または非アクティブ化されているかどうかが示されます。次のいずれかの値を指定できます。

WA_INACTIVE ウィンドウが非アクティブ化されています。
WA_ACTIVE ウィンドウは、マウスクリック以外の方法でアクティブ化されています (たとえば、キーボードインターフェイスを使用してウィンドウを選択するなど)。
WA_CLICKACTIVE ウィンドウはマウスクリックでアクティブ化されています。

pWndOther
アクティブ化または非アクティブ化されている CWnd へのポインター。ポインターは NULLすることができ、一時的な場合もあります。

bMinimized
アクティブ化または非アクティブ化されている CWnd の最小化された状態が示されます。 TRUEの値は、ウィンドウが最小化されていることを示します。

TRUE場合は、CWndがアクティブ化されます。それ以外の場合は非アクティブ化されます。

解説

CWnd オブジェクトがマウスクリックでアクティブ化されると、OnMouseActivateメンバー関数呼び出しも受け取ります。

Note

`CWnd::OnActivateApp`

フレームワークは、アクティブ化されているタスクのすべての最上位ウィンドウと、非アクティブ化されるタスクのすべての最上位ウィンドウに対して、このメンバー関数を呼び出します。

afx_msg void OnActivateApp(
    BOOL bActive,
    DWORD dwThreadID);

パラメーター

bActive
CWnd がアクティブ化または非アクティブ化されているかどうかが示されます。 TRUE は、 CWnd がアクティブ化されていることを意味します。 FALSE は、 CWnd が非アクティブ化されていることを意味します。

dwThreadID
スレッド ID の値を指定します。 bActiveがTRUEされている場合、dwThreadIDは非アクティブ化されているCWndを所有するスレッドを識別します。 bActiveがFALSEされている場合、dwThreadIDはアクティブ化されているCWndを所有するスレッドを識別します。

解説

Note

`CWnd::OnAmbientProperty`

フレームワークは、OLE コントロールを含むウィンドウからアンビエントプロパティ値を取得するために、このメンバー関数を呼び出します。

virtual BOOL OnAmbientProperty(
    COleControlSite* pSite,
    DISPID dispid,
    VARIANT* pvar);

パラメーター

pSite
アンビエントプロパティを要求したコントロールのサイトへのポインター。

dispid
要求されたアンビエントプロパティのディスパッチ ID。

pvar
呼び出し元によって割り当てられた VARIANT 構造体へのポインター。アンビエントプロパティの値が返されます。

戻り値

TRUE アンビエントプロパティがサポートされている場合。そうでない場合は FALSE 。

解説

OLE コントロールコンテナーによって返される既定のアンビエントプロパティ値をコントロールに変更するには、この関数をオーバーライドします。オーバーライド関数によって処理されないアンビエントプロパティ要求は、基底クラスの実装に転送する必要があります。

`CWnd::OnAppCommand`

フレームワークは、ユーザーがアプリケーションコマンドイベントを生成するときに、このメンバー関数を呼び出します。このようなイベントは、ユーザーがアプリケーションコマンドボタンをクリックするか、アプリケーションコマンドキーを入力したときに発生します。

afx_msg void OnAppCommand(
    CWnd* pWnd,
    UINT nCmd,
    UINT nDevice,
    UINT nKey);

パラメーター

pWnd
[in]ユーザーがコマンドボタンをクリックするか、コマンドキーを押したウィンドウを表す CWnd オブジェクトへのポインター。このウィンドウには、メッセージを受信するウィンドウの子ウィンドウを指定できます。

nCmd
[in]アプリケーションコマンドを示します。使用可能な値の一覧については、WM_APPCOMMANDの lParam パラメーターのcmdセクションにあるコマンドを参照してください。

nDevice
[in]入力イベントを生成した入力デバイス。使用可能な値の一覧については、WM_APPCOMMANDの lParam パラメーターのuDeviceセクションにあるデバイスを参照してください。

nKey
[in]Ctrl キーやマウスの左ボタンなど、ダウンしている仮想キーを示します。使用可能な値の一覧については、WM_APPCOMMANDの lParam パラメーターの dwKeys セクションの下にあるキーを参照してください。詳細については、「 About マウス入力」の「メッセージパラメーター」小見出しを参照してください。

解説

このメソッドは、Windows SDK で説明されている WM_APPCOMMAND 通知を受け取ります。

Note

`CWnd::OnAskCbFormatName`

フレームワークは、クリップボードに CF_OWNERDISPLAY 形式のデータハンドルが含まれている場合 (つまり、クリップボードの所有者がクリップボードの内容を表示する場合) に、このメンバー関数を呼び出します。

afx_msg void OnAskCbFormatName(
    UINT nMaxCount,
    LPTSTR lpszString);

パラメーター

nMaxCount
コピーする最大バイト数を指定します。

lpszString
フォーマット名のコピーが格納されるバッファーを指します。

解説

クリップボードの所有者は、その形式の名前を指定する必要があります。

このメンバー関数をオーバーライドし、指定したバッファーに CF_OWNERDISPLAY 形式の名前をコピーします。指定した最大バイト数を超えてはなりません。

Note

`CWnd::OnCancelMode`

フレームワークは、このメンバー関数を呼び出して、内部モードを取り消すよう CWnd に通知します。

afx_msg void OnCancelMode();

解説

CWnd オブジェクトにフォーカスがある場合は、ダイアログボックスまたはメッセージボックスが表示されるときに、そのOnCancelModeメンバー関数が呼び出されます。これにより、 CWnd はマウスキャプチャなどのモードをキャンセルできます。

既定の実装は、 ReleaseCapture Windows 関数を呼び出すことによって応答します。派生クラスのこのメンバー関数をオーバーライドして、他のモードを処理します。

`CWnd::OnCaptureChanged`

フレームワークは、このメンバー関数を呼び出して、マウスキャプチャを失っているウィンドウに通知します。

afx_msg void OnCaptureChanged(CWnd* pWnd);

パラメーター

pWnd
マウスキャプチャを取得するウィンドウへのポインター

解説

ウィンドウは、 ReleaseCapture 自体を呼び出した場合でも、このメッセージを受け取ります。アプリケーションは、このメッセージに応答してマウスキャプチャを設定しないでください。このメッセージを受信すると、新しいマウスキャプチャ状態を反映するために、必要に応じてウィンドウ自体を再描画する必要があります。

ReleaseCapture Windows 関数の詳細については、Windows SDK を参照してください。

Note

`CWnd::OnChangeCbChain`

フレームワークは、クリップボードビューアーチェーン内の各ウィンドウに対してこのメンバー関数を呼び出して、ウィンドウがチェーンから削除されていることを通知します。

afx_msg void OnChangeCbChain(
    HWND hWndRemove,
    HWND hWndAfter);

パラメーター

hWndRemove
クリップボードビューアーチェーンから削除されるウィンドウハンドルを指定します。

hWndAfter
クリップボードビューアーチェーンから削除されるウィンドウの後に続くウィンドウハンドルを指定します。

解説

OnChangeCbChain呼び出しを受け取る各CWnd オブジェクトは、SendMessage Windows 関数を使用して、クリップボードビューアーチェーン内の次のウィンドウ (SetClipboardViewerによって返されるハンドル) にWM_CHANGECBCHAIN メッセージを送信する必要があります。 hWndRemoveがチェーン内の次のウィンドウの場合、hWndAfterによって指定されたウィンドウが次のウィンドウになり、クリップボードメッセージが渡されます。

Note

`CWnd::OnChangeUIState`

ユーザーインターフェイス (UI) 状態を変更する必要があるときに呼び出されます。

afx_msg void OnChangeUIState(
    UINT nAction,
    UINT nUIElement);

パラメーター

nAction
実行するアクションを指定します。値は、次のいずれかです。

UIS_CLEAR UI 状態要素 ( nUIElement で指定) は非表示にする必要があります。
UIS_INITIALIZE UI 状態要素 ( nUIElement で指定) は、最後の入力イベントに基づいて変更する必要があります。詳細については、WM_CHANGEUISTATEの「Remarks」セクションを参照してください。
UIS_SET UI 状態要素 ( nUIElement で指定) を表示する必要があります。

nUIElement
影響を受ける UI 状態要素またはコントロールのスタイルを指定します。値は、次のいずれかです。

UISF_HIDEACCEL キーボードアクセラレータ。
UISF_HIDEFOCUS フォーカスインジケーター。
UISF_ACTIVE Windows XP: コントロールは、アクティブなコントロールに使用されるスタイルで描画する必要があります。

解説

このメンバー関数は、Windows SDK で説明されているように、 WM_CHANGEUISTATE メッセージの機能をエミュレートします。

`CWnd::OnChar`

フレームワークは、キーストロークが非システム文字に変換されるときに、このメンバー関数を呼び出します。

afx_msg void OnChar(
    UINT nChar,
    UINT nRepCnt,
    UINT nFlags);

パラメーター

nChar
キーの文字コード値を格納します。

nRepCnt
ユーザーがキーを押したときにキーストロークが繰り返される回数を含みます。

nFlags
次の一覧に示すように、スキャンコード、キー遷移コード、以前のキー状態、コンテキストコードが含まれます。

値	意味
0-15	繰り返し数を指定します。値は、ユーザーがキーを押した結果としてキーストロークが繰り返される回数です。
16-23	スキャンコードを指定します。値は、元の機器の製造元 (OEM) によって異なります
24	拡張された 101 キーまたは 102 キーキーボードに表示される右側の Alt キーや Ctrl キーなど、キーが拡張キーかどうかを指定します。拡張キーの場合、値は 1 です。それ以外の場合は 0 です。
25-28	Windows によって内部的に使用されます。
29	コンテキストコードを指定します。 Alt キーを押しながらキーを押すと、値は 1 になります。それ以外の場合、値は 0 です。
30	前のキーの状態を指定します。メッセージが送信される前にキーがダウンしている場合は値 1、キーが稼働している場合は 0 です。
31	遷移状態を指定します。キーが解放されている場合は値 1、キーが押されている場合は 0 です。

解説

この関数は、 OnKeyUp メンバー関数の前と、 OnKeyDown メンバー関数の呼び出し後に呼び出されます。 OnChar には、押すか離されるキーボードキーの値が含まれます。

押されたキーと生成された OnChar 呼び出しの間に一対一の対応が必ずしも存在するわけではないため、 nFlags の情報は一般にアプリケーションには役に立ちません。 nFlagsの情報は、OnKeyUp メンバー関数の最新の呼び出し、またはOnCharの呼び出しの前にある OnKeyDown メンバー関数にのみ適用されます。

IBM Enhanced 101 キーおよび 102 キー・キーボードの場合、拡張キーはキーボードのメイン・セクションの右 ALT キーと右 CTRL キーです。テンキーの左側にあるクラスター内の INS、DEL、HOME、END、PAGE UP、PAGE DOWN、および方向キー。テンキーのスラッシュ (/) キーと Enter キーを使用します。他の一部のキーボードは、 nFlagsで拡張キービットをサポートしている場合があります。

Note

`CWnd::OnCharToItem`

LBS_WANTKEYBOARDINPUT スタイルのリストボックスが、WM_CHAR メッセージに応答して所有者にWM_CHARTOITEM メッセージを送信すると呼び出されます。

afx_msg int OnCharToItem(
    UINT nChar,
    CListBox* pListBox,
    UINT nIndex);

パラメーター

nChar
ユーザーが押すキーの値を指定します。

pListBox
リストボックスへのポインターを指定します。一時的な場合があります。

nIndex
現在のキャレット位置を指定します。

戻り値

フレームワークは、このメンバー関数を呼び出して、アプリケーションが呼び出しに応答して実行したアクションを指定します。戻り値 -2 は、アプリケーションが項目の選択のすべての側面を処理し、リストボックスによるそれ以上のアクションを必要としなかったことを示します。戻り値 -1 は、リストボックスがキーストロークに応答して既定のアクションを実行する必要があることを示します。戻り値が 0 以上の場合は、リストボックス内の項目の 0 から始まるインデックスを指定し、リストボックスが指定された項目に対してキーストロークの既定のアクションを実行する必要があることを示します。

解説

Note

`CWnd::OnChildActivate`

CWnd オブジェクトが複数ドキュメントインターフェイス (MDI) 子ウィンドウの場合、ユーザーがウィンドウのタイトルバーをクリックしたとき、またはウィンドウがアクティブ化、移動、またはサイズ変更されたときに、フレームワークによってOnChildActivateが呼び出されます。

afx_msg void OnChildActivate();

`CWnd::OnChildNotify`

このメンバー関数は、このウィンドウに適用される通知メッセージを受信すると、このウィンドウの親ウィンドウによって呼び出されます。

virtual BOOL OnChildNotify(
    UINT message,
    WPARAM wParam,
    LPARAM lParam,
    LRESULT* pResult);

パラメーター

message
親ウィンドウに送信される Windows メッセージ番号。

wParam
メッセージに関連付けられた wparam 。

lParam
メッセージに関連付けられている lparam 。

pLResult
親のウィンドウプロシージャから返される値へのポインター。戻り値が必要ない場合、このポインターは NULL されます。

戻り値

このウィンドウが親に送信されたメッセージを処理する場合は 0 以外。それ以外の場合は 0。

解説

このメンバー関数を直接呼び出すことはありません。

このメンバー関数の既定の実装では 0 が返されます。これは、親がメッセージを処理する必要があることを意味します。

コントロールが通知メッセージに応答する方法を拡張するには、このメンバー関数をオーバーライドします。

`CWnd::OnClipboardUpdate`

クリップボードの内容が変更されると、フレームワークはこのメンバー関数を呼び出します。

afx_msg void OnClipboardUpdate();

`CWnd::OnClose`

フレームワークは、このメンバー関数を、 CWnd またはアプリケーションが終了することを示すシグナルとして呼び出します。

afx_msg void OnClose();

解説

既定の実装では、 DestroyWindowが呼び出されます。

`CWnd::OnColorizationColorChanged`

フレームワークは、非クライアント領域のレンダリングポリシーが変更されたときに、このメンバーを呼び出します。

afx_msg void OnColorizationColorChanged(
    DWORD dwColorizationColor,
    BOOL bOpacity);

パラメーター

dwColorizationColor
[in]新しい色分け色を指定します。色形式は 0xAARRGGBB 形式の 16 進数で、4 つのコンポーネントのそれぞれが0x00から0xFFの範囲です。 AA 成分はアルファ値、RR は赤、GG は緑、BB は青です。

bOpacity
[入力] TRUE 新しい色が不透明度とブレンドされている場合。そうでない場合は FALSE します。

解説

このメソッドは、Windows SDK で説明されている WM_DWMNCRENDERINGCHANGED 通知メッセージを受け取ります。

Note

`CWnd::OnCommand`

フレームワークは、ユーザーがメニューから項目を選択したとき、子コントロールが通知メッセージを送信するとき、またはアクセラレータキーストロークが変換されたときに、このメンバー関数を呼び出します。

virtual BOOL OnCommand(
    WPARAM wParam,
    LPARAM lParam);

パラメーター

wParam
wParamの下位ワードは、メニュー項目、コントロール、またはアクセラレータのコマンド ID を識別します。 wParamの上位ワードは、メッセージがコントロールからの場合に通知メッセージを指定します。メッセージがアクセラレータからのメッセージの場合、上位ワードは 1 です。メッセージがメニューから送信されている場合、上位ワードは 0 になります。

lParam
メッセージがコントロールからのメッセージの場合にメッセージを送信するコントロールを識別します。それ以外の場合、 lParam は 0 です。

戻り値

このメッセージを処理すると、アプリケーションは 0 以外の値を返します。それ以外の場合は 0。

解説

OnCommand は、制御通知と ON_COMMAND エントリのメッセージマップを処理し、適切なメンバー関数を呼び出します。

WM_COMMAND メッセージを処理するには、派生クラスのこのメンバー関数をオーバーライドします。基底クラスの OnCommand が呼び出されない限り、オーバーライドはメッセージマップを処理しません。

Note

`CWnd::OnCompacting`

フレームワークは、30 秒から 60 秒の間隔でシステム時間の 12.5% 以上がメモリの圧縮に費やされていることを Windows が検出すると、すべての最上位ウィンドウに対してこのメンバー関数を呼び出します。

afx_msg void OnCompacting(UINT nCpuTime);

パラメーター

nCpuTime
Windows によるメモリの圧縮に現在費やされている CPU 時間と、他の操作の実行に費やされた CPU 時間の比率を指定します。たとえば、8000h は、メモリの圧縮に費やされた CPU 時間の 50% を表します。

解説

これは、システムメモリが不足していることを示します。

CWnd オブジェクトは、この呼び出しを受け取ると、アプリケーションの現在のアクティビティレベルと Windows で実行されているアプリケーションの合計数を考慮して、できるだけ多くのメモリを解放する必要があります。アプリケーションは Windows 関数を呼び出して、実行されているアプリケーションの数を確認できます。

Note

`CWnd::OnCompareItem`

フレームワークは、このメンバー関数を呼び出して、子の並べ替えられた所有者描画コンボまたはリストボックス内の新しい項目の相対位置を指定します。

afx_msg int OnCompareItem(
    int nIDCtl,
    LPCOMPAREITEMSTRUCT lpCompareItemStruct);

パラメーター

nIDCtl
WM_COMPAREITEM メッセージを送信したコントロールの識別子。

lpCompareItemStruct
コンボボックスまたはリストボックス内の 2 つの項目の識別子とアプリケーションによって提供されるデータを含む、 COMPAREITEMSTRUCT データ構造体への長いポインターが含まれます。

戻り値

2 つの項目の相対位置を示します。次のいずれかの値を指定できます。

値	意味
-1	項目 1 は項目 2 より前に並べ替えられます。
0	項目 1 と項目 2 は同じように並べ替えられます。
1	項目 1 は項目 2 の後に並べ替えられます。

解説

コンボボックスまたはリストボックスが CBS_SORT または LBS_SORT スタイルで作成された場合、アプリケーションが新しい項目を追加するたびに、コンボボックスまたはリストボックスの所有者に WM_COMPAREITEM メッセージが送信されます。

コンボボックスまたはリストボックス内の 2 つの項目は、lpCompareItemStructが指すCOMPAREITEMSTRUCT構造で改革されます。 OnCompareItem は、他の項目の前に表示する項目を示す値を返す必要があります。通常、Windows では、新しい項目の正確な位置が決定されるまで、この呼び出しが複数回行われます。

COMPAREITEMSTRUCT構造体のhwndItem メンバーがCListBoxまたはCComboBox オブジェクトに属している場合は、適切なクラスのCompareItem仮想関数が呼び出されます。派生CListBoxクラスまたはCComboBox クラスのCComboBox::CompareItemまたはCListBox::CompareItemをオーバーライドして、項目の比較を行います。

Note

`CWnd::OnCompositionChanged`

デスクトップウィンドウマネージャー (DWM) コンポジションが有効または無効になっている場合、フレームワークはすべての最上位ウィンドウに対してこのメンバー関数を呼び出します。

afx_msg void OnCompositionChanged();

解説

このメソッドは、Windows SDK で説明されている WM_DWMCOMPOSITIONCHANGED 通知を受け取ります。

Note

`CWnd::OnContextMenu`

ユーザーがウィンドウ内のマウスの右ボタン (右クリック) をクリックしたときに、フレームワークによって呼び出されます。

afx_msg void OnContextMenu(
    CWnd* pWnd,
    CPoint pos);

パラメーター

pWnd
ユーザーがマウスを右クリックしたウィンドウを処理します。メッセージを受信するウィンドウの子ウィンドウを指定できます。このメッセージの処理の詳細については、「解説」セクションを参照してください。

pos
マウスクリック時のカーソルの位置 (画面座標)。

解説

このメッセージは、 TrackPopupMenuを使用してコンテキストメニューを表示することで処理できます。

コンテキストメニューを表示しない場合は、このメッセージを DefWindowProc 関数に渡す必要があります。ウィンドウが子ウィンドウの場合、 DefWindowProc はメッセージを親に送信します。それ以外の場合、指定した位置がウィンドウのキャプションにある場合、 DefWindowProc は既定のコンテキストメニューを表示します。

`CWnd::OnCopyData`

このメンバー関数は、アプリケーション間でデータをコピーするためにフレームワークによって呼び出されます。

afx_msg BOOL OnCopyData(
    CWnd* pWnd,
    COPYDATASTRUCT* pCopyDataStruct);

パラメーター

pWnd
データを送信している CWnd オブジェクトへのポインター。

pCopyDataStruct
送信されるデータを含む COPYDATASTRUCT 構造体へのポインター。

戻り値

受信アプリケーションが正常にデータを受け入れた場合に TRUE を返します。それ以外の場合、FALSE を返します。

解説

渡されるデータには、データを受け取るアプリケーションからアクセスできないオブジェクトへのポインターまたはその他の参照を含めてはなりません。

データのコピー中は、送信プロセスの別のスレッドで変更しないでください。

受信側のアプリケーションでは、データの読み取り専用を考慮する必要があります。パラメーター pCopyDataStruct が指す構造体は、データの転送中にのみ有効です。ただし、受信側のアプリケーションは、構造体に関連付けられているメモリを解放しないでください。

この関数が戻った後に受信側アプリケーションがデータにアクセスする必要がある場合は、受信したデータをローカルバッファーにコピーする必要があります。

Note

`CWnd::OnCreate`

フレームワークは、アプリケーションが Create または CreateEx メンバー関数を呼び出して Windows ウィンドウの作成を要求すると、このメンバー関数呼び出します。

afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

パラメーター

lpCreateStruct
作成されるCWnd オブジェクトに関する情報を含むCREATESTRUCT構造体を指します。

戻り値

OnCreateCWnd オブジェクトの作成を続行するには、0 を返す必要があります。アプリケーションから -1 が返された場合、ウィンドウは破棄されます。

解説

CWnd オブジェクトは、ウィンドウが作成された後、表示される前に、この呼び出しを受け取ります。 OnCreate は、 Create または CreateEx メンバー関数が戻る前に呼び出されます。

派生クラスの必要な初期化を実行するには、このメンバー関数をオーバーライドします。

CREATESTRUCT構造体には、ウィンドウの作成に使用されるパラメーターのコピーが含まれています。

Note

`CWnd::OnCtlColor`

フレームワークは、子コントロールが描画されるときに、このメンバー関数を呼び出します。

afx_msg HBRUSH OnCtlColor(
    CDC* pDC,
    CWnd* pWnd,
    UINT nCtlColor);

パラメーター

pDC
子ウィンドウの表示コンテキストへのポインターを格納します。一時的な場合があります。

pWnd
色を求めるコントロールへのポインターを格納します。一時的な場合があります。

nCtlColor
コントロールの種類を指定する、次のいずれかの値が含まれます。

CTLCOLOR_BTN ボタンコントロール
CTLCOLOR_DLG ダイアログボックス
CTLCOLOR_EDIT コントロールの編集
CTLCOLOR_LISTBOX リストボックスコントロール
CTLCOLOR_MSGBOX メッセージボックス
CTLCOLOR_SCROLLBAR スクロールバーコントロール
CTLCOLOR_STATIC 静的コントロール

戻り値

OnCtlColor は、コントロールの背景の描画に使用するブラシのハンドルを返す必要があります。

解説

ほとんどのコントロールは、このメッセージを親 (通常はダイアログボックス) に送信して、正しい色を使用してコントロールを描画するための pDC を準備します。

テキストの色を変更するには、目的の赤、緑、青 (RGB) の値を使用して SetTextColor メンバー関数を呼び出します。

1 行の編集コントロールの背景色を変更するには、CTLCOLOR_EDITとCTLCOLOR_MSGBOXメッセージコードの両方でブラシハンドルを設定し、CTLCOLOR_EDIT コードに応答してCDC::SetBkColor関数を呼び出します。

OnCtlColor ドロップダウンリストボックスは実際にはコンボボックスの子であり、ウィンドウの子ではないため、ドロップダウンコンボボックスのリストボックスには呼び出されません。ドロップダウンリストボックスの色を変更するには、nCtlColor パラメーターでCTLCOLOR_LISTBOXをチェックするOnCtlColorのオーバーライドを使用してCComboBoxを作成します。このハンドラーでは、 SetBkColor メンバー関数を使用してテキストの背景色を設定する必要があります。

Note

このメンバー関数は、アプリケーションで Windows メッセージを処理できるようにするためにフレームワークによって呼び出されます。関数に渡されるパラメーターは、メッセージを受信したときにフレームワークが受信したパラメーターを反映します。この関数の基底クラス実装を呼び出す場合、その実装は、関数に指定したパラメーターではなく、メッセージと共に渡されたパラメーターを使用します。次のメソッドをダイアログクラスに追加するには、Visual Studio のプロパティウィンドウを使用して、 WM_CTLCOLORのメッセージハンドラーを追加します。または、メッセージマップに ON_WM_CTLCOLOR() エントリを手動で追加することもできます。

例

// This OnCtlColor handler will change the color of a static control
// with the ID of IDC_MYSTATIC. The code assumes that the CPenWidthsDlg
// class has an initialized and created CBrush member named m_brush.
// The control will be painted with red text and a background
// color of m_brush.
HBRUSH CPenWidthsDlg::OnCtlColor(CDC* pDC, CWnd* pWnd, UINT nCtlColor)
{
   // Call the base class implementation first! Otherwise, it may
   // undo what we're trying to accomplish here.
   HBRUSH hbr = CDialog::OnCtlColor(pDC, pWnd, nCtlColor);

   // Are we painting the IDC_MYSTATIC control? We can use
   // CWnd::GetDlgCtrlID() to perform the most efficient test.
   if (pWnd->GetDlgCtrlID() == IDC_MYSTATIC)
   {
      // Set the text color to red
      pDC->SetTextColor(RGB(255, 0, 0));

      // Set the background mode for text to transparent 
      // so background will show thru.
      pDC->SetBkMode(TRANSPARENT);

      // Return handle to our CBrush object
      hbr = m_brush;
   }

   return hbr;
}

`CWnd::OnDeadChar`

フレームワークは、 OnKeyUp メンバー関数と OnKeyDown メンバー関数が呼び出されたときに、このメンバー関数を呼び出します。

afx_msg void OnDeadChar(
    UINT nChar,
    UINT nRepCnt,
    UINT nFlags);

パラメーター

nChar
配信不能キー文字の値を指定します。

nRepCnt
繰り返し数を指定します。

nFlags
次の一覧に示すように、スキャンコード、キー遷移コード、以前のキー状態、コンテキストコードを指定します。

値	説明
0-7	スキャンコード (OEM に依存する値)。上位ワードの下位バイト。
8	拡張キー (ファンクションキーやテンキーのキーなど) (拡張キーの場合は 1、それ以外の場合は 0)。
9 から 10	未使用。
11-12	Windows によって内部的に使用されます。
13	コンテキストコード (キーが押されている間に Alt キーが押されている場合は 1、それ以外の場合は 0)。
14	以前のキーの状態 (キーが呼び出しの前にダウンしている場合は 1、キーがアップの場合は 0)。
15	遷移状態 (キーが解放されている場合は 1、キーが押されている場合は 0)。

解説

このメンバー関数を使用して、デッドキーの文字値を指定できます。デッドキーは、他の文字と組み合わせて複合文字を形成する、umlaut (二重ドット) 文字などのキーです。たとえば、umlaut-O 文字は、デッドキー、ウムラウト、O キーで構成されます。

通常、アプリケーションは OnDeadChar を使用して、押された各キーに関するフィードバックをユーザーに提供します。たとえば、アプリケーションでは、キャレットを移動することなく、現在の文字位置にアクセントを表示できます。

押されたキーと OnDeadChar 呼び出しの間に必ずしも 1 対 1 の対応があるとは限らないため、 nFlags の情報は通常、アプリケーションには役に立ちません。 nFlagsの情報は、OnDeadChar呼び出しの前にある OnKeyUp メンバー関数または OnKeyDown メンバー関数の最新の呼び出しにのみ適用されます。

Note

`CWnd::OnDeleteItem`

フレームワークは、このメンバー関数を呼び出して、リストボックスまたはコンボボックスが破棄されたこと、またはアイテムが CComboBox::DeleteString、 CListBox::DeleteString、 CComboBox::ResetContent、または CListBox::ResetContentによって削除されたことを所有者に通知します。

afx_msg void OnDeleteItem(
    int nIDCtl,
    LPDELETEITEMSTRUCT lpDeleteItemStruct);

パラメーター

nIDCtl
WM_DELETEITEM メッセージを送信したコントロールの識別子。

lpDeleteItemStruct
削除されたリストボックスアイテムに関する情報を含む DELETEITEMSTRUCT データ構造への長いポインターを指定します。

解説

DELETEITEMSTRUCT構造体のhwndItem メンバーがコンボボックスまたはリストボックスに属している場合は、適切なクラスのDeleteItem仮想関数が呼び出されます。適切なコントロールのクラスの DeleteItem メンバー関数をオーバーライドして、項目固有のデータを削除します。

Note

`CWnd::OnDestroy`

フレームワークは、このメンバー関数を呼び出して、 CWnd オブジェクトが破棄されていることを通知します。

afx_msg void OnDestroy();

解説

OnDestroy は、 CWnd オブジェクトが画面から削除された後に呼び出されます。

OnDestroy は、破棄される CWnd に対して最初に呼び出され、次に CWnd の子ウィンドウが破棄されるときに呼び出されます。 OnDestroyの実行中は、すべての子ウィンドウがまだ存在すると見なすことができます。

破棄されるCWnd オブジェクトがクリップボードビューアーチェーン (SetClipboardViewer メンバー関数を呼び出して設定) の一部である場合、CWndは、OnDestroy関数から戻る前に、ChangeClipboardChain メンバー関数を呼び出して、クリップボードビューアーチェーンから自分自身を削除する必要があります。

`CWnd::OnDestroyClipboard`

フレームワークは、 EmptyClipboard Windows 関数の呼び出しによってクリップボードが空になったときに、クリップボードの所有者に対してこのメンバー関数を呼び出します。

afx_msg void OnDestroyClipboard();

`CWnd::OnDeviceChange`

フレームワークは、このメンバー関数を呼び出して、デバイスまたはコンピューターのハードウェア構成の変更をアプリケーションまたはデバイスドライバーに通知します。

afx_msg BOOL OnDeviceChange(
    UINT nEventType,
    DWORD_PTR dwData);

パラメーター

nEventType
イベントの種類。使用可能な値の説明については、「解説」セクションを参照してください。

dwData
イベント固有のデータを含む構造体のアドレス。その意味は、指定されたイベントによって異なります。

解説

放出やロックなどのソフトウェア制御可能な機能を提供するデバイスの場合、オペレーティングシステムは通常、 DBT_DEVICEREMOVEPENDING メッセージを送信して、アプリケーションとデバイスドライバーがデバイスの使用を正常に終了できるようにします。

オペレーティングシステムがデバイスを強制的に削除した場合、その前に DBT_DEVICEQUERYREMOVE メッセージが送信されないことがあります。

nEvent パラメーターには、次のいずれかの値を指定できます。

DBT_DEVICEARRIVAL デバイスが挿入され、使用可能になりました。
DBT_DEVICEQUERYREMOVE デバイスを削除するアクセス許可が要求されます。どのアプリケーションでも、この要求を拒否し、削除を取り消すことができます。
DBT_DEVICEQUERYREMOVEFAILED デバイスの削除要求が取り消されました。
DBT_DEVICEREMOVEPENDING デバイスが削除されようとしています。拒否できません。
DBT_DEVICEREMOVECOMPLETE デバイスが削除されました。
DBT_DEVICETYPESPECIFIC デバイス固有のイベント。
DBT_CONFIGCHANGED 現在の構成が変更されました。
DBT_DEVNODES_CHANGED デバイスノードが変更されました。

Note

`CWnd::OnDevModeChange`

フレームワークは、ユーザーがデバイスモードの設定を変更したときに、最上位レベルのすべての CWnd オブジェクトに対してこのメンバー関数を呼び出します。

afx_msg void OnDevModeChange(LPTSTR lpDeviceName);

パラメーター

lpDeviceName
Windows 初期化ファイルで指定されたデバイス名 ( WIN.INI) をポイントします。

解説

WM_DEVMODECHANGE メッセージを処理するアプリケーションは、デバイスモードの設定を再初期化できます。 Windows ExtDeviceMode 関数を使用してデバイス設定を保存および復元するアプリケーションでは、通常、この関数は処理されません。

ユーザーが既定のプリンターをコントロールパネルから変更した場合、この関数は呼び出されません。この場合、 OnWinIniChange 関数が呼び出されます。

Note

`CWnd::OnDrawClipboard`

クリップボードの内容が変更されると、フレームワークはクリップボードビューアーチェーン内の各ウィンドウに対してこのメンバー関数を呼び出します。

afx_msg void OnDrawClipboard();

解説

この呼び出しに応答する必要があるのは、 SetClipboardViewer メンバー関数を呼び出してクリップボードビューアーチェーンに参加したアプリケーションだけです。

OnDrawClipboard呼び出しを受け取る各ウィンドウは、SendMessage Windows 関数を呼び出して、クリップボードビューアーチェーンの次のウィンドウにWM_DRAWCLIPBOARD メッセージを渡す必要があります。次のウィンドウのハンドルは、 SetClipboardViewer メンバー関数によって返されます。 OnChangeCbChain メンバー関数の呼び出しに応答して変更できます。

`CWnd::OnDrawIconicThumbnailOrLivePreview`

Windows 7 のタブのサムネイルに表示する、またはアプリケーションのピーク用にクライアントで表示するビットマップを取得する必要があるときに、フレームワークによって呼び出されます。

virtual void OnDrawIconicThumbnailOrLivePreview(
    CDC& dc,
    CRect rect,
    CSize szRequiredThumbnailSize,
    BOOL bIsThumbnail,
    BOOL& bAlphaChannelSet);

パラメーター

dc
デバイスコンテキストを指定します。

rect
レンダリングする領域の外接する四角形を指定します。

szRequiredThumbnailSize
ターゲットサムネイルのサイズを指定します。 bIsThumbnailがFALSEされている場合は無視する必要があります。

bIsThumbnail
このメソッドをアイコンサムネイルまたはライブプレビュー (ピーク) に対して呼び出すかどうかを指定します。

bAlphaChannelSet
[out]dcで選択したビットマップのアルファチャネルを実装で初期化する場合は、TRUEに設定します。

解説

サムネイルとピークをカスタマイズするために、派生クラスでこのメソッドをオーバーライドし、指定したデバイスコンテキストに描画します。 bThumbnailがTRUEされている場合、szRequiredThumbnailSizeは無視できます。この場合、フルサイズのビットマップ (つまり、クライアント領域全体をカバーするビットマップ) を描画していることに注意する必要があります。デバイスコンテキスト (dc) には、選択した 32 ビットビットマップが付属しています。既定の実装では、PRF_CLIENT、PRF_CHILDREN、およびPRF_NONCLIENTフラグを使用して、このウィンドウにWM_PRINTを送信します。

`CWnd::OnDrawItem`

フレームワークは、コントロールまたはメニューの視覚的な側面が変更されたときに、所有者描画ボタンコントロール、コンボボックスコントロール、リストボックスコントロール、またはメニューの所有者に対してこのメンバー関数を呼び出します。

afx_msg void OnDrawItem(
    int nIDCtl,
    LPDRAWITEMSTRUCT lpDrawItemStruct);

パラメーター

nIDCtl
WM_DRAWITEM メッセージを送信したコントロールの識別子を格納します。メニューがメッセージを送信した場合、 nIDCtl には 0 が含まれます。

lpDrawItemStruct
描画する項目と必要な描画の種類に関する情報を含む DRAWITEMSTRUCT データ構造への長いポインターを指定します。

解説

DRAWITEMSTRUCT構造体のitemAction メンバーは、実行する描画操作を定義します。このメンバーのデータを使用すると、コントロールの所有者は、必要な描画アクションを決定できます。

このメッセージの処理から戻る前に、アプリケーションは、DRAWITEMSTRUCT構造体のhDC メンバーによって識別されるデバイスコンテキストが既定の状態に復元されていることを確認する必要があります。

hwndItem メンバーが CButton、CMenu、CListBox、または CComboBox オブジェクトに属している場合は、適切なクラスのDrawItem仮想関数が呼び出されます。適切なコントロールのクラスの DrawItem メンバー関数をオーバーライドして、項目を描画します。

Note

`CWnd::OnDropFiles`

フレームワークは、ユーザーがドロップされたファイルの受信者として自身を登録しているウィンドウの上にマウスの左ボタンを離すと、このメンバー関数を呼び出します。

afx_msg void OnDropFiles(HDROP hDropInfo);

パラメーター

hDropInfo
ドロップされたファイルを記述する内部データ構造へのポインター。このハンドルは、削除されたファイルに関する情報を取得するために、 DragFinish、 DragQueryFile、および DragQueryPoint Windows 関数によって使用されます。

解説

通常、派生クラスはドロップされたファイルをサポートするように設計され、ウィンドウの構築中に自身を登録します。

Note

`CWnd::OnEnable`

フレームワークは、アプリケーションが CWnd オブジェクトの有効な状態を変更するときに、このメンバー関数を呼び出します。

afx_msg void OnEnable(BOOL bEnable);

パラメーター

bEnable
CWnd オブジェクトが有効か無効かを指定します。このパラメーターは、CWndが有効になっている場合はTRUEされます。CWndが無効になっている場合はFALSEされます。

解説

OnEnable は、 EnableWindow メンバー関数が戻る前に呼び出されますが、ウィンドウが有効な状態 (WS_DISABLED スタイルビット) が変更された後に呼び出されます。

Note

`CWnd::OnEndSession`

フレームワークは、 CWnd オブジェクトが OnQueryEndSession メンバー関数呼び出しから 0 以外の値を返した後、このメンバー関数を呼び出します。

afx_msg void OnEndSession(BOOL bEnding);

パラメーター

bEnding
セッションを終了するかどうかを指定します。セッションが終了している場合は TRUE 。それ以外の場合は FALSE。

解説

OnEndSession呼び出しは、セッションが実際に終了しているかどうかをCWnd オブジェクトに通知します。

bEndingがTRUE場合、すべてのアプリケーションがこの呼び出しの処理から戻った後、Windows はいつでも終了できます。そのため、アプリケーションで、 OnEndSession内の終了に必要なすべてのタスクを実行させます。

セッションの終了時に、 DestroyWindow メンバー関数または windows 関数 PostQuitMessage 呼び出す必要はありません。

Note

`CWnd::OnEnterIdle`

フレームワークは、このメンバー関数を呼び出して、モーダルダイアログボックスまたはメニューがアイドル状態に入っていることをアプリケーションのメインウィンドウプロシージャに通知します。

afx_msg void OnEnterIdle(
    UINT nWhy,
    CWnd* pWho);

パラメーター

nWhy
メッセージがダイアログボックスの結果か、表示されるメニューかを指定します。このパラメーターには、次の値のいずれかを指定できます。

MSGF_DIALOGBOX ダイアログボックスが表示されているため、システムはアイドル状態です。
MSGF_MENU メニューが表示されているため、システムはアイドル状態です。

pWho
ダイアログボックスへのポインター ( nWhy が MSGF_DIALOGBOXの場合)、または表示されるメニューを含むウィンドウ ( nWhy が MSGF_MENUされている場合) を指定します。このポインターは一時的な場合があり、後で使用するために格納しないでください。

解説

モーダルダイアログボックスまたはメニューは、1 つ以上の前のメッセージを処理した後、キューで待機しているメッセージがない場合にアイドル状態になります。

Note

`CWnd::OnEnterMenuLoop`

フレームワークは、メニューモーダルループが入力されたときにこのメンバー関数を呼び出します。

afx_msg void OnEnterMenuLoop(BOOL bIsTrackPopupMenu);

パラメーター

bIsTrackPopupMenu
関連するメニューがポップアップメニューかどうかを指定します。関数が成功した場合は 0 以外の値を持ちます。それ以外の場合は 0。

解説

Note

`CWnd::OnEnterSizeMove`

フレームワークは、影響を受けるウィンドウが移動またはサイズ変更モーダルループに入った後、このメンバー関数を 1 回呼び出します。

afx_msg void OnEnterSizeMove();

解説

このメソッドは、Windows SDK で説明されている WM_ENTERSIZEMOVE 通知を受け取ります。

ユーザーがウィンドウのタイトルバーまたはサイズ設定の境界線をクリックしたとき、またはウィンドウが WM_SYSCOMMAND メッセージを CWnd::DefWindowProc 関数に渡し、そのメッセージの wParam パラメーターが SC_MOVE または SC_SIZEを指定すると、ウィンドウは移動またはサイズ変更のモーダルループに入ります。

Note

`CWnd::OnEraseBkgnd`

フレームワークは、 CWnd オブジェクトの背景で消去が必要な場合 (サイズ変更時など) に、このメンバー関数を呼び出します。

afx_msg BOOL OnEraseBkgnd(CDC* pDC);

パラメーター

pDC
デバイスコンテキストオブジェクトを指定します。

戻り値

背景を消去する場合は 0 以外。それ以外の場合は 0。

解説

無効化された領域を描画用に準備するために呼び出されます。

既定の実装では、ウィンドウクラス構造体の hbrBackground メンバーによって指定されたウィンドウクラスの背景ブラシを使用して、背景が消去されます。

hbrBackgroundメンバーがNULLされている場合、オーバーライドされたバージョンのOnEraseBkgndは背景色を消去する必要があります。バージョンでは、最初にブラシのUnrealizeObjectを呼び出してからブラシを選択することで、目的のブラシの原点をCWnd座標に合わせる必要もあります。

オーバーライドされた OnEraseBkgnd は、メッセージを処理してバックグラウンドを消去する場合、 WM_ERASEBKGND に応答して 0 以外の値を返す必要があります。これは、それ以上消去する必要がないことを示します。 0 が返された場合、ウィンドウは消去する必要があるとしてマークされたままになります。 (通常、これは、PAINTSTRUCT構造体のfErase メンバーがTRUEされることを意味します)。

Windows では、バックグラウンドが MM_TEXT マッピングモードで計算されると想定しています。デバイスコンテキストが他のマッピングモードを使用している場合、消去された領域がクライアント領域の可視部分内にない可能性があります。

Note

`CWnd::OnExitMenuLoop`

メニューモーダルループが終了すると、フレームワークはこのメンバー関数を呼び出します。

afx_msg void OnExitMenuLoop(BOOL bIsTrackPopupMenu);

パラメーター

解説

Note

`CWnd::OnExitSizeMove`

フレームワークは、影響を受けるウィンドウが移動またはサイズ変更モーダルループを終了した後、このメンバー関数を 1 回呼び出します。

afx_msg void OnExitSizeMove();

解説

このメソッドは、Windows SDK で説明されている WM_EXITSIZEMOVE 通知を受け取ります。

ユーザーがウィンドウのタイトルバーまたはサイズ設定の境界線をクリックしたとき、またはウィンドウが WM_SYSCOMMAND メッセージを CWnd::DefWindowProc 関数に渡し、そのメッセージの wParam パラメーターが SC_MOVE または SC_SIZEを指定すると、ウィンドウは移動またはサイズ変更のモーダルループに入ります。

Note

`CWnd::OnFontChange`

システム内のすべての最上位ウィンドウは、アプリケーションがフォントリソースのプールを変更した後、フレームワークから OnFontChange 呼び出しを受け取ります。

afx_msg void OnFontChange();

解説

システムにフォントを追加または削除するアプリケーション (たとえば、 AddFontResource や windows 関数 RemoveFontResource ) は、 WM_FONTCHANGE メッセージをすべての最上位ウィンドウに送信する必要があります。

このメッセージを送信するには、 SendMessage Windows 関数を使用し、 hWnd パラメーターを HWND_BROADCAST に設定します。

`CWnd::OnGetDlgCode`

方向キーおよび Tab キーによる入力そのものをコントロールが処理できるように、そのコントロールに対して呼び出されます。

afx_msg UINT OnGetDlgCode();

戻り値

アプリケーションが処理する入力の種類を示す、次の値のうち 1 つ以上。

DLGC_BUTTON ボタン (汎用)。
DLGC_DEFPUSHBUTTON 既定のプッシュボタン。
DLGC_HASSETSELメッセージを EM_SETSEL します。
DLGC_UNDEFPUSHBUTTON 既定のプッシュボタン処理はありません。 (アプリケーションでは、このフラグを DLGC_BUTTON と共に使用して、ボタン入力を処理するが、既定のプッシュボタン処理にシステムに依存していることを示すことができます)。
DLGC_RADIOBUTTON ラジオボタン。
DLGC_STATIC 静的コントロール。
DLGC_WANTALLKEYS すべてのキーボード入力。
DLGC_WANTARROWS 方向キー。
DLGC_WANTCHARSメッセージを WM_CHAR します。
DLGC_WANTMESSAGE すべてのキーボード入力。アプリケーションは、このメッセージをコントロールに渡します。
DLGC_WANTTAB TAB キー。

解説

通常、Windows では、 CWnd コントロールに対するすべての方向キーと TAB キーの入力が処理されます。 OnGetDlgCodeをオーバーライドすることで、CWnd コントロールは、それ自体を処理する特定の種類の入力を選択できます。

定義済みのコントロールクラスの既定の OnGetDlgCode 関数は、各クラスに適したコードを返します。

`CWnd::OnGetMinMaxInfo`

フレームワークは、最大化された位置またはディメンション、または最小または最大の追跡サイズを Windows が認識する必要がある場合は常に、このメンバー関数を呼び出します。

afx_msg void OnGetMinMaxInfo(MINMAXINFO* lpMMI);

パラメーター

lpMMI
ウィンドウの最大サイズと位置、およびその最小および最大追跡サイズに関する情報を含む MINMAXINFO 構造体を指します。この構造の詳細については、 MINMAXINFO 構造体を参照してください。

解説

最大化されたサイズは、境界線が完全に拡張されたときのウィンドウのサイズです。ウィンドウの最大追跡サイズは、枠を使用してウィンドウのサイズを変更することで実現できる最大のウィンドウサイズです。ウィンドウの最小追跡サイズは、境界線を使用してウィンドウのサイズを変更することで実現できる最小のウィンドウサイズです。

Windows は、さまざまな位置と次元の既定値を指定するポイントの配列を埋めます。アプリケーションは、 OnGetMinMaxInfoでこれらの値を変更する場合があります。

Note

`CWnd::OnHelp`

アプリケーション内で F1 ヘルプを (現在のコンテキストを使って) 処理します。

afx_msg void OnHelp();

解説

詳細については、「 CWinApp::OnHelp 」を参照してください。

`CWnd::OnHelpFinder`

ID_HELP_FINDERコマンドとID_DEFAULT_HELP コマンドを処理します。

afx_msg void OnHelpFinder();

解説

詳細については、「 CWinApp::OnHelpFinder 」を参照してください。

`CWnd::OnHelpIndex`

ID_HELP_INDEX コマンドを処理し、既定のヘルプトピックを提供します。

afx_msg void OnHelpIndex();

解説

詳細については、「 CWinApp::OnHelpIndex 」を参照してください。

`CWnd::OnHelpInfo`

ユーザーが F1 キーを押したときに、フレームワークによって呼び出されます。

afx_msg BOOL OnHelpInfo(HELPINFO* lpHelpInfo);

パラメーター

lpHelpInfo
ヘルプが要求されるメニュー項目、コントロール、ダイアログボックス、またはウィンドウに関する情報を含む HELPINFO 構造体へのポインター。

戻り値

ウィンドウにキーボードフォーカスがある場合、またはウィンドウ内でメニューがアクティブな場合に TRUE を返します。ウィンドウにキーボードフォーカスがない場合は、 FALSEを返します。

解説

F1 キーを押したときにメニューがアクティブな場合、 WM_HELP はメニューに関連付けられているウィンドウに送信されます。それ以外の場合は、キーボードフォーカスがあるウィンドウに WM_HELP が送信されます。キーボードフォーカスを持つウィンドウがない場合、 WM_HELP は現在アクティブなウィンドウに送信されます。

`CWnd::OnHelpUsing`

ID_HELP_USING コマンドを処理します。

afx_msg void OnHelpUsing();

解説

詳細については、「 CWinApp::OnHelpUsing 」を参照してください。

`CWnd::OnHotKey`

フレームワークは、ユーザーがシステム全体のホットキーを押すと、このメンバー関数を呼び出します。

afx_msg void OnHotKey(
    UINT nHotKeyId,
    UINT nKey1,
    UINT nKey2);

パラメーター

nHotKeyId
[in]メッセージを生成したホットキーの識別子。メッセージがシステム定義のホットキーによって生成された場合、このパラメーターは次のいずれかの値になります。

IDHOT_SNAPDESKTOP - スナップデスクトップのホットキーが押されました。
IDHOT_SNAPWINDOW - スナップウィンドウのホットキーが押されました。

nKey1
[in] nKey2 パラメーターで指定されたキーと組み合わせて押されたキーを示すフラグのビットごとの組み合わせ (OR)。指定できる値は、

MOD_ALT - Alt キーが押された。
MOD_CONTROL - Ctrl キーが押されました。
MOD_SHIFT - Shift キーが押されました。
MOD_WIN - いずれかの WINDOWS キーが押されました。これらのキーには、Microsoft Windows ロゴのラベルが付いています。

nKey2
[入力] ホットキーの仮想キーコード。

解説

このメソッドは、Windows SDK で説明されている WM_HOTKEY 通知を受け取ります。このメッセージは、ホットキーを登録したスレッドに関連付けられているメッセージキューの先頭に配置されます。 RegisterHotKey関数を使用して、システム全体のホットキーを登録します。

Note

`CWnd::OnHScroll`

フレームワークは、ユーザーがウィンドウの水平スクロールバーをクリックすると、このメンバー関数を呼び出します。

afx_msg void OnHScroll(
    UINT nSBCode,
    UINT nPos,
    CScrollBar* pScrollBar);

パラメーター

nSBCode
ユーザーのスクロール要求を示すスクロールバーコードを指定します。このパラメーターには、次のいずれかを指定できます。

SB_LEFT 左端までスクロールします。
SB_ENDSCROLL スクロールを終了します。
SB_LINELEFT 左にスクロールします。
SB_LINERIGHT 右にスクロールします。
SB_PAGELEFT 1 ページ左にスクロールします。
SB_PAGERIGHT 1 ページ右にスクロールします。
SB_RIGHT 右端までスクロールします。
SB_THUMBPOSITION 絶対位置までスクロールします。現在の位置は、 nPos パラメーターによって指定されます。
SB_THUMBTRACK スクロールボックスを指定した位置にドラッグします。現在の位置は、 nPos パラメーターによって指定されます。

nPos
スクロールバーコードが SB_THUMBPOSITION または SB_THUMBTRACKの場合は、スクロールボックスの位置を指定します。それ以外の場合は使用されません。初期スクロール範囲によっては、 nPos が負の値になる場合があり、必要に応じて int にキャストする必要があります。

pScrollBar
スクロールメッセージがスクロールバーコントロールから送信された場合は、コントロールへのポインターが含まれます。ユーザーがウィンドウのスクロールバーをクリックした場合、このパラメーターは NULL。ポインターは一時的なものであり、後で使用するために格納しないでください。

解説

SB_THUMBTRACKスクロールバーコードは、通常、スクロールボックスのドラッグ中にフィードバックを提供するアプリケーションで使用されます。

アプリケーションがスクロールバーによって制御されるコンテンツをスクロールする場合は、 SetScrollPos メンバー関数を使用してスクロールボックスの位置もリセットする必要があります。

Note

例

void CMdiView::OnHScroll(UINT nSBCode, UINT nPos, CScrollBar *pScrollBar)
{
   // Get the minimum and maximum scroll-bar positions.
   int minpos;
   int maxpos;
   GetScrollRange(SB_HORZ, &minpos, &maxpos);
   maxpos = GetScrollLimit(SB_HORZ);

   // Get the current position of scroll box.
   int curpos = GetScrollPos(SB_HORZ);

   // Determine the new position of scroll box.
   switch (nSBCode)
   {
   case SB_LEFT: // Scroll to far left.
      curpos = minpos;
      break;

   case SB_RIGHT: // Scroll to far right.
      curpos = maxpos;
      break;

   case SB_ENDSCROLL: // End scroll.
      break;

   case SB_LINELEFT: // Scroll left.
      if (curpos > minpos)
         curpos--;
      break;

   case SB_LINERIGHT: // Scroll right.
      if (curpos < maxpos)
         curpos++;
      break;

   case SB_PAGELEFT: // Scroll one page left.
   {
      // Get the page size.
      SCROLLINFO info;
      GetScrollInfo(SB_HORZ, &info, SIF_ALL);

      if (curpos > minpos)
         curpos = max(minpos, curpos - (int)info.nPage);
   }
   break;

   case SB_PAGERIGHT: // Scroll one page right.
   {
      // Get the page size.
      SCROLLINFO info;
      GetScrollInfo(SB_HORZ, &info, SIF_ALL);

      if (curpos < maxpos)
         curpos = min(maxpos, curpos + (int)info.nPage);
   }
   break;

   case SB_THUMBPOSITION: // Scroll to absolute position. nPos is the position
      curpos = nPos;      // of the scroll box at the end of the drag operation.
      break;

   case SB_THUMBTRACK: // Drag scroll box to specified position. nPos is the
      curpos = nPos;   // position that the scroll box has been dragged to.
      break;
   }

   // Set the new position of the thumb (scroll box).
   SetScrollPos(SB_HORZ, curpos);

   CView::OnHScroll(nSBCode, nPos, pScrollBar);
}

`CWnd::OnHScrollClipboard`

クリップボードの所有者の OnHScrollClipboard メンバー関数は、クリップボードのデータに CF_OWNERDISPLAY 形式があり、クリップボードビューアーの水平スクロールバーにイベントがある場合に、クリップボードビューアーによって呼び出されます。

afx_msg void OnHScrollClipboard(
    CWnd* pClipAppWnd,
    UINT nSBCode,
    UINT nPos);

パラメーター

pClipAppWnd
クリップボードビューアーウィンドウへのポインターを指定します。ポインターは一時的なものであり、後で使用するために格納しないでください。

nSBCode
下位ワードで次のいずれかのスクロールバーコードを指定します。

SB_BOTTOM 右下にスクロールします。
SB_ENDSCROLL スクロールを終了します。
SB_LINEDOWN 1 行下にスクロールします。
SB_LINEUP 1 行上にスクロールします。
SB_PAGEDOWN 1 ページ下にスクロールします。
SB_PAGEUP 1 ページ上にスクロールします。
SB_THUMBPOSITION 絶対位置までスクロールします。現在位置は nPosで提供されます。
SB_TOP 左上までスクロールします。

nPos
スクロールバーコードが SB_THUMBPOSITIONされている場合はスクロールボックスの位置を格納します。それ以外の場合は使用されません。

解説

所有者は、クリップボードイメージをスクロールし、適切なセクションを無効にして、スクロールバーの値を更新する必要があります。

Note

`CWnd::OnIconEraseBkgnd`

アイコンを描画する前にアイコンの背景を塗りつぶす必要がある場合、フレームワークは最小化された (アイコン化された) CWnd オブジェクトに対してこのメンバー関数を呼び出します。

afx_msg void OnIconEraseBkgnd(CDC* pDC);

パラメーター

pDC
アイコンのデバイスコンテキストオブジェクトを指定します。一時的な場合があり、後で使用するために保存しないでください。

解説

CWnd は、ウィンドウの既定の実装に対してクラスアイコンが定義されている場合にのみ、この呼び出しを受け取ります。それ以外の場合は OnEraseBkgnd が呼び出されます。

DefWindowProcメンバー関数は、アイコンの背景を親ウィンドウの背景ブラシで塗りつぶします。

Note

`CWnd::OnInitMenu`

フレームワークは、メニューがアクティブになりそうになったときに、このメンバー関数を呼び出します。

afx_msg void OnInitMenu(CMenu* pMenu);

パラメーター

pMenu
初期化するメニューを指定します。一時的な場合があり、後で使用するために保存しないでください。

解説

OnInitMenu は、ユーザーがメニューバーの項目をクリックするか、メニューキーを押したときに呼び出されます。メニューを表示する前に変更するには、このメンバー関数をオーバーライドします。

OnInitMenu は、メニューが最初にアクセスされたとき (たとえば、ユーザーがメニューバーの項目をクリックした場合) に 1 回だけ呼び出されます。このメソッドでは、メニュー項目に関する情報は提供されません。ユーザーがメニュー内の項目に移動すると (たとえば、複数のメニュー項目にマウスを移動するなどして)、関数は再び呼び出されません。ユーザーがメニューから (たとえば、アプリケーションクライアント領域をクリックして) 終了し、後でメニューバーの項目をクリックすると、関数が再度呼び出されます。

Note

`CWnd::OnInitMenuPopup`

このメンバー関数は、ポップアップメニューがアクティブになりそうになったときに、フレームワークによって呼び出されます。

afx_msg void OnInitMenuPopup(
    CMenu* pPopupMenu,
    UINT nIndex,
    BOOL bSysMenu);

パラメーター

pPopupMenu
ポップアップメニューのメニューオブジェクトを指定します。一時的な場合があり、後で使用するために保存しないでください。

nIndex
メインメニューのポップアップメニューのインデックスを指定します。

bSysMenu
TRUE ポップアップメニューが [コントロール] メニューの場合。それ以外の場合は FALSE。

解説

これにより、アプリケーションは、メニュー全体を変更することなく、ポップアップメニューを表示する前に変更できます。

Note

`CWnd::OnInputDeviceChange`

フレームワークは、I/O デバイスがシステムに追加またはシステムから削除されたときに、このメンバー関数を呼び出します。

afx_msg void OnInputDeviceChange(unsigned short uFlag);

パラメーター

uFlag
[in]このフラグには、次の値を含めることができます。

GIDC_ARRIVAL - 新しいデバイスがシステムに追加されました。
GIDC_REMOVAL - デバイスがシステムから削除されました。

解説

このメソッドは、Windows SDK で説明されている WM_INPUT_DEVICE_CHANGE 通知を受け取ります。これは汎用入力デバイスメッセージです。

Note

`CWnd::OnInputLangChange`

フレームワークは、アプリケーションの入力言語が変更された後、影響を受ける最上位のウィンドウに対してこのメンバーを呼び出します。

afx_msg void OnInputLangChange(
    UINT nCharSet,
    UINT nLocaleId);

パラメーター

nCharSet
[in]新しいロケールの文字セット。詳細については、LOGFONT構造体の lfCharSet パラメーターを参照してください。

nLocaleId
[in]入力ロケール識別子。詳細については、「言語識別子定数と文字列を参照してください。

解説

このメソッドは、Windows SDK で説明されている WM_INPUTLANGCHANGE 通知メッセージを受け取ります。

Note

`CWnd::OnInputLangChangeRequest`

フレームワークは、ユーザーが新しい入力言語を選択したときに、ウィンドウに対してこのメンバーを呼び出します。

afx_msg void OnInputLangChangeRequest(
    UINT nFlags,
    UINT nLocaleId);

パラメーター

nFlags
[in]インストールされているロケールの一覧で前または次のロケールから新しいロケールが選択されたことを示すフラグのビットごとの (OR) の組み合わせ。または、新しい入力ロケールのキーボードレイアウトをシステム文字セットと共に使用できます。 INPUTLANGCHANGE_BACKWARD、INPUTLANGCHANGE_FORWARD、INPUTLANGCHANGE_SYSCHARSET のいずれかが指定されます。

nLocaleId
[in]入力ロケール識別子。詳細については、「言語識別子定数と文字列を参照してください。

解説

このメソッドは、Windows SDK で説明されている WM_INPUTLANGCHANGEREQUEST 通知メッセージを受け取ります。このメッセージは、ユーザーがキーボードコントロールパネルアプリケーションで指定されたホットキーまたはシステムタスクバーのインジケーターで新しい入力言語を選択したときに投稿されます。

Note

`CWnd::OnKeyDown`

フレームワークは、非システムキーが押されたときにこのメンバー関数を呼び出します。

afx_msg void OnKeyDown(
    UINT nChar,
    UINT nRepCnt,
    UINT nFlags);

パラメーター

nChar
指定されたキーの仮想キーコードを指定します。標準的な仮想キーコードの一覧については、Winuser.h を参照してください。

nRepCnt
繰り返しカウント (ユーザーがキーを押した結果としてキーストロークが繰り返される回数)。

nFlags
次の一覧に示すように、スキャンコード、キー遷移コード、以前のキー状態、コンテキストコードを指定します。

値	説明
0-7	スキャンコード (OEM に依存する値)。
8	拡張キー (ファンクションキーやテンキーのキーなど) (拡張キーの場合は 1)。
9 から 10	未使用。
11-12	Windows によって内部的に使用されます。
13	コンテキストコード (キーが押されている間に Alt キーが押されている場合は 1、それ以外の場合は 0)。
14	以前のキーの状態 (キーが呼び出しの前にダウンしている場合は 1、キーがアップの場合は 0)。
15	遷移状態 (キーが解放されている場合は 1、キーが押されている場合は 0)。

WM_KEYDOWN メッセージの場合、キー遷移ビット (ビット 15) は 0、コンテキストコードビット (ビット 13) は 0 です。

解説

非システムキーとは、Alt キーが押されていないときに押されたキーボードキー、または入力フォーカスがある場合に押 CWnd キーボードキーです。

自動繰り返しのため、OnKeyUp メンバー関数呼び出しが行われる前に、複数のOnKeyDown呼び出しが発生する可能性があります。前のキー状態を示すビットを使用して、 OnKeyDown 呼び出しが最初のダウン遷移か、繰り返しダウン遷移かを判断できます。

Note

`CWnd::OnKeyUp`

フレームワークは、非システムキーが解放されたときにこのメンバー関数を呼び出します。

afx_msg void OnKeyUp(
    UINT nChar,
    UINT nRepCnt,
    UINT nFlags);

パラメーター

nChar
指定されたキーの仮想キーコードを指定します。標準の仮想キーコードの一覧については、 Winuser.h

nRepCnt
繰り返しカウント (ユーザーがキーを押した結果としてキーストロークが繰り返される回数)。

nFlags
次の一覧に示すように、スキャンコード、キー遷移コード、以前のキー状態、コンテキストコードを指定します。

値	説明
0-7	スキャンコード (OEM に依存する値)。上位ワードの下位バイト。
8	拡張キー (ファンクションキーやテンキーのキーなど) (拡張キーの場合は 1、それ以外の場合は 0)。
9 から 10	未使用。
11-12	Windows によって内部的に使用されます。
13	コンテキストコード (キーが押されている間に Alt キーが押されている場合は 1、それ以外の場合は 0)。
14	以前のキーの状態 (キーが呼び出しの前にダウンしている場合は 1、キーがアップの場合は 0)。
15	遷移状態 (キーが解放されている場合は 1、キーが押されている場合は 0)。

WM_KEYUP メッセージの場合、キー遷移ビット (ビット 15) は 1、コンテキストコードビット (ビット 13) は 0 です。

解説

非システムキーとは、alt キーが押されていないときに押されたキーボードキー、または入力フォーカスが CWnd のときに押されるキーボードキーです。

IBM Enhanced 101 キーおよび 102 キー・キーボードの場合、拡張キーはキーボードのメイン・セクションの右 ALT キーと右 CTRL キーです。テンキーの左側にあるクラスター内の INS、DEL、HOME、END、PAGE UP、PAGE DOWN、および方向キー。テンキーのスラッシュ (/) キーと Enter キーを使用します。他の一部のキーボードでは、 nFlags の拡張キービットがサポートされている場合があります。

Note

`CWnd::OnKillFocus`

フレームワークは、入力フォーカスを失う直前にこのメンバー関数を呼び出します。

afx_msg void OnKillFocus(CWnd* pNewWnd);

パラメーター

pNewWnd
入力フォーカスを受け取るウィンドウへのポインターを指定します ( NULL または一時的な場合があります)。

解説

CWnd オブジェクトにキャレットが表示されている場合は、この時点でキャレットを破棄する必要があります。

Note

`CWnd::OnLButtonDblClk`

フレームワークは、ユーザーがマウスの左ボタンをダブルクリックすると、このメンバー関数を呼び出します。

afx_msg void OnLButtonDblClk(
    UINT nFlags,
    CPoint point);

パラメーター

nFlags
さまざまな仮想キーが下がっているかどうかを示します。このパラメータには、次の値を任意に組み合わせて指定できます:

MK_CONTROL Ctrl キーがダウンしている場合に設定します。
MK_LBUTTON マウスの左ボタンが下にある場合に設定します。
MK_MBUTTON マウスの中央ボタンが下にある場合に設定します。
MK_RBUTTON マウスの右ボタンが下にある場合に設定します。
MK_SHIFT Shift キーがダウンしている場合に設定します。

point
カーソルの x 座標と y 座標を指定します。これらの座標は、常にウィンドウの左上隅を基準にしています。

解説

CS_DBLCLKS WNDCLASS スタイルのウィンドウのみがOnLButtonDblClk呼び出しを受け取ります。これは、Microsoft Foundation Class ウィンドウの既定値です。 Windows は、ユーザーがシステムのダブルクリック時間制限内でマウスの左ボタンをもう一度押し、離してから押したときに OnLButtonDblClk を呼び出します。マウスの左ボタンをダブルクリックすると、実際には、 WM_LBUTTONDOWN、 WM_LBUTTONUP メッセージ、 WM_LBUTTONDBLCLK 呼び出し、ボタンが離されたときに別の WM_LBUTTONUP メッセージの 4 つのイベントが生成されます。

Note

`CWnd::OnLButtonDown`

フレームワークは、ユーザーがマウスの左ボタンを押すと、このメンバー関数を呼び出します。

afx_msg void OnLButtonDown(
    UINT nFlags,
    CPoint point);

パラメーター

nFlags
さまざまな仮想キーが下がっているかどうかを示します。このパラメータには、次の値を任意に組み合わせて指定できます:

MK_CONTROL Ctrl キーがダウンしている場合に設定します。
MK_LBUTTON マウスの左ボタンが下にある場合に設定します。
MK_MBUTTON マウスの中央ボタンが下にある場合に設定します。
MK_RBUTTON マウスの右ボタンが下にある場合に設定します。
MK_SHIFT Shift キーがダウンしている場合に設定します。

point
カーソルの x 座標と y 座標を指定します。これらの座標は、常にウィンドウの左上隅を基準にしています。

解説

Note

`CWnd::OnLButtonUp`

フレームワークは、ユーザーがマウスの左ボタンを離すと、このメンバー関数を呼び出します。

afx_msg void OnLButtonUp(
    UINT nFlags,
    CPoint point);

パラメーター

nFlags
さまざまな仮想キーが下がっているかどうかを示します。このパラメータには、次の値を任意に組み合わせて指定できます:

MK_CONTROL Ctrl キーがダウンしている場合に設定します。
MK_MBUTTON マウスの中央ボタンが下にある場合に設定します。
MK_RBUTTON マウスの右ボタンが下にある場合に設定します。
MK_SHIFT Shift キーがダウンしている場合に設定します。

point
カーソルの x 座標と y 座標を指定します。これらの座標は、常にウィンドウの左上隅を基準にしています。

解説

Note

`CWnd::OnMButtonDblClk`

フレームワークは、ユーザーがマウスの中央ボタンをダブルクリックすると、このメンバー関数を呼び出します。

afx_msg void OnMButtonDblClk(
    UINT nFlags,
    CPoint point);

パラメーター

nFlags
さまざまな仮想キーが下がっているかどうかを示します。このパラメータには、次の値を任意に組み合わせて指定できます:

MK_CONTROL Ctrl キーがダウンしている場合に設定します。
MK_LBUTTON マウスの左ボタンが下にある場合に設定します。
MK_MBUTTON マウスの中央ボタンが下にある場合に設定します。
MK_RBUTTON マウスの右ボタンが下にある場合に設定します。
MK_SHIFT Shift キーがダウンしている場合に設定します。

point
カーソルの x 座標と y 座標を指定します。これらの座標は、常にウィンドウの左上隅を基準にしています。

解説

CS_DBLCLKS WNDCLASS スタイルのウィンドウのみがOnMButtonDblClk呼び出しを受け取ります。これは、すべての Microsoft Foundation Class ウィンドウの既定値です。 Windows では、ユーザーがマウスの中央ボタンを押し、離してから、システムのダブルクリック制限内でもう一度マウスの中央ボタンを押すと、 OnMButtonDblClk 呼び出しが生成されます。マウスの中央ボタンをダブルクリックすると、実際には、メッセージの WM_MBUTTONDOWN と WM_MBUTTONUP 、 WM_MBUTTONDBLCLK 呼び出し、別の WM_MBUTTONUP メッセージの 4 つのイベントが生成されます。

Note

`CWnd::OnMButtonDown`

フレームワークは、ユーザーがマウスの中央ボタンを押すと、このメンバー関数を呼び出します。

afx_msg void OnMButtonDown(
    UINT nFlags,
    CPoint point);

パラメーター

nFlags
さまざまな仮想キーが下がっているかどうかを示します。このパラメータには、次の値を任意に組み合わせて指定できます:

MK_CONTROL Ctrl キーがダウンしている場合に設定します。
MK_LBUTTON マウスの左ボタンが下にある場合に設定します。
MK_MBUTTON マウスの中央ボタンが下にある場合に設定します。
MK_RBUTTON マウスの右ボタンが下にある場合に設定します。
MK_SHIFT Shift キーがダウンしている場合に設定します。

point
カーソルの x 座標と y 座標を指定します。これらの座標は、常にウィンドウの左上隅を基準にしています。

解説

Note

`CWnd::OnMButtonUp`

フレームワークは、ユーザーがマウスの中央ボタンを離すと、このメンバー関数を呼び出します。

afx_msg void OnMButtonUp(
    UINT nFlags,
    CPoint point);

パラメーター

nFlags
さまざまな仮想キーが下がっているかどうかを示します。このパラメータには、次の値を任意に組み合わせて指定できます:

MK_CONTROL Ctrl キーがダウンしている場合に設定します。
MK_LBUTTON マウスの左ボタンが下にある場合に設定します。
MK_RBUTTON マウスの右ボタンが下にある場合に設定します。
MK_SHIFT Shift キーがダウンしている場合に設定します。

point
カーソルの x 座標と y 座標を指定します。これらの座標は、常にウィンドウの左上隅を基準にしています。

解説

Note

`CWnd::OnMDIActivate`

フレームワークは、非アクティブ化されている子ウィンドウとアクティブ化されている子ウィンドウに対して、このメンバー関数を呼び出します。

afx_msg void OnMDIActivate(
    BOOL bActivate,
    CWnd* pActivateWnd,
    CWnd* pDeactivateWnd);

パラメーター

bActivate
TRUE 子がアクティブ化されている場合は、非アクティブ化されている場合は FALSE 。

pActivateWnd
アクティブ化する MDI 子ウィンドウへのポインターが含まれています。 MDI 子ウィンドウが受け取った場合、 pActivateWnd にはアクティブ化されている子ウィンドウへのポインターが含まれます。このポインターは一時的な場合があり、後で使用するために格納しないでください。

pDeactivateWnd
非アクティブ化されている MDI 子ウィンドウへのポインターが含まれています。このポインターは一時的な場合があり、後で使用するために格納しないでください。

解説

MDI 子ウィンドウは、MDI フレームウィンドウとは別にアクティブ化されます。フレームがアクティブになると、 OnMDIActivate 呼び出しで最後にアクティブ化された子ウィンドウは、アクティブなウィンドウフレームとキャプションバーを描画する WM_NCACTIVATE メッセージを受信しますが、別の OnMDIActivate 呼び出しを受け取りません。

Note

`CWnd::OnMeasureItem`

フレームワークは、コントロールの作成時に、所有者描画ボタン、コンボボックス、リストボックス、またはメニュー項目の所有者に対して、フレームワークによってこのメンバー関数を呼び出します。

afx_msg void OnMeasureItem(
    int nIDCtl, LPMEASUREITEMSTRUCT lpMeasureItemStruct);

パラメーター

nIDCtl
コントロールの ID。

lpMeasureItemStruct
所有者描画コントロールのディメンションを含む MEASUREITEMSTRUCT データ構造を指します。

解説

このメンバー関数をオーバーライドし、lpMeasureItemStructと戻り値が指すMEASUREITEMSTRUCTデータ構造を入力します。これにより、コントロールのディメンションが Windows に通知され、Windows がコントロールとのユーザー操作を正しく処理できるようになります。

リストボックスまたはコンボボックスが LBS_OWNERDRAWVARIABLE または CBS_OWNERDRAWVARIABLE スタイルで作成された場合、フレームワークはコントロール内の各項目の所有者に対してこの関数を呼び出します。それ以外の場合、この関数は 1 回呼び出されます。

Windows は、WM_INITDIALOG メッセージを送信する前に、OWNERDRAWFIXED スタイルで作成されたコンボボックスとリストボックスの所有者のOnMeasureItemの呼び出しを開始します。その結果、所有者がこの呼び出しを受け取ったとき、Windows はコントロールで使用されるフォントの高さと幅をまだ決定していません。これらの値を必要とする関数呼び出しと計算は、アプリケーションまたはライブラリのメイン関数で行う必要があります。

測定対象の項目が CMenu、 CListBox 、または CComboBox オブジェクトの場合は、適切なクラスの MeasureItem 仮想関数が呼び出されます。適切なコントロールのクラスの MeasureItem メンバー関数をオーバーライドして、各項目のサイズを計算および設定します。

OnMeasureItem は、実行時にコントロールのクラスが作成された場合、または LBS_OWNERDRAWVARIABLE または CBS_OWNERDRAWVARIABLE スタイルで作成された場合にのみ呼び出されます。ダイアログエディターによってコントロールが作成された場合、 OnMeasureItem は呼び出されません。これは、 WM_MEASUREITEM メッセージがコントロールの作成プロセスの早い段階で送信されるためです。 DDX_Control、SubclassDlgItem、またはSubclassWindowを使用してサブクラス化する場合、サブクラス化は通常、作成プロセスの後に行われます。そのため、MFC がON_WM_MEASUREITEM_REFLECTを実装するために使用するメカニズムである、コントロールのOnChildNotify関数でWM_MEASUREITEM メッセージを処理する方法はありません。

Note

`CWnd::OnMenuChar`

フレームワークは、ユーザーが現在のメニューの定義済みのニーモニックのいずれにも一致しないメニューニーモニック文字を押すと、このメンバー関数を呼び出します。

afx_msg LRESULT OnMenuChar(
    UINT nChar,
    UINT nFlags,
    CMenu* pMenu);

パラメーター

nChar
ビルド設定に応じて、ユーザーが押した ANSI 文字または Unicode 文字を指定します。

nFlags
メニューがポップアップメニューの場合は、 MF_POPUP フラグが含まれます。メニューがコントロールメニューの場合は、 MF_SYSMENU フラグが含まれます。

pMenu
選択した CMenuへのポインターを格納します。ポインターは一時的なものであり、格納しないでください。

戻り値

戻り値の上位ワードには、次のいずれかのコマンドコードが含まれている必要があります。

値	説明
0	ユーザーが押した文字を破棄し、システムスピーカーに短いビープ音を作成するように Windows に指示します。
1	現在のメニューを閉じるよう Windows に指示します。
2	戻り値の下位ワードに特定の項目の項目番号が含まれていることを Windows に通知します。この項目は Windows によって選択されます。

上位ワードに 0 または 1 が含まれている場合、下位ワードは無視されます。アプリケーションは、アクセラレータ (ショートカット) キーを使用してメニューに配置されたビットマップを選択するときに、このメッセージを処理する必要があります。

解説

メニューを所有する CWnd に送信されます。 OnMenuChar は、キーがニーモニック文字に対応していない場合でも、ユーザーが Alt キーやその他のキーを押したときにも呼び出されます。この場合、 pMenu は CWndが所有するメニューを指し、 nFlags は 0 です。

Note

`CWnd::OnMenuDrag`

フレームワークは、ユーザーがメニュー項目のドラッグを開始すると、現在のドラッグアンドドロップメニューのこのメンバー関数を呼び出します。

afx_msg UINT OnMenuDrag(
    UINT nPos,
    CMenu* pMenu);

パラメーター

nPos
[in]ドラッグ操作の開始時のメニュー項目のインデックス位置。

pMenu
[in]メニュー項目を含む CMenu オブジェクトへのポインター。

戻り値

戻り値	意味
`MND_CONTINUE`	メニューはアクティブなままです。マウスが離された場合は無視する必要があります。
`MND_ENDMENU`	メニューは終了する必要があります。

解説

このメソッドは、Windows SDK で説明されている WM_MENUDRAG 通知を受け取ります。

Note

`CWnd::OnMenuGetObject`

マウスカーソルがメニュー項目に入ったとき、または項目の中央から項目の上部または下部に移動すると、フレームワークは現在のドラッグアンドドロップメニューのこのメンバー関数を呼び出します。

afx_msg UINT OnMenuGetObject(MENUGETOBJECTINFO* pMenuGetObjectInfo);

パラメーター

pMenu
[in]マウスカーソルが配置されているドラッグアンドドロップメニューに関する情報を含む MENUGETOBJECTINFO 構造体へのポインター。

戻り値

戻り値	意味
`MNGO_NOERROR`	ドロップアンドドラッグ操作をサポートするインターフェイスポインターは、`MENUGETOBJECTINFO`構造体の`pvObj` メンバーで返されます。現時点では、 `IDropTarget` インターフェイスのみがサポートされています。
`MNGO_NOINTERFACE`	ドロップアンドドラッグインターフェイスはサポートされていません。

解説

このメソッドは、Windows SDK で説明されている WM_MENUGETOBJECT 通知を受け取ります。

Note

`CWnd::OnMenuRButtonUp`

ユーザーがメニュー項目にカーソルを置いている間にマウスの右ボタンを離すと、フレームワークはこのメンバー関数を呼び出します。

afx_msg void OnMenuRButtonUp(
    UINT nPos,
    CMenu* pMenu);

パラメーター

nPos
[in]マウスの右ボタンが離されたときのメニュー項目のインデックス位置。

pMenu
[in]メニュー項目を含む CMenu オブジェクトへのポインター。

解説

このメソッドは、Windows SDK で説明されている WM_MENURBUTTONUP 通知を受け取ります。 WM_MENURBUTTONUP メッセージを使用すると、アプリケーションはメッセージで指定されたメニュー項目の状況依存メニューを提供できます。

Note

`CWnd::OnMenuSelect`

CWnd オブジェクトがメニューに関連付けられている場合、OnMenuSelectは、ユーザーがメニュー項目を選択したときにフレームワークによって呼び出されます。

afx_msg void OnMenuSelect(
    UINT nItemID,
    UINT nFlags,
    HMENU hSysMenu);

パラメーター

nItemID
選択した項目を識別します。選択した項目がメニュー項目の場合、 nItemID にはメニュー項目 ID が含まれます。選択した項目にポップアップメニューが含まれている場合、 nItemID にはポップアップメニューインデックスが含まれており、 hSysMenu にはメイン (クリックオン) メニューのハンドルが含まれます。

nFlags
次のメニューフラグの組み合わせが含まれています。

MF_BITMAP 項目はビットマップです。
MF_CHECKED 項目がチェックされます。
MF_DISABLED アイテムが無効です。
MF_GRAYED 項目が淡色表示になっています。
MF_MOUSESELECT 項目がマウスで選択されました。
MF_OWNERDRAW アイテムは所有者描画アイテムです。
MF_POPUP 項目にポップアップメニューが含まれています。
MF_SEPARATOR 項目はメニュー項目の区切り記号です。
MF_SYSMENU 項目は[コントロール]メニューに含まれています。

hSysMenu
nFlagsにMF_SYSMENUが含まれている場合は、メッセージに関連付けられているメニューを識別します。 nFlagsにMF_POPUPが含まれている場合は、メインメニューのハンドルを識別します。 nFlagsにMF_SYSMENUもMF_POPUPも含まれている場合は使用されません。

解説

nFlags0xFFFFが含まれており、hSysMenuに 0 が含まれている場合、ユーザーが Esc キーを押すか、メニューの外側をクリックしたため、Windows によってメニューが閉じられました。

Note

`CWnd::OnMouseActivate`

このメンバー関数は、カーソルが非アクティブウィンドウにあり、ユーザーがマウスボタンを押したときに呼び出されます。

afx_msg int OnMouseActivate(
    CWnd* pDesktopWnd,
    UINT nHitTest,
    UINT message);

パラメーター

pDesktopWnd
アクティブ化されるウィンドウのトップレベルの親ウィンドウへのポインターが指定されます。ポインターは一時的なものであり、格納しないでください。

nHitTest
hit-test面番号を指定します。ヒットテストは、カーソルの位置を判断するテストです。

message
マウスのメッセージ番号が指定されます。

戻り値

CWndをアクティブにするかどうか、およびマウスイベントを破棄するかどうかを指定します。次のいずれかの値を指定する必要があります。

MA_ACTIVATE オブジェクト CWnd アクティブ化します。
MA_NOACTIVATE オブジェクト CWnd アクティブ化しないでください。
MA_ACTIVATEANDEAT オブジェクト CWnd アクティブ化し、マウスイベントを破棄します。
MA_NOACTIVATEANDEAT オブジェクト CWnd アクティブ化せず、マウスイベントを破棄します。

解説

既定の実装では、処理が行われる前に、このメッセージが親ウィンドウに渡されます。親ウィンドウが TRUE を返す場合、処理は停止します。

個々のヒットテストエリアコードの説明については、 OnNcHitTest メンバー関数を参照してください。

Note

例

// The code fragment below shows how to UI activate an ActiveX control.
// CMyAxCtrl is a COleControl-derived class.
int CMyAxCtrl::OnMouseActivate(CWnd *pDesktopWnd, UINT nHitTest, UINT message)
{
   OnActivateInPlace(TRUE, NULL); // OnActivateInPlace() is an undocumented function
   return COleControl::OnMouseActivate(pDesktopWnd, nHitTest, message);
}

`CWnd::OnMouseHover`

フレームワークは、 TrackMouseEventの前の呼び出しで指定された期間、ウィンドウのクライアント領域にカーソルを置いたときに、このメンバー関数を呼び出します。

afx_msg void OnMouseHover(
    UINT nFlags,
    CPoint point);

パラメーター

nFlags
[in]押される修飾子キーを示すフラグのビットごとの組み合わせ (OR)。たとえば、 MK_CONTROL フラグは、Ctrl キーが押されていることを示します。

point
[in]クライアント領域の左上隅を基準にしたカーソルのxおよびy座標を指定するCPoint オブジェクト。

解説

このメソッドは、Windows SDK で説明されている WM_MOUSEHOVER 通知を受け取ります。

nFlags パラメーターには、次の表に示す修飾子キーの組み合わせを指定できます。詳細については、「マウス入力についてを参照してください。

修飾子キー	説明
`MK_CONTROL`	Ctrl キーが押されます。
`MK_LBUTTON`	マウスの左ボタンが押されています。
`MK_MBUTTON`	マウスの中央ボタンが押されています。
`MK_RBUTTON`	マウスの右ボタンが押されています。
`MK_SHIFT`	Shift キーが押されます。
`MK_XBUTTON1`	Microsoft IntelliMouse の `XBUTTON1` マウスボタンが押されます。
`MK_XBUTTON2`	Microsoft IntelliMouse の `XBUTTON2` マウスボタンが押されます。

Note

`CWnd::OnMouseHWheel`

フレームワークは、マウスの水平スクロールホイールが傾いているか回転したときに、このメンバーを呼び出します。

afx_msg void OnMouseHWheel(
    UINT nFlags,
    short zDelta,
    CPoint pt);

パラメーター

nFlags
[in]押される修飾子キーを示すフラグのビットごとの組み合わせ (OR)。たとえば、 MK_CONTROL フラグは、Ctrl キーが押されていることを示します。フラグの一覧については、「マウス入力について」の「メッセージパラメーター」小見出しを参照してください。

zDelta
[in]ホイールが回転する距離を示します。 WHEEL_DELTAの倍数または分割 (120) で表されます。正の値は、ホイールが右に回転したことを示します。負の値は、ホイールが左に回転したことを示します。

pt
[in]クライアント領域の左上隅を基準にしたカーソルのxおよびy座標を指定するCPoint オブジェクト。

解説

このメソッドは、Windows SDK で説明されている WM_MOUSEHWHEEL 通知メッセージを受け取ります。このメッセージは、マウスの水平スクロールホイールが傾いているか回転したときにフォーカスがあるウィンドウに送信されます。

Note

`CWnd::OnMouseLeave`

フレームワークは、 TrackMouseEventの前の呼び出しで指定されたウィンドウのクライアント領域からカーソルが離れると、このメンバー関数を呼び出します。

afx_msg void OnMouseLeave();

解説

このメソッドは、Windows SDK で説明されている WM_MOUSELEAVE 通知を受け取ります。

Note

`CWnd::OnMouseMove`

フレームワークは、マウスカーソルが移動したときにこのメンバー関数を呼び出します。

afx_msg void OnMouseMove(
    UINT nFlags,
    CPoint point);

パラメーター

nFlags
さまざまな仮想キーが下がっているかどうかを示します。このパラメータには、次の値を任意に組み合わせて指定できます:

MK_CONTROL Ctrl キーがダウンしている場合に設定します。
MK_LBUTTON マウスの左ボタンが下にある場合に設定します。
MK_MBUTTON マウスの中央ボタンが下にある場合に設定します。
MK_RBUTTON マウスの右ボタンが下にある場合に設定します。
MK_SHIFT Shift キーがダウンしている場合に設定します。

point
カーソルの x 座標と y 座標を指定します。これらの座標は、常にウィンドウの左上隅を基準にしています。

解説

マウスがキャプチャされていない場合、 WM_MOUSEMOVE メッセージはマウスカーソルの下にある CWnd オブジェクトによって受信されます。それ以外の場合、メッセージはマウスをキャプチャしたウィンドウに移動します。

Note

`CWnd::OnMouseWheel`

フレームワークは、ユーザーがマウスホイールを回転させ、ホイールの次の切り欠きを検出すると、このメンバー関数を呼び出します。

afx_msg BOOL OnMouseWheel(
    UINT nFlags,
    short zDelta,
    CPoint pt);

パラメーター

nFlags
さまざまな仮想キーが下がっているかどうかを示します。このパラメータには、次の値を任意に組み合わせて指定できます:

MK_CONTROL Ctrl キーがダウンしている場合に設定します。
MK_LBUTTON マウスの左ボタンが下にある場合に設定します。
MK_MBUTTON マウスの中央ボタンが下にある場合に設定します。
MK_RBUTTON マウスの右ボタンが下にある場合に設定します。
MK_SHIFT Shift キーがダウンしている場合に設定します。

zDelta
回転する距離を示します。 zDelta値は、WHEEL_DELTAの倍数または分割 (120) で表されます。 0 より小さい値は (ユーザーに向かって) 戻って回転することを示し、0 より大きい値は (ユーザーから離れて) 前方に回転することを示します。ユーザーは、マウスソフトウェアで Wheel の設定を変更することで、この応答を元に戻すことができます。このパラメーターの詳細については、「解説」を参照してください。

pt
カーソルの x 座標と y 座標を指定します。これらの座標は、常に画面の左上隅を基準にしています。

戻り値

マウスホイールのスクロールが有効な場合は 0 以外。それ以外の場合は 0。

解説

オーバーライドされない限り、 OnMouseWheel は既定値の WM_MOUSEWHEEL を呼び出します。 Windows は、フォーカスがあるコントロールまたは子ウィンドウにメッセージを自動的にルーティングします。 Win32 関数 DefWindowProc 、メッセージを処理するウィンドウに親チェーンの上に伝達します。

zDelta パラメーターは、120 に設定されたWHEEL_DELTAの倍数です。この値は、実行されるアクションのしきい値であり、デルタごとに 1 つのアクション (たとえば、1 つのノッチを前方にスクロールする) が発生する必要があります。

WHEEL_DELTA を120に設定し、切り欠きのない自由に回転するホイールなど、より細かい解像度のホイールを可能にしました。より細かい解像度のホイールでは、ローテーションごとに送信されるメッセージが多くなりますが、各メッセージのデルタ値は小さくなります。このようなホイールを使用するには、WHEEL_DELTAに達するまで受信zDelta値を追加するか (特定のデルタ回転に対して同じ応答を得るように)、より頻繁なメッセージに応答して部分的な行をスクロールします。スクロールの粒度を選択し、 WHEEL_DELTA に達するまで差分を累積することもできます。

独自のマウスホイールスクロール動作を提供するには、このメンバー関数をオーバーライドします。

Note

OnMouseWheel は、Windows NT 4.0 以降のバージョンのメッセージを処理します。 Windows 95/98 または Windows NT 3.51 メッセージ処理の場合は、 OnRegisteredMouseWheelを使用します。

`CWnd::OnMove`

フレームワークは、 CWnd オブジェクトが移動された後、このメンバー関数を呼び出します。

afx_msg void OnMove(
    int x,
    int y);

パラメーター

x
クライアント領域の左上隅の新しい x 座標位置を指定します。この新しい場所は、重なり合うウィンドウとポップアップウィンドウの画面座標と、子ウィンドウの親クライアント座標で指定されます。

y
クライアント領域の左上隅の新しい y 座標位置を指定します。この新しい場所は、重なり合うウィンドウとポップアップウィンドウの画面座標と、子ウィンドウの親クライアント座標で指定されます。

解説

Note

`CWnd::OnMoving`

フレームワークは、ユーザーが CWnd オブジェクトを移動しているときに、このメンバー関数を呼び出します。

afx_msg void OnMoving(
    UINT nSide,
    LPRECT lpRect);

パラメーター

nSide
移動するウィンドウの端。

lpRect
アイテムの座標を含む CRect または RECT 構造体のアドレス。

解説

Note

`CWnd::OnNcActivate`

フレームワークは、非クライアント領域を変更してアクティブまたは非アクティブ状態を示す必要がある場合に、このメンバー関数を呼び出します。

afx_msg BOOL OnNcActivate(BOOL bActive);

パラメーター

bActive
アクティブまたは非アクティブな状態を示すためにキャプションバーまたはアイコンを変更する必要があるタイミングを指定します。 bActiveパラメーターは、アクティブなキャプションまたはアイコンを描画する場合にTRUEされます。非アクティブなキャプションまたはアイコンの FALSE 。

戻り値

Windows が既定の処理を続行する必要がある場合は 0 以外。キャプションバーまたはアイコンが非アクティブ化されないようにするには、0 を指定します。

解説

既定の実装では、 bActive が TRUE されている場合はアクティブな色で、 bActive が FALSEされている場合は非アクティブな色で、タイトルバーとタイトルバーのテキストが描画されます。

Note

`CWnd::OnNcCalcSize`

フレームワークは、クライアント領域のサイズと位置を計算する必要がある場合に、このメンバー関数を呼び出します。

afx_msg void OnNcCalcSize(
    BOOL bCalcValidRects,
    NCCALCSIZE_PARAMS* lpncsp);

パラメーター

bCalcValidRects
アプリケーションがクライアント領域のどの部分に有効な情報を含めるかを指定するかどうかを指定します。 Windows は、新しいクライアント領域内の指定された領域に有効な情報をコピーします。このパラメーターが TRUE の場合、アプリケーションはクライアント領域のどの部分が有効であるかを指定する必要があります。

lpncsp
アプリケーションがCWnd四角形の新しいサイズと位置 (クライアント領域、罫線、キャプション、スクロールバーなど) の計算に使用できる情報を含むNCCALCSIZE_PARAMSデータ構造を指します。

解説

このメッセージを処理することで、アプリケーションは、ウィンドウのサイズまたは位置が変更されたときに、ウィンドウのクライアント領域の内容を制御できます。

bCalcValidRectsの値に関係なく、NCCALCSIZE_PARAMS構造体のrgrc構造体メンバーによって指定された配列の最初の四角形には、ウィンドウの座標が含まれます。子ウィンドウの場合、座標は親ウィンドウのクライアント領域を基準にしています。トップレベルウィンドウの場合、座標は画面座標です。アプリケーションは、クライアント領域のサイズと位置を反映するように rgrc[0] 四角形を変更する必要があります。

rgrc[1]とrgrc[2]の四角形は、bCalcValidRectsがTRUEされている場合にのみ有効です。この場合、 rgrc[1] 四角形には、移動またはサイズ変更される前のウィンドウの座標が含まれます。 rgrc[2]四角形には、ウィンドウが移動される前のウィンドウのクライアント領域の座標が含まれています。すべての座標は、親ウィンドウまたは画面に対して相対的です。

既定の実装では、ウィンドウの特性 (スクロールバーやメニューなど) に基づいてクライアント領域のサイズが計算され、結果が lpncspされます。

Note

`CWnd::OnNcCreate`

フレームワークは、CWnd オブジェクトが最初に作成されるときに、WM_CREATE メッセージの前にこのメンバー関数を呼び出します。

afx_msg BOOL OnNcCreate(LPCREATESTRUCT lpCreateStruct);

パラメーター

lpCreateStruct
CWndのCREATESTRUCTデータ構造をポイントします。

戻り値

非クライアント領域が作成される場合は 0 以外。エラーが発生した場合は 0 です。この場合、 Create 関数は failure を返します。

解説

Note

`CWnd::OnNcDestroy`

非クライアント領域が破棄されるときにフレームワークによって呼び出され、Windows ウィンドウが破棄されたときに呼び出される最後のメンバー関数です。

afx_msg void OnNcDestroy();

解説

既定の実装では、クリーンアップが実行され、仮想メンバー関数 PostNcDestroyが呼び出されます。

delete this操作など、独自のクリーンアップを実行する場合は、PostNcDestroyをオーバーライドします。 OnNcDestroyをオーバーライドする場合は、基本クラスでOnNcDestroyを呼び出して、ウィンドウに内部的に割り当てられたメモリが解放されるようにする必要があります。

`CWnd::OnNcHitTest`

フレームワークは、マウスが移動されるたびに、カーソルを含むCWnd オブジェクト (または、SetCapture メンバー関数を使用してマウス入力をキャプチャしたCWnd オブジェクト) に対してこのメンバー関数を呼び出します。

afx_msg LRESULT OnNcHitTest(CPoint point);

パラメーター

point
カーソルの x 座標と y 座標を格納します。これらの座標は常に画面座標です。

戻り値

マウスヒットテスト列挙値の 1 つ。値の一覧については、 WM_NCHITTEST を参照してください。

解説

Note

`CWnd::OnNcLButtonDblClk`

ユーザーがマウスの左ボタンをダブルクリックし、カーソルが CWndの非クライアント領域内にあるときに、フレームワークはこのメンバー関数を呼び出します。

afx_msg void OnNcLButtonDblClk(
    UINT nHitTest,
    CPoint point);

パラメーター

nHitTest
hit-test コードを指定します。ヒットテストは、カーソルの位置を判断するテストです。値の一覧については、 WM_NCHITTEST を参照してください。

point
カーソル位置の x および y 画面座標を含む CPoint オブジェクトを指定します。これらの座標は、常に画面の左上隅を基準にしています。

解説

必要に応じて、 WM_SYSCOMMAND メッセージが送信されます。

Note

`CWnd::OnNcLButtonDown`

フレームワークは、カーソルが CWnd オブジェクトの非クライアント領域内にあるときに、ユーザーがマウスの左ボタンを押すと、このメンバー関数を呼び出します。

afx_msg void OnNcLButtonDown(
    UINT nHitTest,
    CPoint point);

パラメーター

point
カーソル位置の x および y 画面座標を含む CPoint オブジェクトを指定します。これらの座標は、常に画面の左上隅を基準にしています。

解説

必要に応じて、 WM_SYSCOMMAND が送信されます。

Note

このメンバー関数は、アプリケーションで Windows メッセージを処理できるようにするためにフレームワークによって呼び出されます。関数に渡されるパラメーターには、メッセージの受信時にフレームワークによって受信されたパラメーターが反映されます。この関数の基底クラスの実装を呼び出す場合、その実装では、最初にメッセージと共に渡されたパラメーターが使用され、関数に指定したパラメーターは使用されません。

`CWnd::OnNcLButtonUp`

フレームワークは、カーソルが非クライアント領域内にあるときに、ユーザーがマウスの左ボタンを離すと、このメンバー関数を呼び出します。

afx_msg void OnNcLButtonUp(
    UINT nHitTest,
    CPoint point);

パラメーター

point
カーソル位置の x および y 画面座標を含む CPoint オブジェクトを指定します。これらの座標は、常に画面の左上隅を基準にしています。

解説

必要に応じて、 WM_SYSCOMMAND が送信されます。

Note

`CWnd::OnNcMButtonDblClk`

このメンバー関数は、カーソルが非クライアント領域内にあるときにユーザーがマウスの中央ボタンをダブルクリックしたときに呼び出されます。

afx_msg void OnNcMButtonDblClk(
    UINT nHitTest,
    CPoint point);

パラメーター

nHitTest
hit-test コードを指定します。ヒットテストは、カーソルの位置を判断するテストです。

point
カーソル位置の x および y 画面座標を含む CPoint オブジェクトを指定します。これらの座標は、常に画面の左上隅を基準にしています。

解説

Note

`CWnd::OnNcMButtonDown`

フレームワークは、カーソルが非クライアント領域内にあるときにユーザーがマウスの中央ボタンを押すと、このメンバー関数を呼び出します。

afx_msg void OnNcMButtonDown(
    UINT nHitTest,
    CPoint point);

パラメーター

nHitTest
hit-test コードを指定します。ヒットテストは、カーソルの位置を判断するテストです。

point
カーソル位置の x および y 画面座標を含む CPoint オブジェクトを指定します。これらの座標は、常に画面の左上隅を基準にしています。

解説

Note

`CWnd::OnNcMButtonUp`

このメンバー関数は、カーソルが非クライアント領域内にあるときにユーザーがマウスの中央ボタンを離したときに呼び出されます。

afx_msg void OnNcMButtonUp(
    UINT nHitTest,
    CPoint point);

パラメーター

nHitTest
hit-test コードを指定します。ヒットテストは、カーソルの位置を判断するテストです。

point
カーソル位置の x および y 画面座標を含む CPoint オブジェクトを指定します。これらの座標は、常に画面の左上隅を基準にしています。

解説

Note

`CWnd::OnNcMouseHover`

フレームワークは、 TrackMouseEventの前の呼び出しで指定された期間、ウィンドウの非クライアント領域にカーソルを置くと、このメンバー関数を呼び出します。

afx_msg void OnNcMouseHover(
    UINT nHitTest,
    CPoint point);

パラメーター

nHitTest
[in]WM_NCHITTEST メッセージの処理の結果としてCWnd::DefWindowProc関数によって返されるヒットテスト値。

point
[in]画面の左上隅を基準としたカーソルのxおよびy座標を指定するCPointオブジェクト。

解説

このメソッドは、Windows SDK で説明されている WM_NCMOUSEHOVER 通知を受け取ります。

Note

`CWnd::OnNcMouseLeave`

フレームワークは、 TrackMouseEventの前の呼び出しで指定されたウィンドウの非クライアント領域からカーソルが離れると、このメンバー関数を呼び出します。

afx_msg void OnNcMouseLeave();

解説

このメソッドは、Windows SDK で説明されている WM_NCMOUSELEAVE 通知を受け取ります。

Note

`CWnd::OnNcMouseMove`

フレームワークは、カーソルが非クライアント領域内で移動されるときに、このメンバー関数を呼び出します。

afx_msg void OnNcMouseMove(
    UINT nHitTest,
    CPoint point);

パラメーター

nHitTest
hit-test コードを指定します。ヒットテストは、カーソルの位置を判断するテストです。

point
カーソル位置の x および y 画面座標を含む CPoint オブジェクトを指定します。これらの座標は、常に画面の左上隅を基準にしています。

解説

必要に応じて、 WM_SYSCOMMAND メッセージが送信されます。

Note

`CWnd::OnNcPaint`

フレームワークは、非クライアント領域を描画する必要がある場合に、このメンバー関数を呼び出します。

afx_msg void OnNcPaint();

解説

既定の実装では、ウィンドウフレームが描画されます。

アプリケーションは、この呼び出しをオーバーライドし、独自のカスタムウィンドウフレームを描画できます。フレームの形状が変更された場合でも、クリッピング領域は常に四角形になります。

`CWnd::OnNcRButtonDblClk`

フレームワークは、カーソルが CWndの非クライアント領域内にあるときに、ユーザーがマウスの右ボタンをダブルクリックすると、このメンバー関数を呼び出します。

afx_msg void OnNcRButtonDblClk(
    UINT nHitTest,
    CPoint point);

パラメーター

nHitTest
hit-test コードを指定します。ヒットテストは、カーソルの位置を判断するテストです。

point
カーソル位置の x および y 画面座標を含む CPoint オブジェクトを指定します。これらの座標は、常に画面の左上隅を基準にしています。

解説

Note

`CWnd::OnNcRButtonDown`

フレームワークは、カーソルが非クライアント領域内にあるときにユーザーがマウスの右ボタンを押すと、このメンバー関数を呼び出します。

afx_msg void OnNcRButtonDown(
    UINT nHitTest,
    CPoint point);

パラメーター

nHitTest
hit-test コードを指定します。ヒットテストは、カーソルの位置を判断するテストです。

point
カーソル位置の x および y 画面座標を含む CPoint オブジェクトを指定します。これらの座標は、常に画面の左上隅を基準にしています。

解説

Note

`CWnd::OnNcRButtonUp`

フレームワークは、カーソルが非クライアント領域内にあるときにユーザーがマウスの右ボタンを離すと、このメンバー関数を呼び出します。

afx_msg void OnNcRButtonUp(
    UINT nHitTest,
    CPoint point);

パラメーター

nHitTest
hit-test コードを指定します。ヒットテストは、カーソルの位置を判断するテストです。

point
カーソル位置の x および y 画面座標を含む CPoint オブジェクトを指定します。これらの座標は、常に画面の左上隅を基準にしています。

解説

Note

`CWnd::OnNcRenderingChanged`

フレームワークは、非クライアント領域のレンダリングポリシーが変更されたときに、このメンバーを呼び出します。

afx_msg void OnNcRenderingChanged(BOOL bIsRendering);

パラメーター

bIsRendering
[入力] TRUE ウィンドウの非クライアント領域に対してデスクトップウィンドウマネージャー (DWM) レンダリングが有効になっている場合。レンダリングが無効になっている場合に FALSE します。

解説

このメソッドは、Windows SDK で説明されている WM_DWMNCRENDERINGCHANGED 通知を受け取ります。

Note

`CWnd::OnNcXButtonDblClk`

ウィンドウの非クライアント領域にカーソルがある間にユーザーが XBUTTON1 または XBUTTON2 をダブルクリックすると、フレームワークはこのメンバー関数を呼び出します。

void OnNcXButtonDblClk(
    short nHitTest,
    UINT nButton,
    CPoint point);

パラメーター

nHitTest
[in]WM_NCHITTEST メッセージの処理の結果としてCWnd::DefWindowProc関数によって返されるヒットテスト値。

nButton
[in]最初の Microsoft Intellimouse X ボタンがダブルクリックされている場合は XBUTTON1 の値。2 番目の X ボタンがダブルクリックされた場合は XBUTTON2 。

point
[in]クライアント領域の左上隅を基準にしたカーソルのxおよびy座標を指定するCPoint オブジェクト。

解説

このメソッドは、Windows SDK で説明されている WM_XBUTTONDBLCLK 通知を受け取ります。このメッセージは、カーソルを含むウィンドウに投稿されます。ウィンドウがマウスをキャプチャした場合、このメッセージは投稿されません。

Note

`CWnd::OnNcXButtonDown`

ウィンドウの非クライアント領域にカーソルがあるときに、ユーザーがマウスの XBUTTON1 または XBUTTON2 を押すと、フレームワークはこのメンバー関数を呼び出します。

afx_msg void OnNcXButtonDown(
    short nHitTest,
    UINT nButton,
    CPoint point);

パラメーター

nHitTest
[in]WM_NCHITTEST メッセージの処理の結果としてCWnd::DefWindowProc関数によって返されるヒットテスト値。

nButton
[in]最初のマウスの X ボタンが押された場合は XBUTTON1 の値。2 番目の X ボタンが押された場合は XBUTTON2 。

point
[in]画面の左上隅を基準にしたカーソルのxおよびy座標を指定するCPoint オブジェクト。

解説

このメソッドは、Windows SDK で説明されている WM_NCXBUTTONDOWN 通知を受け取ります。このメッセージは、カーソルを含むウィンドウに投稿されます。ウィンドウがマウスをキャプチャした場合、このメッセージは投稿されません。

Note

`CWnd::OnNcXButtonUp`

ウィンドウの非クライアント領域にカーソルがあるときに、ユーザーがマウスの XBUTTON1 または XBUTTON2 を離すと、フレームワークはこのメンバー関数を呼び出します。

afx_msg void OnNcXButtonUp(
    short nHitTest,
    UINT nButton,
    CPoint point);

パラメーター

nHitTest
[in]WM_NCHITTEST メッセージの処理の結果としてCWnd::DefWindowProc関数によって返されるヒットテスト値。

nButton
[in]最初のマウスの X ボタンが離された場合は XBUTTON1 の値。2 番目の X ボタンが離された場合は XBUTTON2 。

point
[in]画面の左上隅を基準としたカーソルのxおよびy座標を指定するCPointオブジェクト。

解説

このメソッドは、Windows SDK で説明されている WM_NCXBUTTONUP 通知を受け取ります。このメッセージは、カーソルを含むウィンドウに投稿されます。ウィンドウがマウスをキャプチャした場合、このメッセージは投稿されません。

Note

`CWnd::OnNextMenu`

フレームワークは、メニューバーとシステムメニューを切り替えるために右方向キーまたは左方向キーを使用すると、このメンバー関数を呼び出します。

afx_msg void OnNextMenu(
    UINT nKey,
    LPMDINEXTMENU lpMdiNextMenu);

パラメーター

nKey
[in]どの修飾子キーが押されているかを示すフラグのビットごとの組み合わせ (OR)。たとえば、 MK_CONTROL フラグは、Ctrl キーが押されていることを示します。フラグの一覧については、「マウス入力について」の「メッセージパラメーター」小見出しを参照してください。

lpMdiNextMenu
[in]アクティブ化するメニューに関する情報を含む MDINEXTMENU 構造体へのポインター。

解説

このメソッドは、Windows SDK で説明されている WM_UNINITMENUPOPUP 通知を受け取ります。このメッセージに応答して、アプリケーションは、切り替えるメニューを指定するMDINEXTMENU構造体のhmenuNext メンバーと、メニュー通知メッセージを受信するウィンドウを指定するhwndNext メンバーを設定できます。

Note

`CWnd::OnNotify`

フレームワークは、このメンバー関数を呼び出して、コントロールでイベントが発生したことをコントロールの親ウィンドウに通知するか、コントロールに何らかの情報が必要であることを通知します。

virtual BOOL OnNotify(
    WPARAM wParam,
    LPARAM lParam,
    LRESULT* pResult);

パラメーター

wParam
メッセージがコントロールからのメッセージの場合にメッセージを送信するコントロールを識別します。それ以外の場合、 wParam は 0 です。

lParam
通知コードと追加情報を含む通知メッセージ (NMHDR) 構造体へのポインター。一部の通知メッセージでは、このパラメーターは、NMHDR 構造を最初のメンバーとして含む、より大きな構造体をポイントします。

pResult
メッセージが処理された場合に結果コードを格納する LRESULT 変数へのポインター。

戻り値

このメッセージを処理すると、アプリケーションは 0 以外の値を返します。それ以外の場合は 0。

解説

OnNotify は、制御通知用のメッセージマップを処理します。

WM_NOTIFY メッセージを処理するには、派生クラスのこのメンバー関数をオーバーライドします。基底クラスの OnNotify が呼び出されない限り、オーバーライドはメッセージマップを処理しません。

WM_NOTIFY メッセージの詳細については、Technical Note 61 (TN061)、ON_NOTIFYメッセージ、およびWM_NOTIFY メッセージを参照してください。 Control トピックおよび TN062 Windows コントロールのメッセージリフレクションで説明されている関連トピックにも関心がある場合があります。

`CWnd::OnNotifyFormat`

フレームワークは、このメンバー関数を呼び出して、現在のウィンドウが WM_NOTIFY 通知メッセージで ANSI または Unicode 構造体を受け入れるかどうかを判断します。

afx_msg UINT OnNotifyFormat(
    CWnd* pWnd,
    UINT nCommand);

パラメーター

pWnd
[in]WM_NOTIFY メッセージを送信するウィンドウを表すCWnd オブジェクトへのポインター。このパラメーターは、 nCommand パラメーターが NF_QUERYされている場合はコントロールへのポインター、 nCommand が NF_REQUERY場合はコントロールの親ウィンドウへのポインターです。

nCommand
[in] WM_NOTIFY メッセージを特殊化するコマンド値。指定できる値は、

NF_QUERY - メッセージは、ANSI 構造体と Unicode 構造体のどちらを WM_NOTIFY メッセージで使用するかを判断するクエリです。このメッセージは、コントロールの作成時に、このメッセージの NF_REQUERY 形式に応答して、コントロールから親ウィンドウに送信されます。
NF_REQUERY - メッセージは、このメッセージの NF_QUERY 形式を親ウィンドウに送信するコントロールの要求です。この要求は親ウィンドウから送信され、メッセージで使用する構造体の種類について親に再クエリを実行するようにコントロール WM_NOTIFY 求めます。 nCommand パラメーターがNF_REQUERYの場合、戻り値は再クエリ操作の結果になります。

戻り値

戻り値	意味
`NFR_ANSI`	ANSI 構造体は、コントロールによって送信 `WM_NOTIFY` メッセージで使用する必要があります。
`NFR_UNICODE`	Unicode 構造体は、コントロールによって送信 `WM_NOTIFY` メッセージで使用する必要があります。
0	エラーが発生しました。

解説

このメソッドは、Windows SDK で説明されている WM_NOTIFYFORMAT 通知を受け取ります。 WM_NOTIFY メッセージは、共通コントロールから親ウィンドウ、および親ウィンドウから共通コントロールに送信されます。

Note

`CWnd::OnPaint`

フレームワークは、Windows またはアプリケーションがアプリケーションのウィンドウの一部を再描画する要求を行うときに、このメンバー関数を呼び出します。

afx_msg void OnPaint();

解説

WM_PAINT メッセージは、UpdateWindowまたはRedrawWindowメンバー関数が呼び出されたときに送信されます。

ウィンドウは、RDW_INTERNALPAINT フラグを設定して RedrawWindow メンバー関数を呼び出した結果、内部ペイントメッセージを受信する場合があります。この場合、ウィンドウに更新リージョンがない可能性があります。アプリケーションは、 GetUpdateRect メンバー関数を呼び出して、ウィンドウに更新領域があるかどうかを判断する必要があります。 GetUpdateRect 0 が返された場合、アプリケーションは BeginPaint および EndPaint メンバー関数を呼び出さないでください。

WM_PAINT メッセージは無効な領域と、RDW_INTERNALPAINT フラグが設定されたRedrawWindowメンバー関数の呼び出しの両方によって発生している可能性があるため、各WM_PAINT メッセージの内部データ構造を調べることで、必要な内部再描画または更新を確認するのはアプリケーションの責任です。

内部 WM_PAINT メッセージは、Windows によって 1 回だけ送信されます。 UpdateWindow メンバー関数によって内部WM_PAINT メッセージがウィンドウに送信された後、ウィンドウが無効になるまで、またはRDW_INTERNALPAINT フラグが設定された状態でRedrawWindowメンバー関数が再度呼び出されるまで、WM_PAINT メッセージは送信またはポストされません。

ドキュメント/ビューアプリケーションでのイメージのレンダリングについては、 CView::OnDrawを参照してください。

WM_Paintの使用方法の詳細については、Windows SDK の次のトピックを参照してください。

`CWnd::OnPaintClipboard`

クリップボード所有者の OnPaintClipboard メンバー関数は、クリップボード所有者がクリップボードに CF_OWNERDISPLAY 形式でデータを格納したことによりクリップボードビューアーのクライアント領域を再描画する必要があるときにクリップボードビューアーによって呼び出されます。

afx_msg void OnPaintClipboard(
    CWnd* pClipAppWnd,
    HGLOBAL hPaintStruct);

パラメーター

pClipAppWnd
クリップボードアプリケーションウィンドウへのポインターを指定します。ポインターは一時的なものであり、後で使用するために格納しないでください。

hPaintStruct
塗りつぶすクライアント領域の部分を定義する PAINTSTRUCT データ構造を識別します。

解説

クライアント領域全体またはクライアント領域の一部のみを再描画する必要があるかどうかを判断するには、クリップボードの所有者は、PAINTSTRUCT構造体のrcpaint メンバーで指定された描画領域の寸法を、最新のOnSizeClipboardメンバー関数呼び出しで指定された寸法と比較する必要があります。

OnPaintClipboard は、 GlobalLock Windows 関数を使用して、 PAINTSTRUCT データ構造を含むメモリをロックし、 GlobalUnlock Windows 関数を使用してそのメモリのロックを解除してから終了する必要があります。

Note

`CWnd::OnPaletteChanged`

フレームワークは、入力フォーカスのあるウィンドウが論理パレットを実現し、システムパレットを変更した後、すべての最上位ウィンドウに対してこのメンバー関数を呼び出します。

afx_msg void OnPaletteChanged(CWnd* pFocusWnd);

パラメーター

pFocusWnd
システムパレットが変更される原因となったウィンドウへのポインターを指定します。ポインターは一時的なものであり、格納しないでください。

解説

この呼び出しにより、カラーパレットを使用して論理パレットを実現し、クライアント領域を更新する入力フォーカスのないウィンドウが可能になります。

OnPaletteChangedメンバー関数は、システムパレットを変更し、WM_PALETTECHANGED メッセージが送信される原因となったウィンドウを含め、最上位および重複するすべてのウィンドウに対して呼び出されます。子ウィンドウでカラーパレットを使用する場合は、このメッセージをそのウィンドウに渡す必要があります。

無限ループを回避するために、 pFocusWnd がそれ自体へのポインターを含まないと判断しない限り、ウィンドウはそのパレットを認識しないようにする必要があります。

Note

`CWnd::OnPaletteIsChanging`

フレームワークは、このメンバー関数を呼び出して、アプリケーションがその論理パレットを実現しようとしていることをアプリケーションに通知します。

afx_msg void OnPaletteIsChanging(CWnd* pRealizeWnd);

パラメーター

pRealizeWnd
論理パレットを実現しようとしているウィンドウを指定します。

解説

`CWnd::OnParentNotify`

親の OnParentNotify メンバー関数は、子ウィンドウが作成または破棄されたとき、またはカーソルが子ウィンドウの上にある間にユーザーがマウスボタンをクリックしたときに、フレームワークによって呼び出されます。

afx_msg void OnParentNotify(
    UINT message,
    LPARAM lParam);

パラメーター

message
親が通知を受けるイベントと子ウィンドウの識別子を指定します。イベントは、 messageの下位ワードです。イベントが WM_CREATE または WM_DESTROYの場合、 message の上位ワードは子ウィンドウの識別子です。それ以外の場合、高次ワードは未定義です。イベント ( messageの下位ワード) には、次のいずれかの値を指定できます。

WM_CREATE 子ウィンドウが作成されています。
WM_DESTROY 子ウィンドウが破棄されています。
WM_LBUTTONDOWN ユーザーが子ウィンドウの上にマウスカーソルを置き、マウスの左ボタンをクリックしました。
WM_MBUTTONDOWN ユーザーが子ウィンドウの上にマウスカーソルを置き、マウスの中央ボタンをクリックしました。
WM_RBUTTONDOWN ユーザーが子ウィンドウの上にマウスカーソルを置き、マウスの右ボタンをクリックしました。

lParam
messageのイベント (下位ワード) がWM_CREATEまたはWM_DESTROYの場合、lParamは子ウィンドウのウィンドウハンドルを指定します。それ以外の場合lParamカーソルの x 座標と y 座標が含まれます。 x 座標は下位ワードにあり、y 座標は上位ワードにあります。

解説

子ウィンドウが作成されると、ウィンドウを作成する Create メンバー関数が戻る直前にOnParentNotifyが呼び出されます。子ウィンドウが破棄されると、システムはウィンドウを破棄するために処理が行われる前に OnParentNotify を呼び出します。

OnParentNotify は、最上位ウィンドウを含む、子ウィンドウのすべての先祖ウィンドウに対して呼び出されます。

WS_EX_NOPARENTNOTIFY スタイルを持つ子ウィンドウを除くすべての子ウィンドウは、親ウィンドウにこのメッセージを送信します。既定では、CreateEx メンバー関数を呼び出して子ウィンドウを作成しない限り、ダイアログボックスの子ウィンドウにはWS_EX_NOPARENTNOTIFY スタイルがあります。

Note

`CWnd::OnPowerBroadcast`

電源管理イベントが発生すると、フレームワークはこのメンバー関数を呼び出します。

afx_msg UINT OnPowerBroadcast(
    UINT nPowerEvent,
    UINT nEventData);

パラメーター

nPowerEvent
[in]電源管理イベント。

nEventData
[in]イベント固有のデータ。

戻り値

イベントが要求の場合は、要求を許可する TRUE を返すか、要求を拒否する BROADCAST_QUERY_DENY を返します。

解説

このメソッドは、Windows SDK で説明されている WM_POWERBROADCAST メッセージを受け取ります。

nPowerEvent パラメーターは、バッテリの電源が低い、電源状態が変更された、操作を中断するアクセス許可が要求または拒否された、イベントの後に操作が自動的に再開される、システムが操作を中断している、または一時停止後に操作が再開されるなどのイベントを指定します。通常、 nEventData パラメーターは使用されません。詳細については、WM_POWERBROADCAST メッセージのwParamおよびlParamパラメーターを参照してください。

Note

`CWnd::OnQueryDragIcon`

フレームワークは、最小化された (アイコン) ウィンドウによってこのメンバー関数を呼び出します。このウィンドウには、そのクラスに対して定義されたアイコンがありません。

afx_msg HCURSOR OnQueryDragIcon();

戻り値

下位ワードのカーソルまたはアイコンハンドルを含む doubleword 値。カーソルまたはアイコンは、ディスプレイドライバーの解像度と互換性がある必要があります。アプリケーションから NULLが返された場合、システムは既定のカーソルを表示します。既定の戻り値は NULL。

解説

ユーザーが最小化されたウィンドウをドラッグしている間、システムはこの呼び出しを行って、表示するカーソルを取得します。アプリケーションがアイコンまたはカーソルのハンドルを返す場合、システムはそれを白黒に変換します。アプリケーションがハンドルを返す場合、ハンドルはディスプレイドライバーの解像度と互換性のあるモノクロカーソルまたはアイコンを識別する必要があります。アプリケーションは、 CWinApp::LoadCursor または CWinApp::LoadIcon メンバー関数を呼び出して、実行可能ファイル内のリソースからカーソルまたはアイコンを読み込み、このハンドルを取得できます。

`CWnd::OnQueryEndSession`

フレームワークは、ユーザーが Windows セッションの終了を選択したとき、またはアプリケーションが windows 関数 ExitWindows 呼び出すときに、このメンバー関数を呼び出します。

afx_msg BOOL OnQueryEndSession();

戻り値

アプリケーションを簡単にシャットダウンできる場合は 0 以外。それ以外の場合は 0。

解説

いずれかのアプリケーションが 0 を返した場合、Windows セッションは終了しません。 Windows は、1 つのアプリケーションが 0 を返すとすぐにOnQueryEndSessionの呼び出しを停止し、既に 0 以外の値を返したアプリケーションのパラメーター値が FALSE のWM_ENDSESSION メッセージを送信します。

`CWnd::OnQueryNewPalette`

フレームワークは、 CWnd オブジェクトが入力フォーカスを受け取るときにこのメンバー関数を呼び出します。これにより、 CWnd はフォーカスを受け取ったときに論理パレットを実現できます。

afx_msg BOOL OnQueryNewPalette();

戻り値

CWndが論理パレットを認識する場合は 0 以外、それ以外の場合は 0。

`CWnd::OnQueryOpen`

フレームワークは、 CWnd オブジェクトが最小化され、ユーザーが CWnd を事前に最小化されたサイズと位置に復元することを要求すると、このメンバー関数を呼び出します。

afx_msg BOOL OnQueryOpen();

戻り値

アイコンを開くことができる場合は 0 以外、アイコンを開くことができない場合は 0。

解説

OnQueryOpenでは、CWndはアクティブ化やフォーカスの変更 (ダイアログボックスの作成など) を引き起こすアクションを実行しないでください。

`CWnd::OnQueryUIState`

ウィンドウのユーザーインターフェイス (UI) 状態を取得するために呼び出されます。

afx_msg UINT OnQueryUIState();

戻り値

フォーカスインジケーターとキーボードアクセラレータが表示されている場合、戻り値は NULL されます。それ以外の場合、戻り値には次の値のうち 1 つ以上を指定できます。

UISF_HIDEFOCUS フォーカスインジケーターは非表示になります。
UISF_HIDEACCEL キーボードアクセラレータは非表示になっています。
UISF_ACTIVE Windows XP: コントロールは、アクティブなコントロールに使用されるスタイルで描画する必要があります。

解説

このメンバー関数は、Windows SDK で説明されているように、 WM_QUERYUISTATE メッセージの機能をエミュレートします。

`CWnd::OnRawInput`

フレームワークは、現在のウィンドウが生の入力を取得するときに、このメンバー関数を呼び出します。

afx_msg void OnRawInput(
    UINT nInputCode,
    HRAWINPUT hRawInput);

パラメーター

nInputCode
[in]アプリケーションがフォアグラウンドの間に入力されたかどうかを示す入力コード。どちらの場合も、システムがクリーンアップを実行できるように、アプリケーションは CWnd::DefWindowProc を呼び出す必要があります。このパラメーターには、次の値のいずれかを指定できます。

RIM_INPUT - アプリケーションがフォアグラウンドにある間に入力が発生しました。
RIM_INPUTSINK - アプリケーションがフォアグラウンドにいないときに入力が発生しました。

hRawInput
[in]デバイスからの生入力を含む RAWINPUT 構造体へのハンドル。

解説

このメソッドは、Windows SDK で説明されている WM_INPUT 通知を受け取ります。

Note

`CWnd::OnRButtonDblClk`

フレームワークは、ユーザーがマウスの右ボタンをダブルクリックすると、このメンバー関数を呼び出します。

afx_msg void OnRButtonDblClk(
    UINT nFlags,
    CPoint point);

パラメーター

nFlags
さまざまな仮想キーが下がっているかどうかを示します。このパラメータには、次の値を任意に組み合わせて指定できます:

MK_CONTROL Ctrl キーがダウンしている場合に設定します。
MK_LBUTTON マウスの左ボタンが下にある場合に設定します。
MK_MBUTTON マウスの中央ボタンが下にある場合に設定します。
MK_RBUTTON マウスの右ボタンが下にある場合に設定します。
MK_SHIFT Shift キーがダウンしている場合に設定します。

point
カーソルの x 座標と y 座標を指定します。これらの座標は、常にウィンドウの左上隅を基準にしています。

解説

CS_DBLCLKS WNDCLASS スタイルを持つウィンドウのみが、 OnRButtonDblClk 呼び出しを受信できます。これは、Microsoft Foundation クラスライブラリ内のウィンドウの既定値です。 Windows は、ユーザーがシステムのダブルクリック時間制限内でマウスの右ボタンを押し、離してから再度押すと、 OnRButtonDblClk を呼び出します。マウスの右ボタンをダブルクリックすると、実際には、 WM_RBUTTONDOWN メッセージと WM_RBUTTONUP メッセージ、 OnRButtonDblClk 呼び出し、ボタンが離されたときに別のWM_RBUTTONUP メッセージの 4 つのイベントが生成されます。

Note

`CWnd::OnRButtonDown`

フレームワークは、ユーザーがマウスの右ボタンを押すと、このメンバー関数を呼び出します。

afx_msg void OnRButtonDown(
    UINT nFlags,
    CPoint point);

パラメーター

nFlags
さまざまな仮想キーが下がっているかどうかを示します。このパラメータには、次の値を任意に組み合わせて指定できます:

MK_CONTROL Ctrl キーがダウンしている場合に設定します。
MK_LBUTTON マウスの左ボタンが下にある場合に設定します。
MK_MBUTTON マウスの中央ボタンが下にある場合に設定します。
MK_RBUTTON マウスの右ボタンが下にある場合に設定します。
MK_SHIFT Shift キーがダウンしている場合に設定します。

point
カーソルの x 座標と y 座標を指定します。これらの座標は、常にウィンドウの左上隅を基準にしています。

解説

`CWnd::OnRButtonUp`

フレームワークは、ユーザーがマウスの右ボタンを離すと、このメンバー関数を呼び出します。

afx_msg void OnRButtonUp(
    UINT nFlags,
    CPoint point);

パラメーター

nFlags
さまざまな仮想キーが下がっているかどうかを示します。このパラメータには、次の値を任意に組み合わせて指定できます:

MK_CONTROL Ctrl キーがダウンしている場合に設定します。
MK_LBUTTON マウスの左ボタンが下にある場合に設定します。
MK_MBUTTON マウスの中央ボタンが下にある場合に設定します。
MK_SHIFT Shift キーがダウンしている場合に設定します。

point
カーソルの x 座標と y 座標を指定します。これらの座標は、常にウィンドウの左上隅を基準にしています。

解説

`CWnd::OnRegisteredMouseWheel`

フレームワークは、ユーザーがマウスホイールを回転させ、ホイールの次の切り欠きを検出すると、このメンバー関数を呼び出します。

afx_msg LRESULT OnRegisteredMouseWheel(
    WPARAM wParam,
    LPARAM lParam);

パラメーター

wParam
ポインターの水平方向の位置。

lParam
ポインターの垂直方向の位置。

戻り値

現時点では重要でない。常に 0。

解説

オーバーライドされない限り、 OnRegisteredMouseWheel はメッセージを適切なウィンドウ (フォーカスのある親ウィンドウ) にルーティングし、そのウィンドウの WM_MOUSEWHEEL ハンドラーを呼び出します。

独自のメッセージルーティングを提供したり、マウスホイールのスクロール動作を変更したりするには、このメンバー関数をオーバーライドします。

Note

OnRegisteredMouseWheel は、Windows 95/98 および Windows NT 3.51 のメッセージを処理します。 Windows NT 4.0 メッセージ処理の場合は、 OnMouseWheelを使用します。

`CWnd::OnRenderAllFormats`

クリップボード所有者の OnRenderAllFormats メンバー関数は、所有者アプリケーションが破棄されるときにフレームワークによって呼び出されます。

afx_msg void OnRenderAllFormats();

解説

クリップボードの所有者は、生成できるすべての形式でデータをレンダリングし、 SetClipboardData Windows 関数を呼び出して、各形式のデータハンドルをクリップボードに渡す必要があります。これにより、データをレンダリングしたアプリケーションが破棄された場合でも、クリップボードに有効なデータが含まれるようにします。アプリケーションは、SetClipboardData Windows 関数を呼び出す前に OpenClipboard メンバー関数を呼び出し、後で CloseClipboard Windows 関数を呼び出す必要があります。

`CWnd::OnRenderFormat`

レンダリングが遅延した特定の形式をレンダリングする必要がある場合、クリップボード所有者の OnRenderFormat メンバー関数がフレームワークによって呼び出されます。

afx_msg void OnRenderFormat(UINT nFormat);

パラメーター

nFormat
クリップボードの形式を指定します。

解説

受信側は、その形式でデータをレンダリングし、 SetClipboardData Windows 関数を呼び出してクリップボードに渡す必要があります。

OnRenderFormat内から OpenClipboard メンバー関数または CloseClipboard Windows 関数を呼び出さないでください。

Note

`CWnd::OnSessionChange`

フレームワークはこのメンバー関数を呼び出して、セッション状態の変化をアプリケーションに通知します。

afx_msg void OnSessionChange(
    UINT nSessionState,
    UINT nId);

パラメーター

nSessionState
[in]状態コードは、セッション状態の変化を記述します。

nId
[in]セッション識別子。

解説

このメソッドは、Windows SDK で説明されている WM_WTSSESSION_CHANGE 通知を受け取ります。

nSessionState パラメーターは、セッションが本体またはリモートターミナルに接続または切断されていること、ユーザーがログオンまたはオフになっている、セッションがロックまたはロック解除されている、またはセッションがリモート制御状態に変更されたことを指定します。詳細については、WM_WTSSESSION_CHANGE メッセージの wParam パラメーターを参照してください。

Note

`CWnd::OnSetCursor`

フレームワークは、マウス入力がキャプチャされず、マウスによって CWnd オブジェクト内でカーソルの移動が発生した場合に、このメンバー関数を呼び出します。

afx_msg BOOL OnSetCursor(
    CWnd* pWnd,
    UINT nHitTest,
    UINT message);

パラメーター

pWnd
カーソルを含むウィンドウへのポインターを指定します。ポインターは一時的なものであり、後で使用するために格納しないでください。

nHitTest
hit-test面番号を指定します。ヒットテストによってカーソルの位置が決まります。

message
マウスのメッセージ番号が指定されます。

戻り値

それ以降の処理を停止する場合は 0 以外、続行する場合は 0。

解説

既定の実装では、処理の前に親ウィンドウの OnSetCursor が呼び出されます。親ウィンドウから TRUEが返された場合、それ以降の処理は停止されます。親ウィンドウを呼び出すと、子ウィンドウ内のカーソルの設定を親ウィンドウで制御できます。

既定の実装では、カーソルがクライアント領域にない場合は矢印に設定され、存在する場合は登録済みクラスカーソルに設定されます。

nHitTestがHTERRORされ、messageがマウスのボタンダウンメッセージである場合は、MessageBeepメンバー関数が呼び出されます。

CWndがメニューモードになると、message パラメーターは 0 になります。

Note

`CWnd::OnSetFocus`

フレームワークは、入力フォーカスを取得した後、このメンバー関数を呼び出します。

afx_msg void OnSetFocus(CWnd* pOldWnd);

パラメーター

pOldWnd
入力フォーカスを失う (NULLされる可能性がある) CWnd オブジェクトを格納します。ポインターは一時的なものであり、後で使用するために格納しないでください。

解説

キャレットを表示するには、 CWnd この時点で適切なキャレット関数を呼び出す必要があります。

Note

`CWnd::OnSettingChange`

フレームワークは、Win32 SystemParametersInfo 関数がシステム全体の設定を変更するときに、すべての最上位ウィンドウの OnSettingChange を呼び出します。

afx_msg void OnSettingChange(
    UINT uFlags,
    LPCTSTR lpszSection);

パラメーター

uFlags
システムが SystemParametersInfo 呼び出しの結果としてメッセージを送信する場合、このパラメーターは変更されたシステム・パラメーターを示すフラグです。値の一覧については、Windows SDK の SystemParametersInfo を参照してください。アプリケーションがメッセージを送信する場合、このパラメーターは 0 である必要があります。

lpszSection
変更されたセクションの名前を指定する文字列を指します。 (文字列には、セクション名を囲む角かっこは含まれません)。

解説

アプリケーションは、システムパラメーターに変更を加えたときに、すべての最上位ウィンドウにメッセージを送信する必要があります。ユーザーがコントロールパネルを介して設定を変更した場合、Windows はメッセージを送信します。

ON_WM_SETTINGCHANGE メッセージは、ON_WM_WININICHANGE メッセージに似ていますが、次の違いがあります。

Windows NT 4.0 以降、または Windows 95/98 の下で実行する場合は、 ON_WM_SETTINGCHANGE を使用します。
Windows NT 3.51 以前を実行する場合は、 ON_WININICHANGE を使用します。このメッセージは廃止されました。

これらのマクロは、メッセージマップに 1 つだけ含める必要があります。 Windows 95/98 と Windows NT 4.0 の両方で動作するプログラムを作成するには、 ON_WM_SETTINGCHANGEのハンドラーを記述します。 Windows NT 3.51 では、ハンドラーは OnSettingChange および uFlags によって呼び出され、常に 0 になります。

`CWnd::OnShowWindow`

フレームワークは、 CWnd オブジェクトが非表示または表示されようとしているときに、このメンバー関数を呼び出します。

afx_msg void OnShowWindow(
    BOOL bShow,
    UINT nStatus);

パラメーター

bShow
ウィンドウを表示するかどうかを指定します。ウィンドウが表示されている場合は TRUE 。ウィンドウが非表示の場合は FALSE 。

nStatus
表示されるウィンドウの状態を指定します。 ShowWindowメンバー関数呼び出しのためにメッセージが送信された場合は 0 です。それ以外の場合、nStatusは次のいずれかです。

SW_PARENTCLOSING 親ウィンドウが閉じている (アイコン化されている) か、ポップアップウィンドウが非表示になっています。
SW_PARENTOPENING 親ウィンドウが開かれている (表示中) か、ポップアップウィンドウが表示されています。

解説

ウィンドウは、 ShowWindow メンバー関数が呼び出されたとき、重複したウィンドウが最大化または復元されたとき、または重なっているウィンドウまたはポップアップウィンドウが閉じられている (アイコン化された) か開いている (画面に表示される) 場合に、非表示または表示されます。重なったウィンドウが閉じられると、そのウィンドウに関連付けられているすべてのポップアップウィンドウが非表示になります。

Note

`CWnd::OnSize`

フレームワークは、ウィンドウのサイズが変更された後、このメンバー関数を呼び出します。

afx_msg void OnSize(
    UINT nType,
    int cx,
    int cy);

パラメーター

nType
要求されたサイズ変更の種類を指定します。このパラメーターには、次の値のいずれかを指定できます。

SIZE_MAXIMIZED ウィンドウが最大化されました。
SIZE_MINIMIZED ウィンドウが最小化されました。
SIZE_RESTORED ウィンドウのサイズは変更されましたが、 SIZE_MINIMIZED も SIZE_MAXIMIZED も適用されません。
SIZE_MAXHIDE 他のウィンドウが最大化されると、すべてのポップアップウィンドウにメッセージが送信されます。
SIZE_MAXSHOW 他のウィンドウが以前のサイズに復元されると、メッセージはすべてのポップアップウィンドウに送信されます。

cx
クライアント領域の新しい幅を指定します。

cy
クライアント領域の新しい高さを指定します。

解説

OnSizeから子ウィンドウに対してSetScrollPosまたはMoveWindowメンバー関数が呼び出された場合、CWndを再描画するには、SetScrollPosまたはMoveWindowのbRedrawパラメーターを 0 以外にする必要があります。

Note

例

// Resize the edit control contained in the view to
// fill the entire view when the view's window is
// resized. CMdiView is a CView derived class.
void CMdiView::OnSize(UINT nType, int cx, int cy)
{
   CView::OnSize(nType, cx, cy);
   // Resize edit to fill the whole view.
   // OnSize can be called before OnInitialUpdate
   // so make sure the edit control has been created.
   if (::IsWindow(m_Edit.GetSafeHwnd()))
   {
      m_Edit.MoveWindow(0, 0, cx, cy);
   }
}

`CWnd::OnSizeClipboard`

クリップボード所有者の OnSizeClipboard メンバー関数は、クリップボードに CF_OWNERDISPLAY 属性を持つデータが含まれており、クリップボードビューアーウィンドウのクライアント領域のサイズが変更された場合に、クリップボードビューアーによって呼び出されます。

afx_msg void OnSizeClipboard(
    CWnd* pClipAppWnd,
    HGLOBAL hRect);

パラメーター

pClipAppWnd
クリップボードアプリケーションウィンドウを識別します。ポインターは一時的なものであり、格納しないでください。

hRect
グローバルメモリオブジェクトを識別します。メモリオブジェクトには、クリップボードの所有者が描画する領域を指定する RECT データ構造が含まれています。

解説

OnSizeClipboardメンバー関数は、クリップボードアプリケーションが破棄または最小化されようとしているときに、新しいサイズとして null 四角形 (0,0,0,0) で呼び出されます。これにより、クリップボードの所有者は表示リソースを解放できます。

OnSizeClipboard内では、アプリケーションは GlobalLock Windows 関数を使用して、RECT データ構造を含むメモリをロックする必要があります。制御を生成または返す前に、 GlobalUnlock Windows 関数を使用してそのメモリのロックを解除します。

Note

`CWnd::OnSizing`

フレームワークは、このメンバー関数を呼び出して、ユーザーが四角形のサイズを変更していることを示します。

afx_msg void OnSizing(
    UINT nSide,
    LPRECT lpRect);

パラメーター

nSide
移動するウィンドウの端。

lpRect
アイテムの座標を含む CRect または RECT 構造体のアドレス。

解説

アプリケーションではこのメッセージを処理して、ドラッグ四角形のサイズと位置を監視し、必要に応じてそのサイズまたは位置を変更できます。

Note

例

void CSplitChildFrm::OnSizing(UINT fwSide, LPRECT pRect)
{
   CMDIChildWnd::OnSizing(fwSide, pRect);

   // Resize the splitter window in the frame. m_wndSplitter is of 
   // type CSplitterWnd
   int nWidth = (pRect->right) - (pRect->left);
   m_wndSplitter.SetColumnInfo(0, nWidth / 2, 10);
   m_wndSplitter.SetColumnInfo(1, nWidth / 2, 10);
   m_wndSplitter.RecalcLayout();
}

`CWnd::OnSpoolerStatus`

このメンバー関数は、ジョブが Print Manager キューに追加または削除されるたびに、このメンバー関数を Print Manager から呼び出します。

afx_msg void OnSpoolerStatus(
    UINT nStatus,
    UINT nJobs);

パラメーター

nStatus
SP_JOBSTATUS フラグを指定します。

nJobs
印刷マネージャーキューに残っているジョブの数を指定します。

解説

この呼び出しは情報提供のみを目的としています。

Note

`CWnd::OnStyleChanged`

フレームワークは、 SetWindowLong 関数が 1 つ以上のウィンドウのスタイルを変更した後に、このメンバー関数を呼び出します。

afx_msg void OnStyleChanged(
    int nStyleType,
    LPSTYLESTRUCT lpStyleStruct);

パラメーター

nStyleType
ウィンドウの拡張スタイルと意図しないスタイルのどちらを変更したかを指定します。このパラメーターは、次の値と組み合わせて指定できます。

GWL_EXSTYLE ウィンドウの拡張スタイルが変更されました。
GWL_STYLE ウィンドウの意図しないスタイルが変更されました。

lpStyleStruct
ウィンドウの新しいスタイルを含む STYLESTRUCT 構造体をポイントします。アプリケーションはスタイルを調べることができますが、変更することはできません。

解説

Note

`CWnd::OnStyleChanging`

フレームワークは、 SetWindowLong 関数が 1 つ以上のウィンドウのスタイルを変更しようとしているときに、このメンバー関数を呼び出します。

afx_msg void OnStyleChanging(
    int nStyleType,
    LPSTYLESTRUCT lpStyleStruct);

パラメーター

GWL_EXSTYLE ウィンドウの拡張スタイルが変更されました。
GWL_STYLE ウィンドウの意図しないスタイルが変更されました。

lpStyleStruct
ウィンドウの新しいスタイルを含む STYLESTRUCT 構造体をポイントします。アプリケーションはスタイルを調べて変更できます。

解説

Note

`CWnd::OnSysChar`

フレームワークは、 CWnd が入力フォーカスを持ち、 WM_SYSKEYUP メッセージと WM_SYSKEYDOWN メッセージが変換された場合に、このメンバー関数を呼び出します。

afx_msg void OnSysChar(
    UINT nChar,
    UINT nRepCnt,
    UINT nFlags);

パラメーター

nChar
コントロールメニューキーの ASCII 文字キーコードを指定します。

nRepCnt
ユーザーがキーを押した結果としてキーストロークが繰り返される回数、つまり繰り返し回数を指定します。

nFlags
nFlags パラメーターには、次の値を指定できます。

値	意味
0-15	繰り返し数を指定します。値は、ユーザーがキーを押した結果としてキーストロークが繰り返される回数です。
16-23	スキャンコードを指定します。値は、元の機器の製造元 (OEM) によって異なります
24	拡張された 101 キーまたは 102 キーキーボードに表示される右側の Alt キーや Ctrl キーなど、キーが拡張キーかどうかを指定します。拡張キーの場合、値は 1 です。それ以外の場合は 0 です。
25-28	Windows によって内部的に使用されます。
29	コンテキストコードを指定します。 Alt キーを押しながらキーを押すと、値は 1 になります。それ以外の場合、値は 0 です。
30	前のキーの状態を指定します。メッセージが送信される前にキーがダウンしている場合は値 1、キーが稼働している場合は 0 です。
31	遷移状態を指定します。キーが解放されている場合は値 1、キーが押されている場合は 0 です。

解説

コントロールメニューキーの仮想キーコードを指定します。 (標準の仮想キーコードの一覧については、Winuser.h を参照してください)

コンテキストコードが 0 の場合、 WM_SYSCHAR は WM_SYSCHAR メッセージを TranslateAccelerator Windows 関数に渡すことができます。この関数は、システム文字キーではなく通常のキーメッセージであるかのように処理します。これにより、アクティブウィンドウに入力フォーカスがない場合でも、アクティブウィンドウでアクセラレータキーを使用できます。

Note

`CWnd::OnSysColorChange`

フレームワークは、システムの色設定で変更が行われたときに、すべての最上位ウィンドウに対してこのメンバー関数を呼び出します。

afx_msg void OnSysColorChange();

解説

Windows は、システムの色の変更の影響を受けるウィンドウに対して OnSysColorChange を呼び出します。

既存のシステムカラーを使用するブラシがあるアプリケーションでは、それらのブラシを削除し、新しいシステムカラーで再作成する必要があります。

`CWnd::OnSysCommand`

フレームワークは、ユーザーが [コントロール] メニューからコマンドを選択したとき、またはユーザーが [最大化] または [最小化] ボタンを選択したときに、このメンバー関数を呼び出します。

afx_msg void OnSysCommand(
    UINT nID,
    LPARAM lParam);

パラメーター

nID
要求されたシステムコマンドの種類を指定します。このパラメーターには、次のいずれかの値を指定できます。

SC_CLOSECWnd オブジェクトを閉じます。
SC_HOTKEY アプリケーション指定のホットキーに関連付けられている CWnd オブジェクトをアクティブにします。 lParamの下位ワードは、アクティブにするウィンドウのHWNDを識別します。
SC_HSCROLL 水平方向にスクロールします。
SC_KEYMENU キーストロークを使用してメニューを取得します。
SC_MAXIMIZE (または SC_ZOOM) CWnd オブジェクトを最大化します。
SC_MINIMIZE (または SC_ICON) CWnd オブジェクトを最小化します。
SC_MOUSEMENU マウスクリックでメニューを取得します。
SC_MOVECWnd オブジェクトを移動します。
SC_NEXTWINDOW 次のウィンドウに移動します。
SC_PREVWINDOW 前のウィンドウに移動します。
SC_RESTORE ウィンドウを通常の位置とサイズに戻します。
SC_SCREENSAVESYSTEM.INI ファイルの [boot] セクションで指定されたスクリーンセーバーアプリケーションを実行します。
SC_SIZECWnd オブジェクトのサイズを変更します。
SC_TASKLIST Windows タスクマネージャーアプリケーションを実行またはアクティブ化します。
SC_VSCROLL 垂直方向にスクロールします。

lParam
マウスでコントロールメニューコマンドを選択した場合、 lParam にはカーソル座標が含まれます。下位ワードには x 座標が含まれており、上位ワードには y 座標が含まれます。それ以外の場合、このパラメーターは使用されません。

SC_HOTKEY アプリケーション指定のホットキーに関連付けられているウィンドウをアクティブにします。 lParamの下位ワードは、アクティブにするウィンドウを識別します。
SC_SCREENSAVEコントロールパネルの [デスクトップ] セクションで指定した画面保存アプリケーションを実行します。

解説

既定では、 OnSysCommand は、前の表で指定した定義済みのアクションに対して Control メニュー要求を実行します。

WM_SYSCOMMAND メッセージでは、nID パラメーターの下位 4 ビットが Windows によって内部的に使用されます。アプリケーションは、 nIDの値をテストするときに、ビットごとの AND 演算子を使用して、0xFFF0値と nID 値を組み合わせて正しい結果を取得する必要があります。

コントロールメニューのメニュー項目は、 GetSystemMenu、 AppendMenu、 InsertMenu、およびメンバー関数 ModifyMenu 変更できます。 [制御] メニューを変更するアプリケーションは、 WM_SYSCOMMAND メッセージを処理する必要があり、アプリケーションによって処理されない WM_SYSCOMMAND メッセージは、 OnSysCommandに渡す必要があります。アプリケーションによって追加されたコマンド値は、アプリケーションによって処理される必要があり、 OnSysCommandに渡すことはできません。

アプリケーションは、 WM_SYSCOMMAND メッセージを OnSysCommandに渡すことによって、いつでも任意のシステムコマンドを実行できます。

[コントロール] メニューから項目を選択するために定義されたアクセラレータ (ショートカット) キーストロークは、 OnSysCommand 呼び出しに変換されます。他のすべてのアクセラレータキーストロークは、 WM_COMMAND メッセージに変換されます。

Note

`CWnd::OnSysDeadChar`

フレームワークは、OnSysKeyUpまたはOnSysKeyDownメンバー関数が呼び出されたときに、CWnd オブジェクトに入力フォーカスがある場合に、このメンバー関数呼び出します。

afx_msg void OnSysDeadChar(
    UINT nChar,
    UINT nRepCnt,
    UINT nFlags);

パラメーター

nChar
配信不能キー文字の値を指定します。

nRepCnt
繰り返し数を指定します。

nFlags
次の一覧に示すように、スキャンコード、キー遷移コード、以前のキー状態、コンテキストコードを指定します。

値	意味
0-7	スキャンコード (OEM に依存する値)。上位ワードの下位バイト。
8	拡張キー (ファンクションキーやテンキーのキーなど) (拡張キーの場合は 1、それ以外の場合は 0)。
9 から 10	未使用。
11-12	Windows によって内部的に使用されます。
13	コンテキストコード (キーが押されている間に Alt キーが押されている場合は 1、それ以外の場合は 0)。
14	以前のキーの状態 (キーが呼び出しの前にダウンしている場合は 1、キーがアップの場合は 0)。
15	遷移状態 (キーが解放されている場合は 1、キーが押されている場合は 0)。

解説

デッドキーの文字値を指定します。

Note

`CWnd::OnSysKeyDown`

CWnd オブジェクトに入力フォーカスがある場合、ユーザーが Alt キーを押しながら別のキーを押すと、OnSysKeyDown メンバー関数がフレームワークによって呼び出されます。

afx_msg void OnSysKeyDown(
    UINT nChar,
    UINT nRepCnt,
    UINT nFlags);

パラメーター

nChar
押されるキーの仮想キーコードを指定します。標準的な仮想キーコードの一覧については、Winuser.h を参照してください。

nRepCnt
繰り返し数を指定します。

nFlags
次の一覧に示すように、スキャンコード、キー遷移コード、以前のキー状態、コンテキストコードを指定します。

値	意味
0-7	スキャンコード (OEM に依存する値)。上位ワードの下位バイト。
8	拡張キー (ファンクションキーやテンキーのキーなど) (拡張キーの場合は 1、それ以外の場合は 0)。
9 から 10	未使用。
11-12	Windows によって内部的に使用されます。
13	コンテキストコード (Alt キーが押されている場合は 1、それ以外の場合は 0)。
14	以前のキーの状態 (メッセージが送信される前にキーがダウンしている場合は 1、キーが稼働している場合は 0)。
15	遷移状態 (キーが解放されている場合は 1、キーが押されている場合は 0)。

OnSysKeyDown呼び出しの場合、キー遷移ビット (ビット 15) は 0 です。キーが押されている間に Alt キーがダウンしている場合、コンテキストコードビット (ビット 13) は 1 です。入力フォーカスを持つウィンドウがないため、メッセージがアクティブウィンドウに送信される場合は 0 になります。

解説

現在、入力フォーカスを持つウィンドウがない場合は、アクティブウィンドウの OnSysKeyDown メンバー関数が呼び出されます。メッセージを受け取る CWnd オブジェクトは、 nFlagsのコンテキストコードを確認することで、これら 2 つのコンテキストを区別できます。

コンテキストコードが 0 の場合、OnSysKeyDownで受信したWM_SYSKEYDOWN メッセージを TranslateAccelerator Windows 関数に渡すことができます。この関数は、システムキーメッセージではなく通常のキーメッセージであるかのように処理します。これにより、アクティブウィンドウに入力フォーカスがない場合でも、アクティブウィンドウでアクセラレータキーを使用できます。

自動繰り返しのため、WM_SYSKEYUP メッセージを受信する前に、複数のOnSysKeyDown呼び出しが発生する可能性があります。前のキー状態 (ビット 14) を使用して、 OnSysKeyDown 呼び出しが最初のダウン遷移または繰り返しダウン遷移を示すかどうかを判断できます。

IBM Enhanced 101 および 102 キー・キーボードの場合、拡張キーは右 ALT キーボードのメイン・セクションの右 CTRL キーです。 INS、 DEL、 HOME、 END、 PAGE UP、 PAGE DOWN、およびテンキーの左側にあるクラスターの方向キー、およびスラッシュ (/) キーと ENTER キー キー。他の一部のキーボードは、 nFlagsで拡張キービットをサポートしている場合があります。

Note

`CWnd::OnSysKeyUp`

CWnd オブジェクトにフォーカスがある場合、alt キーが押されている間に押されたキーをユーザーが離すと、OnSysKeyUp メンバー関数がフレームワークによって呼び出されます。

afx_msg void OnSysKeyUp(
    UINT nChar,
    UINT nRepCnt,
    UINT nFlags);

パラメーター

nChar
押されるキーの仮想キーコードを指定します。標準の仮想キーコードの一覧については、 Winuser.h

nRepCnt
繰り返し数を指定します。

nFlags
次の一覧に示すように、スキャンコード、キー遷移コード、以前のキー状態、コンテキストコードを指定します。

値	意味
0-7	スキャンコード (OEM に依存する値)。上位ワードの下位バイト。
8	拡張キー (ファンクションキーやテンキーのキーなど) (拡張キーの場合は 1、それ以外の場合は 0)。
9 から 10	未使用。
11-12	Windows によって内部的に使用されます。
13	コンテキストコード (Alt キーが押されている場合は 1、それ以外の場合は 0)。
14	以前のキーの状態 (メッセージが送信される前にキーがダウンしている場合は 1、キーが稼働している場合は 0)。
15	遷移状態 (キーが解放されている場合は 1、キーが押されている場合は 0)。

OnSysKeyUp呼び出しの場合、キー遷移ビット (ビット 15) は 1 です。キーが押されている間に Alt キーがダウンしている場合、コンテキストコードビット (ビット 13) は 1 です。入力フォーカスを持つウィンドウがないため、メッセージがアクティブウィンドウに送信される場合は 0 になります。

解説

現在、入力フォーカスを持つウィンドウがない場合は、アクティブウィンドウの OnSysKeyUp メンバー関数が呼び出されます。呼び出しを受け取る CWnd オブジェクトは、 nFlagsでコンテキストコードを確認することで、これら 2 つのコンテキストを区別できます。

コンテキストコードが 0 の場合、OnSysKeyUpで受信したWM_SYSKEYUP メッセージを TranslateAccelerator Windows 関数に渡すことができます。この関数は、システムキーメッセージではなく通常のキーメッセージであるかのように処理します。これにより、アクティブウィンドウに入力フォーカスがない場合でも、アクティブウィンドウでアクセラレータ (ショートカット) キーを使用できます。

IBM Enhanced 101 キーおよび 102 キー・キーボードの場合、拡張キーはキーボードのメイン・セクションの右 ALT キーと右 CTRL キーです。テンキーの左側にあるクラスター内の INS、DEL、HOME、END、PAGE UP、PAGE DOWN、および方向キー。テンキーのスラッシュ (/) キーと Enter キーを使用します。他の一部のキーボードでは、 nFlags の拡張キービットがサポートされている場合があります。

米国以外の場合拡張された 102 キーキーボードでは、右 Alt キーは Ctrl + Alt キーの組み合わせとして処理されます。ユーザーがこのキーを押して離したときに発生するメッセージと呼び出しのシーケンスを次に示します。

シークエンス	アクセスされた関数	渡されたメッセージ
1.	`WM_KEYDOWN`	`VK_CONTROL`
2.	`WM_KEYDOWN`	`VK_MENU`
3.	`WM_KEYUP`	`VK_CONTROL`
4.	`WM_SYSKEYUP`	`VK_MENU`

Note

`CWnd::OnTCard`

フレームワークは、ユーザーが作成可能なボタンをクリックすると、このメンバー関数を呼び出します。

afx_msg void OnTCard(
    UINT idAction,
    DWORD dwActionData);

パラメーター

idAction
ユーザーが実行したアクションを示します。このパラメーターには、次のいずれかの値を指定できます。

IDABORT ユーザーが作成可能な [中止] ボタンをクリックしました。
IDCANCEL ユーザーが作成可能な [キャンセル] ボタンをクリックしました。
IDCLOSE ユーザーがトレーニングカードを閉じた。
IDHELP ユーザーが作成可能な Windows ヘルプボタンをクリックしました。
IDIGNORE ユーザーが作成可能な [無視] ボタンをクリックしました。
IDOK ユーザーが作成可能な [OK] ボタンをクリックしました。
IDNO ユーザーが作成可能な [いいえ] ボタンをクリックしました。
IDRETRY ユーザーが作成可能な [再試行] ボタンをクリックしました。
HELP_TCARD_DATA ユーザーが作成可能なボタンをクリックしました。 dwActionData パラメーターには、ヘルプ作成者によって指定された長整数が含まれています。
HELP_TCARD_NEXT ユーザーが作成可能な [次へ] ボタンをクリックしました。
HELP_TCARD_OTHER_CALLER 別のアプリケーションがトレーニングカードを要求しました。
IDYES ユーザーが作成可能な [はい] ボタンをクリックしました。

dwActionData
idActionHELP_TCARD_DATAを指定する場合、このパラメーターはヘルプ作成者によって指定された長整数です。それ以外の場合、このパラメーターはゼロです。

解説

この関数は、アプリケーションが Windows ヘルプでトレーニングカードを開始した場合にのみ呼び出されます。アプリケーションは、WinHelp関数の呼び出しで HELP_TCARD コマンドを指定してトレーニングカードを開始します。

`CWnd::OnTimeChange`

フレームワークは、システム時刻が変更された後にこのメンバー関数を呼び出します。

afx_msg void OnTimeChange();

解説

システム時刻を変更するすべてのアプリケーションに、このメッセージをすべての最上位ウィンドウに送信させます。 WM_TIMECHANGE メッセージをすべての最上位ウィンドウに送信するために、アプリケーションは SendMessage Windows 関数を使用し、そのhwnd パラメーターを HWND_BROADCAST に設定できます。

`CWnd::OnTimer`

フレームワークは、タイマーのインストールに使用される SetTimer メンバー関数で指定された間隔ごとに、このメンバー関数を呼び出します。

afx_msg void OnTimer(UINT_PTR nIDEvent);

パラメーター

nIDEvent
タイマーの識別子を指定します。

解説

DispatchMessage Windows 関数は、他のメッセージがアプリケーションのメッセージキューに存在しない場合に、WM_TIMER メッセージを送信します。

Note

例

「CWnd::SetTimer」の例を参照してください。

`CWnd::OnToolHitTest`

フレームワークは、このメンバー関数を呼び出して、ポイントが指定したツールの外接する四角形内にあるかどうかを判断します。

virtual INT_PTR OnToolHitTest(
    CPoint point,
    TOOLINFO* pTI) const;

パラメーター

point
カーソルの x 座標と y 座標を指定します。これらの座標は、常にウィンドウの左上隅を基準にしています

pTI
TOOLINFO 構造体へのポインター。既定では、次の構造体の値が設定されています。

hwnd = m_hWnd ウィンドウへのハンドル
uId = (UINT)hWndChild 子ウィンドウへのハンドル
uFlags |= TTF_IDISHWND ツールのハンドル
lpszText = LPSTR_TEXTCALLBACK 指定したウィンドウに表示される文字列へのポインター

戻り値

ツールヒントコントロールが見つかった場合は、ウィンドウコントロール ID。ツールヒントコントロールが見つからなかった場合は -1。

解説

ポイントが四角形内にある場合は、ツールに関する情報を取得します。

ツールヒントが関連付けられている領域がボタンでない場合は、OnToolHitTestTTF_NOTBUTTONおよびTTF_CENTERTIPに構造体フラグを設定します。

OnToolHitTestをオーバーライドして、既定値とは異なる情報を提供します。

構造の詳細については、Windows SDK の TOOLINFOを参照してください。

`CWnd::OnTouchInput`

Windows タッチからの 1 つの入力を処理します。

virtual BOOL OnTouchInput(
    CPoint pt,
    int nInputNumber,
    int nInputsCount,
    PTOUCHINPUT pInput);

パラメーター

pt
画面がタッチされたポイント (クライアント座標)。

nInputNumber
タッチ入力の数。

nInputsCount
タッチ入力の合計数。

pInput
TOUCHINPUT 構造体へのポインター。

戻り値

TRUE アプリケーションが Windows タッチ入力を処理する場合。それ以外の場合は FALSE。

解説

`CWnd::OnTouchInputs`

Windows タッチからの入力を処理します。

virtual BOOL OnTouchInputs(
    UINT nInputsCount,
    PTOUCHINPUT pInputs);

パラメーター

nInputsCount
Windows タッチ入力の合計数。

pInputs
TOUCHINPUTの配列。

戻り値

TRUE アプリケーションが Windows タッチ入力を処理する場合。それ以外の場合は FALSE。

解説

`CWnd::OnUniChar`

フレームワークは、キーが押されたときにこのメンバー関数を呼び出します。つまり、現在のウィンドウにはキーボードフォーカスがあり、 WM_KEYDOWN メッセージは TranslateMessage 関数によって変換されます。

afx_msg void OnUniChar(
    UINT nChar,
    UINT nRepCnt,
    UINT nFlags);

パラメーター

nChar
[in]押されたキーの文字コードを指定します。

nRepCnt
[in]現在のメッセージの繰り返し数を指定します。この値は、ユーザーがキーを押した結果としてキーストロークが自動で表示される回数です。キーストロークが十分に長く保持されている場合は、複数のメッセージが送信されます。ただし、繰り返し数は累積されません。

nFlags
[in]次の表に示すように、スキャンコード、拡張キー、コンテキストコード、以前のキーの状態、および遷移状態を指定するフラグ。

フラグビット	説明
0-7	スキャンコードを指定します。この値は、OEM (オリジナルの機器メーカー) によって異なります。
8	拡張された 101 または 102 キーのキーボードに表示される、右側の Alt キーや Ctrl キーなどの拡張キーを指定します。キーが拡張キーの場合、フラグは 1 です。それ以外の場合は 0 です。
9-12	Windows によって内部的に使用されます。
13	コンテキストコードを指定します。キーが押されている間に Alt キーが押されている場合、フラグは 1 です。それ以外の場合、値は 0 です。
14 前のキーの状態を指定します。フラグは、メッセージが送信される前にキーがダウンしている場合は 1、キーが稼働している場合は 0 です。
15	遷移状態を指定します。フラグは、キーが解放されている場合は 1、キーが押されている場合は 0 です。

解説

このメソッドは、Windows SDK で説明されている WM_UNICHAR 通知を受け取ります。 WM_UNICHAR メッセージは、UNICODE 文字を ANSI ウィンドウに送信またはポストするように設計されています。 WM_CHAR メッセージと同じですが、Unicode 変換形式 32 エンコード (UTF-32) が使用されますが、WM_CHAR メッセージでは UTF-16 が使用されます。

Note

`CWnd::OnUnInitMenuPopup`

フレームワークは、ドロップダウンメニューまたはサブメニューが破棄されたときに、このメンバー関数を呼び出します。

afx_msg void OnUnInitMenuPopup(
    CMenu* pPopupMenu,
    UINT nFlags);

パラメーター

pMenu
[in]メニューまたはサブメニューを表す CMenu オブジェクトへのポインター。

nFlags
[in]破棄されたメニュー。現時点では、ウィンドウメニュー ( MF_SYSMENUのみ) にすることができます。

解説

このメソッドは、Windows SDK で説明されている WM_UNINITMENUPOPUP 通知を受け取ります。

Note

`CWnd::OnUpdateUIState`

指定したウィンドウとすべての子ウィンドウのユーザーインターフェイス (UI) 状態を変更するときに呼び出されます。

afx_msg void OnUpdateUIState(
    UINT nAction,
    UINT nUIElement);

パラメーター

nAction
実行する操作を指定します。値は、次のいずれかです。

UIS_CLEAR UI 状態要素 ( nUIElement で指定) は非表示にする必要があります。
UIS_INITIALIZE UI 状態要素 ( nUIElement で指定) は、最後の入力イベントに基づいて変更する必要があります。詳細については、WM_UPDATEISTATEの「Remarks」セクションを参照してください。
UIS_SET UI 状態要素 ( nUIElement で指定) を表示する必要があります。

nUIElement
影響を受ける UI 状態要素またはコントロールのスタイルを指定します。値は、次のいずれかです。

UISF_HIDEACCEL キーボードアクセラレータ。
UISF_HIDEFOCUS フォーカスインジケーター。
UISF_ACTIVE Windows XP: コントロールは、アクティブなコントロールに使用されるスタイルで描画する必要があります。

解説

このメンバー関数は、Windows SDK で説明されているように、 WM_UPDATEUISTATE メッセージの機能をエミュレートします。

`CWnd::OnUserChanged`

フレームワークは、ユーザーがログオンまたはログオフした後、すべてのウィンドウに対してこのメンバーを呼び出します。

afx_msg void OnUserChanged();

解説

このメソッドは、Windows SDK で説明されている WM_USERCHANGED 通知メッセージを受け取ります。ユーザーがログオンまたはログオフすると、オペレーティングシステムはユーザー固有の設定を更新します。システムでは、設定を更新した直後にこのメッセージを送信します。

Note

`CWnd::OnVKeyToItem`

CWnd オブジェクトがLBS_WANTKEYBOARDINPUT スタイルのリストボックスを所有している場合、リストボックスは、WM_KEYDOWN メッセージに応答してWM_VKEYTOITEM メッセージを送信します。

afx_msg int OnVKeyToItem(
    UINT nKey,
    CListBox* pListBox,
    UINT nIndex);

パラメーター

nKey
ユーザーが押したキーの仮想キーコードを指定します。標準の仮想キーコードの一覧については、 Winuser.h

pListBox
リストボックスへのポインターを指定します。ポインターは一時的なものであり、後で使用するために格納しないでください。

nIndex
現在のキャレット位置を指定します。

戻り値

メッセージに応答してアプリケーションが実行したアクションを指定します。戻り値 -2 は、項目選択のすべての側面がアプリケーションによって処理され、リストボックスによるそれ以上のアクションが不要であることを示します戻り値 -1 は、リストボックスがキーストロークに応答して既定のアクションを実行する必要があることを示します。戻り値が 0 以上の場合は、リストボックス内の項目の 0 から始まるインデックスを指定し、リストボックスが指定された項目に対してキーストロークの既定のアクションを実行する必要があることを示します。

解説

このメンバー関数は、 LBS_HASSTRINGS スタイルを持つリストボックスに対してのみフレームワークによって呼び出されます。

Note

`CWnd::OnVScroll`

フレームワークは、ユーザーがウィンドウの垂直スクロールバーをクリックすると、このメンバー関数を呼び出します。

afx_msg void OnVScroll(
    UINT nSBCode,
    UINT nPos,
    CScrollBar* pScrollBar);

パラメーター

nSBCode
ユーザーのスクロール要求を示すスクロールバーコードを指定します。このパラメーターには、次のいずれかを指定できます。

SB_BOTTOM 下にスクロールします。
SB_ENDSCROLL スクロールを終了します。
SB_LINEDOWN 1 行下にスクロールします。
SB_LINEUP 1 行上にスクロールします。
SB_PAGEDOWN 1 ページ下にスクロールします。
SB_PAGEUP 1 ページ上にスクロールします。
SB_THUMBPOSITION 絶対位置までスクロールします。現在位置は nPosで提供されます。
SB_THUMBTRACK スクロールボックスを指定した位置にドラッグします。現在位置は nPosで提供されます。
SB_TOP 上にスクロールします。

nPos
スクロールバーコードが SB_THUMBPOSITION または SB_THUMBTRACKされている場合は、現在のスクロールボックスの位置を格納します。それ以外の場合は使用されません。初期スクロール範囲によっては、 nPos が負の値になる場合があり、必要に応じて int にキャストする必要があります。

解説

OnVScroll 通常は、スクロールボックスのドラッグ中にフィードバックを送信するアプリケーションで使用されます。

OnVScrollCWndオブジェクトの内容をスクロールする場合は、SetScrollPosメンバー関数を使用してスクロールボックスの位置をリセットする必要もあります。

Note

`CWnd::OnVScrollClipboard`

クリップボードの所有者の OnVScrollClipboard メンバー関数は、クリップボードのデータが CF_OWNERDISPLAY 形式で、クリップボードビューアーの垂直スクロールバーにイベントがある場合に、クリップボードビューアーによって呼び出されます。

afx_msg void OnVScrollClipboard(
    CWnd* pClipAppWnd,
    UINT nSBCode,
    UINT nPos);

パラメーター

nSBCode
次のいずれかのスクロールバー値を指定します。

SB_BOTTOM 下にスクロールします。
SB_ENDSCROLL スクロールを終了します。
SB_LINEDOWN 1 行下にスクロールします。
SB_LINEUP 1 行上にスクロールします。
SB_PAGEDOWN 1 ページ下にスクロールします。
SB_PAGEUP 1 ページ上にスクロールします。
SB_THUMBPOSITION 絶対位置までスクロールします。現在位置は nPosで提供されます。
SB_TOP 上にスクロールします。

nPos
スクロールバーコードが SB_THUMBPOSITIONされている場合はスクロールボックスの位置を格納します。それ以外の場合 nPos は使用されません。

解説

所有者は、クリップボードイメージをスクロールし、適切なセクションを無効にして、スクロールバーの値を更新する必要があります。

Note

`CWnd::OnWindowMaximizedChanged`

フレームワークは、現在のウィンドウが最大化され、ウィンドウがデスクトップウィンドウマネージャー (DWM) によって構成されている場合に、このメンバーを呼び出します。

afx_msg void OnWindowMaximizedChanged(BOOL bIsMaximized);

パラメーター

bIsMaximized
[入力] TRUE 現在のウィンドウが最大化されている場合は、表示されない場合は FALSE 。

解説

このメソッドは、Windows SDK で説明されている WM_DWMWINDOWMAXIMIZEDCHANGE 通知メッセージを受け取ります。

Note

`CWnd::OnWindowPosChanged`

フレームワークは、 SetWindowPos メンバー関数または別のウィンドウ管理機能の呼び出しの結果、サイズ、位置、または Z オーダーが変更されたときに、このメンバー関数を呼び出します。

afx_msg void OnWindowPosChanged(WINDOWPOS* lpwndpos);

パラメーター

lpwndpos
ウィンドウの新しいサイズと位置に関する情報を含む WINDOWPOS データ構造を指します。

解説

既定の実装では、 WM_SIZE と WM_MOVE メッセージがウィンドウに送信されます。アプリケーションが基底クラスを呼び出さずに OnWindowPosChanged 呼び出しを処理する場合、これらのメッセージは送信されません。基底クラスを呼び出さずに、 OnWindowPosChanged の呼び出し中に移動またはサイズ変更処理を実行する方が効率的です。

Note

`CWnd::OnWindowPosChanging`

フレームワークは、 SetWindowPos メンバー関数または別のウィンドウ管理機能の呼び出しの結果として、サイズ、位置、または Z オーダーが変更されようとしているときに、このメンバー関数を呼び出します。

afx_msg void OnWindowPosChanging(WINDOWPOS* lpwndpos);

パラメーター

lpwndpos
ウィンドウの新しいサイズと位置に関する情報を含む WINDOWPOS データ構造を指します。

解説

アプリケーションは、WINDOWPOS構造体のflags メンバー内の適切なビットを設定またはクリアすることで、ウィンドウの変更を防ぐことができます。

WS_OVERLAPPEDまたはWS_THICKFRAME スタイルのウィンドウの場合、既定の実装では、WM_GETMINMAXINFO メッセージがウィンドウに送信されます。これは、ウィンドウの新しいサイズと位置を検証し、 CS_BYTEALIGNCLIENT と CS_BYTEALIGN のクライアントスタイルを適用するために行われます。アプリケーションでは、基底クラスを呼び出さないと、この機能をオーバーライドできます。

Note

`CWnd::OnWinIniChange`

フレームワークは、Windows 初期化ファイル ( WIN.INI) に変更が加えられた後、このメンバー関数を呼び出します。

afx_msg void OnWinIniChange(LPCTSTR lpszSection);

パラメーター

lpszSection
変更されたセクションの名前を指定する文字列を指します。 (文字列には、セクション名を囲む角かっこは含まれません)。

解説

SystemParametersInfo Windows 関数は、アプリケーションが関数を使用してWIN.INI ファイルの設定を変更した後にOnWinIniChangeを呼び出します。

WM_WININICHANGE メッセージをすべての最上位ウィンドウに送信するために、アプリケーションは SendMessage Windows 関数を使用し、そのhwnd パラメーターを HWND_BROADCAST に設定できます。

アプリケーションがWIN.INIのさまざまなセクションを同時に変更した場合、アプリケーションは、lpszSectionが NULL に設定された 1 つのWM_WININICHANGE メッセージを送信する必要があります。それ以外の場合、アプリケーションはWIN.INIに変更を行うたびにWM_WININICHANGEを送信する必要があります。

アプリケーションがNULLに設定lpszSectionOnWinIniChange呼び出しを受け取った場合、アプリケーションは WIN のすべてのセクションを確認する必要があります。アプリケーションに影響を与える INI。

Note

`CWnd::OnWndMsg`

このメンバー関数は、 WindowProcによって呼び出されるか、メッセージのリフレクション中に呼び出されます。

virtual BOOL OnWndMsg(
    UINT message,
    WPARAM wParam,
    LPARAM lParam,
    LRESULT* pResult);

パラメーター

message
送信するメッセージを指定します。

wParam
メッセージに依存する追加の情報を指定します。

lParam
メッセージに依存する追加の情報を指定します。

pResult
WindowProcの戻り値。メッセージによって異なります。が NULLされる場合があります。

戻り値

メッセージが処理された場合は TRUE。それ以外の場合は FALSE。

解説

OnWndMsgはメッセージの種類を決定し、適切なフレームワーク関数 (たとえば、WM_COMMANDのOnCommand) を呼び出すか、メッセージマップで適切なメッセージを検索します。

メッセージリフレクションの詳細については、「リフレクションメッセージの処理」を参照してください。

`CWnd::OnXButtonDblClk`

ウィンドウのクライアント領域にカーソルがあるときにユーザーが XBUTTON1 または XBUTTON2 をダブルクリックすると、フレームワークはこのメンバー関数を呼び出します。

afx_msg void OnXButtonDblClk(
    UINT nFlags,
    UINT nButton,
    CPoint point);

パラメーター

nButton
[in]最初の Microsoft Intellimouse X ボタンがダブルクリックされている場合は XBUTTON1 の値。2 番目の X ボタンがダブルクリックされた場合はXBUTTON2。

point
[in]クライアント領域の左上隅を基準にしたカーソルのxおよびy座標を指定するCPoint オブジェクト。

解説

このメソッドは、Windows SDK で説明されている WM_XBUTTONDBLCLK 通知を受け取ります。マウスがキャプチャされていない場合、メッセージはカーソルの下のウィンドウに投稿されます。それ以外の場合、メッセージはマウスをキャプチャしたウィンドウに投稿されます。

nFlags パラメーターには、次の表に示す修飾子キーの組み合わせを指定できます。詳細については、「マウス入力についてを参照してください。

修飾子キー	説明
`MK_CONTROL`	Ctrl キーが押されます。
`MK_LBUTTON`	マウスの左ボタンが押されています。
`MK_MBUTTON`	マウスの中央ボタンが押されています。
`MK_RBUTTON`	マウスの右ボタンが押されています。
`MK_SHIFT`	Shift キーが押されます。
`MK_XBUTTON1`	Microsoft IntelliMouse の `XBUTTON1` マウスボタンが押されます。
`MK_XBUTTON2`	Microsoft IntelliMouse の `XBUTTON2` マウスボタンが押されます。

Note

`CWnd::OnXButtonDown`

ウィンドウのクライアント領域にカーソルがあるときにユーザーが XBUTTON1 または XBUTTON2 を押すと、フレームワークはこのメンバー関数を呼び出します。

afx_msg void OnXButtonDown(
    UINT nFlags,
    UINT nButton,
    CPoint point);

パラメーター

nButton
[in]最初の Microsoft Intellimouse X ボタンがクリックされた場合は XBUTTON1 、2 つ目の X ボタンがクリックされた場合は XBUTTON2 値。

point
[in]クライアント領域の左上隅を基準にしたカーソルのxおよびy座標を指定するCPoint オブジェクト。

解説

このメソッドは、Windows SDK で説明されている WM_XBUTTONDOWN 通知を受け取ります。マウスがキャプチャされていない場合、メッセージはカーソルの下のウィンドウに投稿されます。それ以外の場合、メッセージはマウスをキャプチャしたウィンドウに投稿されます。

nFlags パラメーターには、次の表に示す修飾子キーの組み合わせを指定できます。詳細については、「マウス入力についてを参照してください。

修飾子キー	説明
`MK_CONTROL`	Ctrl キーが押されます。
`MK_LBUTTON`	マウスの左ボタンが押されています。
`MK_MBUTTON`	マウスの中央ボタンが押されています。
`MK_RBUTTON`	マウスの右ボタンが押されています。
`MK_SHIFT`	Shift キーが押されます。
`MK_XBUTTON1`	Microsoft IntelliMouse の `XBUTTON1` マウスボタンが押されます。
`MK_XBUTTON2`	Microsoft IntelliMouse の `XBUTTON2` マウスボタンが押されます。

Note

`CWnd::OnXButtonUp`

ウィンドウのクライアント領域にカーソルがあるときに、ユーザーが XBUTTON1 または XBUTTON2 を離すと、フレームワークはこのメンバー関数を呼び出します。

afx_msg void OnXButtonUp(
    UINT nFlags,
    UINT nButton,
    CPoint point);

パラメーター

nButton
[in]最初の Microsoft Intellimouse X ボタンがダブルクリックされた場合は XBUTTON1 の値。2 つ目の X ボタンがダブルクリックされた場合は XBUTTON2 。

point
[in]クライアント領域の左上隅を基準にしたカーソルのxおよびy座標を指定するCPoint オブジェクト。

解説

このメソッドは、Windows SDK で説明されている WM_XBUTTONUP 通知を受け取ります。マウスがキャプチャされていない場合、メッセージはカーソルの下のウィンドウに投稿されます。それ以外の場合、メッセージはマウスをキャプチャしたウィンドウに投稿されます。

nFlags パラメーターには、次の表に示す修飾子キーの組み合わせを指定できます。詳細については、「マウス入力についてを参照してください。

修飾子キー	説明
`MK_CONTROL`	Ctrl キーが押されます。
`MK_LBUTTON`	マウスの左ボタンが押されています。
`MK_MBUTTON`	マウスの中央ボタンが押されています。
`MK_RBUTTON`	マウスの右ボタンが押されています。
`MK_SHIFT`	Shift キーが押されます。
`MK_XBUTTON1`	Microsoft IntelliMouse の `XBUTTON1` マウスボタンが押されます。
`MK_XBUTTON2`	Microsoft IntelliMouse の `XBUTTON2` マウスボタンが押されます。

Note

`CWnd::OpenClipboard`

クリップボードを開きます。

BOOL OpenClipboard();

戻り値

CWndでクリップボードを開いた場合は 0 以外、別のアプリケーションまたはウィンドウでクリップボードが開かれている場合は 0。

解説

CloseClipboard Windows 関数が呼び出されるまで、他のアプリケーションはクリップボードを変更できません。

EmptyClipboard Windows 関数が呼び出されるまで、現在のCWnd オブジェクトはクリップボードの所有者になりません。

例

//handler for Edit | Copy menu
void CMdiView::OnEditCopy()
{
   if (!OpenClipboard())
   {
      AfxMessageBox(_T("Cannot open the Clipboard"));
      return;
   }
   // Remove the current Clipboard contents
   if (!EmptyClipboard())
   {
      AfxMessageBox(_T("Cannot empty the Clipboard"));
      return;
   }

   // Get the currently selected data, hData handle to
   // global memory of data
   CString str;
   m_Edit.GetWindowText(str);
   size_t cbStr = (str.GetLength() + 1) * sizeof(TCHAR);
   HGLOBAL hData = GlobalAlloc(GMEM_MOVEABLE, cbStr);
   memcpy_s(GlobalLock(hData), cbStr, str.LockBuffer(), cbStr);
   GlobalUnlock(hData);
   str.UnlockBuffer();

   // For the appropriate data formats...
   UINT uiFormat = (sizeof(TCHAR) == sizeof(WCHAR)) ? CF_UNICODETEXT : CF_TEXT;
   if (::SetClipboardData(uiFormat, hData) == NULL)
   {
      AfxMessageBox(_T("Unable to set Clipboard data"));
      CloseClipboard();
      return;
   }

   CloseClipboard();
}

`CWnd::operator HWND`

この演算子を使用して、 CWnd オブジェクトへのハンドルを取得します。

operator HWND() const;

`CWnd::operator !=`

2 つの CWnd オブジェクトを比較して、同じ m_hWndがないかどうかを判断します。

BOOL operator!=(const CWnd& wnd) const;

パラメーター

wnd
CWnd オブジェクトへの参照です。

戻り値

等しい場合は 0 以外。それ以外の場合は 0。

`CWnd::operator ==`

2 つの CWnd オブジェクトを比較して、同じ m_hWndがあるかどうかを判断します。

BOOL operator==(const CWnd& wnd) const;

パラメーター

wnd
CWnd オブジェクトへの参照です。

戻り値

等しい場合は 0 以外。それ以外の場合は 0。

`CWnd::PaintWindowlessControls`

コントロールコンテナーのウィンドウなしのコントロールを描画します。

BOOL PaintWindowlessControls(CDC* pDC);

パラメーター

pDC
ウィンドウレスコントロールを描画するデバイスコンテキスト。

戻り値

コントロールコンテナーがあり、ウィンドウなしのコントロールが正常に描画された場合は TRUE を返します。それ以外の場合は FALSE。

`CWnd::PostMessage`

ウィンドウのメッセージキューにメッセージを配置し、対応するウィンドウがメッセージを処理するのを待たずに戻ります。

BOOL PostMessage(
    UINT message,
    WPARAM wParam = 0,
    LPARAM lParam = 0);

パラメーター

message
投稿するメッセージを指定します。

wParam
追加のメッセージ情報を指定します。このパラメーターの内容は、投稿されるメッセージによって異なります。

lParam
追加のメッセージ情報を指定します。このパラメーターの内容は、投稿されるメッセージによって異なります。

戻り値

メッセージが投稿された場合は 0 以外。それ以外の場合は 0。

解説

メッセージキュー内のメッセージは、 GetMessage または PeekMessage Windows 関数の呼び出しによって取得されます。

Windows PostMessage 関数を使用して、別のアプリケーションにアクセスできます。

例

AfxGetMainWnd の例を参照してください。

`CWnd::PostNcDestroy`

ウィンドウが破棄された後、既定 OnNcDestroy メンバー関数によって呼び出されます。

virtual void PostNcDestroy();

解説

派生クラスは、 this ポインターの削除などのカスタムクリーンアップにこの関数を使用できます。

`CWnd::PreCreateWindow`

この CWnd オブジェクトにアタッチされている Windows ウィンドウを作成する前に、フレームワークによって呼び出されます。

virtual BOOL PreCreateWindow(CREATESTRUCT& cs);

パラメーター

cs
CREATESTRUCT 構造。

戻り値

ウィンドウの作成を続行する必要がある場合は 0 以外。作成エラーを示す場合は 0。

解説

警告

CWnd::PreCreateWindowメニューがNULLされ、スタイルにWS_CHILDが含まれている場合、csの hMenu メンバーがthis ポインターに割り当てられるようになりました。適切な機能を実現するには、ダイアログコントロールに NULLされていない ID があることを確認します。

この関数を直接呼び出すことはありません。

この関数の既定の実装では、 NULL ウィンドウクラス名がチェックされ、適切な既定値に置き換えます。ウィンドウが作成される前に CREATESTRUCT 構造体を変更するには、このメンバー関数をオーバーライドします。

CWndから派生した各クラスは、PreCreateWindowのオーバーライドに独自の機能を追加します。設計上、これらの PreCreateWindow の派生は文書化されていません。各クラスに適したスタイルとスタイル間の相互依存関係を判断するには、アプリケーションの基本クラスの MFC ソースコードを調べることができます。 PreCreateWindow,オーバーライドする場合は、MFC ソースコードから収集された情報を使用して、アプリケーションの基本クラスで使用されるスタイルが必要な機能を提供するかどうかを判断できます。

ウィンドウスタイルの変更の詳細については、「 MFC によって作成されたウィンドウのスタイルの変更を参照してください。

例

// alter the styles of the mdi frame window
BOOL CMdiChildFrame::PreCreateWindow(CREATESTRUCT &cs)
{
   // Create a window without min/max buttons or sizable border
   cs.style |= WS_OVERLAPPED | WS_SYSMENU | WS_BORDER;

   // Size the window to 1/3 screen size and center it
   cs.cy = ::GetSystemMetrics(SM_CYSCREEN) / 3;
   cs.cx = ::GetSystemMetrics(SM_CXSCREEN) / 3;
   cs.y = ((cs.cy * 3) - cs.cy) / 2;
   cs.x = ((cs.cx * 3) - cs.cx) / 2;

   return CMDIChildWnd::PreCreateWindow(cs);
}

`CWnd::PreSubclassWindow`

このメンバー関数は、ウィンドウがサブクラス化される前に他の必要なサブクラス化を行えるようにフレームワークによって呼び出されます。

virtual void PreSubclassWindow();

解説

このメンバー関数をオーバーライドすると、コントロールの動的サブクラス化が可能になります。これは高度なオーバーライド可能です。

`CWnd::PreTranslateMessage`

クラス CWinApp によって、 TranslateMessage および windows 関数にディスパッチされる前にウィンドウメッセージ DispatchMessage 変換するために使用されます。

virtual BOOL PreTranslateMessage(MSG* pMsg);

パラメーター

pMsg
処理するメッセージを含む MSG 構造体を指します。

戻り値

メッセージが翻訳され、ディスパッチすべきでない場合は 0 以外。メッセージが翻訳されておらず、ディスパッチする必要がある場合は 0。

`CWnd::Print`

このメンバー関数を呼び出して、指定されたデバイスコンテキストで現在のウィンドウを描画します。これは、プリンターデバイスコンテキストで最も一般的です。

void Print(
    CDC* pDC,
    DWORD dwFlags) const;

パラメーター

pDC
デバイスコンテキストへのポインター。

dwFlags
描画オプションを指定します。このパラメーターには、次のフラグを 1 つ以上指定できます。

PRF_CHECKVISIBLE ウィンドウが表示されている場合にのみ、ウィンドウを描画します。
PRF_CHILDREN 表示されているすべての子ウィンドウを描画します。
PRF_CLIENT ウィンドウのクライアント領域を描画します。
PRF_ERASEBKGND ウィンドウを描画する前に背景を消去します。
PRF_NONCLIENT ウィンドウの非クライアント領域を描画します。
PRF_OWNED 所有されているすべてのウィンドウを描画します。

解説

CWnd::DefWindowProc 関数は、指定された描画オプションに基づいてこのメッセージを処理します。

PRF_CHECKVISIBLEが指定されていて、ウィンドウが表示されない場合は、何も行わないでください。
PRF_NONCLIENTが指定されている場合は、指定されたデバイスコンテキストで非クライアント領域を描画します。
PRF_ERASEBKGNDを指定した場合は、ウィンドウにWM_ERASEBKGNDメッセージを送信します。
PRF_CLIENTを指定した場合は、ウィンドウにWM_PRINTCLIENTメッセージを送信します。
PRF_CHILDRENが設定されている場合は、表示されている各子ウィンドウにWM_PRINTメッセージを送信します。
PRF_OWNEDが設定されている場合は、表示されている各所有ウィンドウにWM_PRINTメッセージを送信します。

`CWnd::PrintClient`

このメンバー関数を呼び出して、指定されたデバイスコンテキスト (通常はプリンターデバイスコンテキスト) 内のウィンドウを描画します。

void PrintClient(
    CDC* pDC,
    DWORD dwFlags) const;

パラメーター

pDC
デバイスコンテキストへのポインター。

dwFlags
描画オプションを指定します。このパラメーターには、次のフラグを 1 つ以上指定できます。

PRF_CHECKVISIBLE ウィンドウが表示されている場合にのみ、ウィンドウを描画します。
PRF_CHILDREN 表示されているすべての子ウィンドウを描画します。
PRF_CLIENT ウィンドウのクライアント領域を描画します。
PRF_ERASEBKGND ウィンドウを描画する前に背景を消去します。
PRF_NONCLIENT ウィンドウの非クライアント領域を描画します。
PRF_OWNED 所有されているすべてのウィンドウを描画します。

`CWnd::PrintWindow`

表示されているウィンドウを指定されたデバイスコンテキスト (通常はプリンター DC) にコピーします。

BOOL PrintWindow(
    CDC* pDC,
    UINT nFlags) const;

パラメーター

pDC
印刷するデバイスコンテキストへのポインター。

nFlags
描画オプションを指定します。使用可能な値の一覧については、 PrintWindowを参照してください。

戻り値

関数が正常終了した場合は 0 以外。それ以外の場合は 0。

解説

このメンバー関数は、Windows SDK で説明されているように、関数 PrintWindowの機能をエミュレートします。

`CWnd::RedrawWindow`

指定されたウィンドウのクライアント領域内の指定した四角形または領域を更新します。

BOOL RedrawWindow(
    LPCRECT lpRectUpdate = NULL,
    CRgn* prgnUpdate = NULL,
    UINT flags = RDW_INVALIDATE | RDW_UPDATENOW | RDW_ERASE);

パラメーター

lpRectUpdate
更新四角形の座標を含むRECT構造体を指します。 prgnUpdateに有効なリージョンハンドルが含まれている場合、このパラメーターは無視されます。

prgnUpdate
更新リージョンを識別します。 prgnUpdateとlpRectUpdateの両方がNULLされている場合は、クライアント領域全体が更新リージョンに追加されます。

flags
ウィンドウを無効にするには、次のフラグを使用します。

RDW_ERASE ウィンドウが再描画されるときに、ウィンドウに WM_ERASEBKGND メッセージを受信します。 RDW_INVALIDATE フラグも指定する必要があります。それ以外の場合、RDW_ERASEは無効です。
RDW_FRAME 更新領域と交差するウィンドウの非クライアント領域の一部が、 WM_NCPAINT メッセージを受信します。 RDW_INVALIDATE フラグも指定する必要があります。それ以外の場合、RDW_FRAMEは無効です。
RDW_INTERNALPAINT ウィンドウに無効な領域が含まれているかどうかに関係なく、 WM_PAINT メッセージをウィンドウに投稿します。
RDW_INVALIDATElpRectUpdateまたはprgnUpdateを無効にします (NULLできない可能性があるのは 1 つだけです)。両方が NULLされている場合、ウィンドウ全体が無効になります。

ウィンドウの検証には、次のフラグが使用されます。

RDW_NOERASE 保留中の WM_ERASEBKGND メッセージを抑制します。
RDW_NOFRAME 保留中の WM_NCPAINT メッセージを抑制します。このフラグは RDW_VALIDATE と共に使用する必要があり、通常は RDW_NOCHILDRENで使用されます。このオプションは、ウィンドウの一部が正しく描画されない可能性があるため、注意して使用する必要があります。
RDW_NOINTERNALPAINT 保留中の内部 WM_PAINT メッセージを抑制します。このフラグは、無効な領域に起因 WM_PAINT メッセージには影響しません。
RDW_VALIDATElpRectUpdateまたはprgnUpdateを検証します (NULLできない可能性があるのは 1 つだけです)。両方が NULL場合は、ウィンドウ全体が検証されます。このフラグは、内部 WM_PAINT メッセージには影響しません。

次のフラグは、再描画が行われるときに制御します。描画は、これらのビットのいずれかが指定されていない限り、 RedrawWindow 関数によって実行されません。

RDW_ERASENOW 関数が戻る前に、影響を受けるウィンドウ ( RDW_ALLCHILDREN フラグと RDW_NOCHILDREN フラグで指定されている) が、必要に応じて WM_NCPAINT および WM_ERASEBKGND メッセージを受信します。 WM_PAINT メッセージは遅延されます。
RDW_UPDATENOW 影響を受けるウィンドウ ( RDW_ALLCHILDREN フラグと RDW_NOCHILDREN フラグで指定) が、必要に応じて、関数が戻る前に、 WM_NCPAINT、 WM_ERASEBKGND、および WM_PAINT メッセージを受信します。

既定では、 RedrawWindow 関数の影響を受けるウィンドウは、指定したウィンドウに WS_CLIPCHILDREN スタイルがあるかどうかによって異なります。 WS_CLIPCHILDREN ウィンドウの子ウィンドウは影響を受けません。ただし、ウィンドウ WS_CLIPCHILDREN されていないウィンドウは、 WS_CLIPCHILDREN ウィンドウが見つかるまで再帰的に検証または無効化されます。次のフラグは、 RedrawWindow 関数の影響を受けるウィンドウを制御します。

RDW_ALLCHILDREN 再描画操作に子ウィンドウ (存在する場合) が含まれます。
RDW_NOCHILDREN 再描画操作から子ウィンドウ (存在する場合) を除外します。

戻り値

ウィンドウが正常に再描画された場合は 0 以外。それ以外の場合は 0。

解説

RedrawWindow メンバー関数を使用してデスクトップウィンドウの一部を無効にすると、そのウィンドウはWM_PAINTメッセージを受信しません。デスクトップを再描画するには、アプリケーションで CWnd::ValidateRgn、 CWnd::InvalidateRgn、 CWnd::UpdateWindow、または RedrawWindow

`CWnd::ReflectChildNotify`

このメッセージ関数は、フレームワークによって OnChildNotifyから呼び出されます。

BOOL ReflectChildNotify(
    UINT message,
    WPARAM wParam,
    LPARAM lParam,
    LRESULT* pResult);

パラメーター

message
反映するメッセージを指定します。

wParam
メッセージに依存する追加の情報を指定します。

lParam
メッセージに依存する追加の情報を指定します。

pResult
親ウィンドウから返される子ウィンドウによって生成された結果。 NULL の可能性があります。

戻り値

TRUE メッセージが反映された場合。それ以外の場合は FALSE。

解説

これは、ソースに message を反映するヘルパー関数です。

反映されたメッセージは、 CWnd::OnWndMsg または CCmdTarget::OnCmdMsgに直接送信されます。

メッセージリフレクションの詳細については、「リフレクションメッセージの処理」を参照してください。

`CWnd::ReflectLastMsg`

このメンバー関数は、子ウィンドウに最後のメッセージを反映するためにフレームワークによって呼び出されます。

static BOOL PASCAL ReflectLastMsg(
    HWND hWndChild,
    LRESULT* pResult = NULL);

パラメーター

hWndChild
子ウィンドウへのハンドル。

pResult
親ウィンドウから返される子ウィンドウによって生成された結果。 NULL の可能性があります。

戻り値

メッセージが処理された場合は 0 以外。それ以外の場合は 0。

解説

このメンバー関数は、hWndChildによって識別されるウィンドウが OLE コントロールまたは永続的なマップ内のウィンドウである場合に、SendChildNotifyLastMsgを呼び出します。

メッセージリフレクションの詳細については、「リフレクションメッセージの処理」を参照してください。

`CWnd::ReleaseDC`

デバイスコンテキストを解放し、他のアプリケーションで使用するために解放します。

int ReleaseDC(CDC* pDC);

パラメーター

pDC
解放するデバイスコンテキストを識別します。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

ReleaseDCメンバー関数の効果は、デバイスコンテキストの種類によって異なります。

アプリケーションは、GetWindowDC メンバー関数の呼び出しごとに、および GetDC メンバー関数の呼び出しごとに、ReleaseDC メンバー関数を呼び出す必要があります。

`CWnd::RepositionBars`

ウィンドウのクライアント領域のコントロールバーの位置を変更およびサイズ変更するために呼び出されます。

void RepositionBars(UINT nIDFirst,
    UINT nIDLast,
    UINT nIDLeftOver,
    UINT nFlag = reposDefault,
    LPRECT lpRectParam = NULL,
    LPCRECT lpRectClient = NULL,
    BOOL bStretch = TRUE) ;

パラメーター

nIDFirst
位置とサイズを変更するコントロールバーの範囲の最初の ID。

nIDLast
位置とサイズを変更するコントロールバーの範囲の最後の ID。

nIDLeftOver
クライアント領域の残りの部分を塗りつぶすペインの ID を指定します。

nFlag
次のいずれかの値になります。

CWnd::reposDefault コントロールバーのレイアウトを実行します。 lpRectParam は使用されず、 NULLできます。
CWnd::reposQuery コントロールバーのレイアウトは行われません。代わりに lpRectParam レイアウトが実際に行われたかのように、クライアント領域のサイズで初期化されます。
CWnd::reposExtralpRectParamの値をnIDLastのクライアント領域に追加し、レイアウトも実行します。

lpRectParam
RECT構造体を指します; の使用法は、nFlagの値によって異なります。

lpRectClient
使用可能なクライアント領域を含む RECT 構造体を指します。 NULL場合は、ウィンドウのクライアント領域が使用されます。

bStretch
バーをフレームのサイズまで引き伸ばす必要があるかどうかを示します。

解説

nIDFirstパラメーターと nIDLast パラメーターは、クライアント領域で再配置するコントロールバー ID の範囲を定義します。 nIDLeftOver パラメーターは、子ウィンドウ (通常はビュー) の ID を指定します。この ID は、コントロールバーで埋め込まれていないクライアント領域の残りの部分を埋めるように再配置およびサイズ変更されます。

`CWnd::RunModalLoop`

ContinueModalがFALSEを返すまで、このメンバー関数を呼び出してメッセージを取得、翻訳、またはディスパッチします。

int RunModalLoop(DWORD dwFlags = 0);

パラメーター

dwFlags
送信する Windows メッセージを指定します。値は、次のいずれかです。

MLF_NOIDLEMSG 親に WM_ENTERIDLE メッセージを送信しないでください。
MLF_NOKICKIDLEWM_KICKIDLEメッセージをウィンドウに送信しないでください。
MLF_SHOWONIDLE メッセージキューがアイドル状態になったときにウィンドウを表示します。

戻り値

EndModalLoop メンバー関数に渡されるnResult パラメーターの値を指定します。この値は、モーダルループの終了に使用されます。

解説

既定では、ContinueModalはEndModalLoopが呼び出された後にFALSEを返します。 EndModalLoopにnResultとして指定された値を返します。

`CWnd::ScreenToClient`

ディスプレイ上の指定された点または四角形の画面座標をクライアント座標に変換します。

void ScreenToClient(LPPOINT lpPoint) const;  void ScreenToClient(LPRECT lpRect) const;

パラメーター

lpPoint
変換する画面座標を含む CPointオブジェクトまたはPOINT構造体を指します。

lpRect
変換する画面座標を含む CRectオブジェクトまたはRECT構造体を指します。

解説

ScreenToClientメンバー関数は、lpPointまたはlpRectで指定された画面座標をクライアント座標に置き換えます。新しい座標は、 CWnd クライアント領域の左上隅を基準にしています。

例

CListCtrl::GetItemRect の例を参照してください。

`CWnd::ScrollWindow`

現在の CWnd オブジェクトのクライアント領域の内容をスクロールします。

void ScrollWindow(
    int xAmount,
    int yAmount,
    LPCRECT lpRect = NULL,
    LPCRECT lpClipRect = NULL);

パラメーター

xAmount
水平スクロールの量をデバイス単位で指定します。左にスクロールするには、このパラメーターに負の値を指定する必要があります。

yAmount
垂直方向のスクロールの量をデバイス単位で指定します。上にスクロールするには、このパラメーターに負の値を指定する必要があります。

lpRect
スクロールするクライアント領域の部分を指定する CRect オブジェクトまたはRECT構造体を指します。 lpRectがNULL場合、クライアント領域全体がスクロールされます。カーソルの四角形がスクロール四角形と交差する場合、キャレットの位置が変更されます。

lpClipRect
スクロールするクリッピング四角形を指定する CRect オブジェクトまたは RECT 構造体を指します。この四角形内のビットのみがスクロールされます。この四角形の外側のビットは、 lpRect の四角形内にある場合でも影響を受けません。 lpClipRectがNULL場合、スクロール四角形に対してクリッピングは実行されません。

解説

キャレットがスクロール中の CWnd にある場合、 ScrollWindow は自動的にキャレットを非表示にして消去されないようにし、スクロールが完了した後にキャレットを復元します。キャレットの位置はそれに応じて調整されます。

ScrollWindowメンバー関数によって発見された領域は再描画されませんが、現在のCWnd オブジェクトの更新領域に結合されます。アプリケーションは最終的に、リージョンの再描画が必要であることを通知する WM_PAINT メッセージを受け取ります。スクロールが行われると同時に、発見された領域を再描画するには、ScrollWindowを呼び出した直後にUpdateWindowメンバー関数を呼び出します。

lpRectがNULLされている場合、ウィンドウ内の子ウィンドウの位置は、xAmountとyAmountで指定された量でオフセットされ、CWnd内の無効な (未描画の) 領域もオフセットされます。 ScrollWindow は、 lpRect が NULLされると高速になります。

lpRectがNULLされていない場合、子ウィンドウの位置は変更されず、CWndの無効な領域はオフセットされません。 lpRectがNULLされていないときに問題が更新されないようにするには、UpdateWindow メンバー関数を呼び出して、ScrollWindowを呼び出す前にCWndを再描画します。

`CWnd::ScrollWindowEx`

ウィンドウのクライアント領域の内容をスクロールします。

int ScrollWindowEx(
    int dx,
    int dy,
    LPCRECT lpRectScroll,
    LPCRECT lpRectClip,
    CRgn* prgnUpdate,
    LPRECT lpRectUpdate,
    UINT flags);

パラメーター

dx
水平スクロールの量をデバイス単位で指定します。左にスクロールするには、このパラメーターに負の値を指定する必要があります。

dy
垂直方向のスクロールの量をデバイス単位で指定します。上にスクロールするには、このパラメーターに負の値が必要です。

lpRectScroll
スクロールするクライアント領域の部分を指定するRECT構造体を指します。このパラメーターが NULL場合は、クライアント領域全体がスクロールされます。

lpRectClip
スクロールするクリッピング四角形を指定する RECT 構造体を指します。この構造体は、 lpRectScrollが指す四角形よりも優先されます。この四角形内のビットのみがスクロールされます。この四角形の外側のビットは、 lpRectScroll の四角形内にある場合でも影響を受けません。このパラメーターが NULL場合、スクロール四角形に対してクリッピングは実行されません。

prgnUpdate
スクロールによって無効にされた領域を保持するように変更された領域を識別します。このパラメーターは NULL の場合もあります。

lpRectUpdate
スクロールによって無効化された四角形の境界を受け取る RECT 構造体を指します。このパラメーターは NULL の場合もあります。

flags
次のいずれかの値になります。

SW_ERASESW_INVALIDATEで指定した場合は、ウィンドウにWM_ERASEBKGNDメッセージを送信して、新しく無効になったリージョンを消去します。
SW_INVALIDATE スクロール後に prgnUpdate によって識別された領域を無効にします。
SW_SCROLLCHILDRENdxおよびdyで指定されたピクセル数だけlpRectScrollが指す四角形と交差するすべての子ウィンドウをスクロールします。 Windows は、移動しない場合でも、lpRectScrollと交差するすべての子ウィンドウにWM_MOVE メッセージを送信します。子ウィンドウがスクロールされ、カーソルの四角形がスクロール四角形と交差すると、キャレットの位置が変更されます。

戻り値

戻り値は、関数が成功した場合は SIMPLEREGION (無効な領域)、 COMPLEXREGION (非四角形の無効化領域、重複する四角形)、または NULLREGION (無効な領域なし) です。それ以外の場合、戻り値は ERROR。

解説

この関数は ScrollWindow 関数に似ていますが、いくつかの追加機能があります。

SW_INVALIDATEとSW_ERASEが指定されていない場合、ScrollWindowEx メンバー関数は、スクロール先の領域を無効にしません。これらのフラグのいずれかが設定されている場合、 ScrollWindowEx はこの領域を無効にします。この領域は、アプリケーションが UpdateWindow メンバー関数を呼び出すか、 RedrawWindow メンバー関数を呼び出すか ( RDW_UPDATENOW または RDW_ERASENOWを指定して)、アプリケーションキューから WM_PAINT メッセージを取得するまで更新されません。

ウィンドウに WS_CLIPCHILDREN スタイルが設定されている場合、 prgnUpdate および lpRectUpdate で指定された返される領域は、更新が必要な子ウィンドウ内の領域を含め、更新する必要があるスクロールウィンドウの合計領域を表します。

SW_SCROLLCHILDREN フラグが指定されている場合、子ウィンドウの一部がスクロールされた場合、Windows は画面を適切に更新しません。元の四角形の外側にあるスクロールされた子ウィンドウの部分は消去されず、新しいコピー先で正しく描画されません。 DeferWindowPos Windows 関数を使用して、lpRectScroll四角形内に完全に存在しない子ウィンドウを移動します。 SW_SCROLLCHILDREN フラグが設定され、キャレット四角形がスクロール四角形と交差する場合、カーソルの位置が変更されます。

すべての入力座標と出力座標 ( lpRectScroll、 lpRectClip、 lpRectUpdate、および prgnUpdate) は、ウィンドウに CS_OWNDC または CS_CLASSDC クラススタイルがあるかどうかに関係なく、クライアント座標内にあると見なされます。必要に応じて、 LPtoDP 関数と DPtoLP Windows 関数を使用して、論理座標との間で変換します。

`CWnd::SendChildNotifyLastMsg`

このメンバー関数は、子ウィンドウがタスクを処理できるように、親ウィンドウから子ウィンドウに通知メッセージを提供するためにフレームワークによって呼び出されます。

BOOL SendChildNotifyLastMsg(LRESULT* pResult = NULL);

パラメーター

pResult
親ウィンドウから返される子ウィンドウによって生成された結果。

戻り値

子ウィンドウが親に送信されたメッセージを処理した場合は 0 以外。それ以外の場合は 0。

解説

SendChildNotifyLastMsg 現在のメッセージが反映されている場合は、ソースに現在のメッセージを送信します。

メッセージリフレクションの詳細については、「リフレクションメッセージの処理」を参照してください。

`CWnd::SendDlgItemMessage`

コントロールにメッセージを送信します。

LRESULT SendDlgItemMessage(
    int nID,
    UINT message,
    WPARAM wParam = 0,
    LPARAM lParam = 0);

パラメーター

nID
メッセージを受信するダイアログコントロールの識別子を指定します。

message
送信するメッセージを指定します。

wParam
メッセージに依存する追加の情報を指定します。

lParam
メッセージに依存する追加の情報を指定します。

戻り値

コントロールのウィンドウプロシージャによって返される値を指定します。コントロールが見つからなかった場合は 0 を指定します。

解説

SendDlgItemMessage メンバー関数は、メッセージが処理されるまで戻りません。

SendDlgItemMessageの使用は、指定されたコントロールへのCWnd* の取得と、SendMessage メンバー関数の呼び出しと同じです。

例

void CMyDlg::SetSpinRange()
{
   //set the min and max range of the up/down or spin control
   SendDlgItemMessage(IDC_SPIN1, UDM_SETRANGE, 0, (LPARAM)MAKELONG(8, 1));
}

`CWnd::SendMessage`

指定したメッセージをこのウィンドウに送信します。

LRESULT SendMessage(
    UINT message,
    WPARAM wParam = 0,
    LPARAM lParam = 0);

パラメーター

message
送信するメッセージを指定します。

wParam
メッセージに依存する追加の情報を指定します。

lParam
メッセージに依存する追加の情報を指定します。

戻り値

メッセージ処理の結果。その値は、送信されたメッセージによって異なります。

解説

SendMessage メンバー関数は、ウィンドウプロシージャを直接呼び出し、そのウィンドウプロシージャがメッセージを処理するまで戻りません。これは、ウィンドウのメッセージキューにメッセージを配置し、すぐに返す PostMessage メンバー関数とは対照的です。

例

void CAboutDlg::OnPaint()
{
   // This code, normally emitted by the Application Wizard for a dialog-
   // based project for the dialog's WM_PAINT handler, runs only if the
   // window is iconic. The window erases the icon's area, then
   // paints the icon referenced by m_hIcon.
   if (IsIconic())
   {
      CPaintDC dc(this); // device context for painting

      SendMessage(WM_ICONERASEBKGND, (WPARAM)dc.GetSafeHdc(), 0);

      // Center icon in client rectangle
      int cxIcon = GetSystemMetrics(SM_CXICON);
      int cyIcon = GetSystemMetrics(SM_CYICON);
      CRect rect;
      GetClientRect(&rect);
      int x = (rect.Width() - cxIcon + 1) / 2;
      int y = (rect.Height() - cyIcon + 1) / 2;

      // Draw the icon
      dc.DrawIcon(x, y, m_hIcon);
   }
   else
   {
      CDialog::OnPaint();
   }
}

`CWnd::SendMessageToDescendants`

指定した Windows メッセージをすべての子孫ウィンドウに送信するには、このメンバー関数を呼び出します。

void SendMessageToDescendants(
    UINT message,
    WPARAM wParam = 0,
    LPARAM lParam = 0,
    BOOL bDeep = TRUE,
    BOOL bOnlyPerm = FALSE);

パラメーター

message
送信するメッセージを指定します。

wParam
メッセージに依存する追加の情報を指定します。

lParam
メッセージに依存する追加の情報を指定します。

bDeep
検索するレベルを指定します。 TRUE場合は、すべての子を再帰的に検索します。FALSE場合は、直下の子のみを検索します。

bOnlyPerm
メッセージを一時ウィンドウで受信するかどうかを指定します。 TRUE場合、一時ウィンドウはメッセージを受信できます。FALSE場合は、永続的なウィンドウのみがメッセージを受信します。一時ウィンドウの詳細については、「テクニカルノート 3を参照してください。

解説

bDeepがFALSEされている場合、メッセージはウィンドウの直下の子だけに送信されます。それ以外の場合は、メッセージはすべての子孫ウィンドウに送信されます。

bDeepとbOnlyPermがTRUEされている場合、検索は一時的なウィンドウの下で続行されます。この場合、検索中に永続的なウィンドウのみがメッセージを受信します。 bDeepがFALSE場合、メッセージはウィンドウの直下の子にのみ送信されます。

例

// The following code fragment is from CMyDlg::OnInitDialog
// CMyDlg is derived from CDialog.

// change font of child controls of a dialog
LOGFONT lf = {0};
// redraw of child controls not needed in OnInitDialog
// since controls aren't drawn yet.
short int fRedraw = FALSE;

lf.lfHeight = 15; // Request a 15-pixel-high font

// with face name "Arial".
wcscpy_s(lf.lfFaceName, LF_FACESIZE, _T("Arial"));

m_font.CreateFontIndirect(&lf); // Create the font.

SendMessageToDescendants(WM_SETFONT,
                         (WPARAM)m_font.m_hObject, //handle to font
                         MAKELONG((WORD)fRedraw, 0),
                         FALSE); // send to all descendants(TRUE) or
                                 // just children of *this (FALSE)

`CWnd::SendNotifyMessage`

指定したメッセージをウィンドウに送信します。

BOOL SendNotifyMessage(
    UINT message,
    WPARAM wParam,
    LPARAM lParam);

パラメーター

message
送信するメッセージを指定します。

wParam
メッセージに依存する追加の情報を指定します。

lParam
メッセージに依存する追加の情報を指定します。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

呼び出し元のスレッドによってウィンドウが作成された場合、 SendNotifyMessage はウィンドウのウィンドウプロシージャを呼び出し、ウィンドウプロシージャがメッセージを処理するまで戻りません。ウィンドウが別のスレッドによって作成された場合、 SendNotifyMessage はメッセージをウィンドウプロシージャに渡し、すぐに戻ります。ウィンドウプロシージャがメッセージの処理を完了するまで待機しません。

`CWnd::SetActiveWindow`

アクティブウィンドウ CWnd します。

CWnd* SetActiveWindow();

戻り値

以前にアクティブだったウィンドウ。

返されるポインターは一時的な場合があり、後で使用するために格納しないでください。

解説

SetActiveWindowメンバー関数は、アプリケーションがアクティブウィンドウと入力フォーカスを任意に引き継ぐので、注意して使用する必要があります。通常、Windows ではすべてのライセンス認証が行われます。

`CWnd::SetCapture`

カーソルの位置に関係なく、後続のすべてのマウス入力を現在の CWnd オブジェクトに送信します。

CWnd* SetCapture();

戻り値

以前にすべてのマウス入力を受け取ったウィンドウオブジェクトへのポインター。このようなウィンドウがない場合は NULL 。返されるポインターは一時的な場合があり、後で使用するために格納しないでください。

解説

CWndすべてのマウス入力が不要になった場合、アプリケーションは、他のウィンドウがマウス入力を受け取ることができるように、ReleaseCapture関数を呼び出す必要があります。

マウス入力がキャプチャされている間、 WM_NCHITTEST または WM_SETCURSOR メッセージはアクティブウィンドウに送信されません。

`CWnd::SetCaretPos`

キャレットの位置を設定します。

static void PASCAL SetCaretPos(POINT point);

パラメーター

point
キャレットの新しい x 座標と y 座標をクライアント座標で指定します。

解説

SetCaretPosメンバー関数は、キャレットが現在のタスクのウィンドウによって所有されている場合にのみ移動します。 SetCaretPos は、キャレットが非表示かどうかに関係なく、キャレットを移動します。

キャレットは共有リソースです。キャレットを所有していない場合、ウィンドウはキャレットを移動しないでください。

例

// The following code snippet shows a caret when the left
// mouse button is pressed, and sets the caret's position to
// the cursor's position.
void CMyView::OnLButtonDown(UINT nFlags, CPoint point)
{
   //create a solid caret, the width is 2, the length is 20.
   CreateSolidCaret(2, 20);

   SetCaretPos(point);
   ShowCaret();

   CView::OnLButtonDown(nFlags, point);
}

`CWnd::SetClipboardViewer`

このウィンドウを、クリップボードの内容が変更されるたびに ( WM_DRAWCLIPBOARD メッセージによって) 通知されるウィンドウのチェーンに追加します。

HWND SetClipboardViewer();

戻り値

成功した場合は、クリップボードビューアーチェーン内の次のウィンドウへのハンドル。アプリケーションでは、このハンドルを保存し (メンバー変数として格納できます)、クリップボードビューアーのチェーンメッセージに応答するときに使用する必要があります。

解説

クリップボードビューアーチェーンの一部であるウィンドウは、メッセージの WM_DRAWCLIPBOARD、 WM_CHANGECBCHAIN、および WM_DESTROY に応答し、メッセージをチェーン内の次のウィンドウに渡す必要があります。

このメンバー関数は、 WM_DRAWCLIPBOARD メッセージをウィンドウに送信します。クリップボードビューアーチェーン内の次のウィンドウへのハンドルがまだ返されていないため、アプリケーションは、SetClipboardViewerの呼び出し中に受信したWM_DRAWCLIPBOARD メッセージを渡すべきではありません。

クリップボードビューアーチェーンから自身を削除するには、アプリケーションで ChangeClipboardChain メンバー関数を呼び出す必要があります。

`CWnd::SetDlgCtrlID`

ウィンドウのウィンドウ ID またはコントロール ID を新しい値に設定します。

int SetDlgCtrlID(int nID);

パラメーター

nID
コントロールの識別子に設定する新しい値。

戻り値

成功した場合は、ウィンドウの前の識別子。それ以外の場合は 0。

解説

このウィンドウには、ダイアログボックス内のコントロールだけでなく、任意の子ウィンドウを指定できます。ウィンドウを最上位のウィンドウにすることはできません。

`CWnd::SetDlgItemInt`

ダイアログボックス内の特定のコントロールのテキストを、指定した整数値の文字列形式に設定します。

void SetDlgItemInt(
    int nID,
    UINT nValue,
    BOOL bSigned = TRUE);

パラメーター

nID
変更するコントロールの整数 ID を指定します。

nValue
項目テキストの生成に使用する整数値を指定します。

bSigned
整数値が符号付きか符号なしかを指定します。このパラメーターが TRUEの場合、 nValue は署名されます。このパラメーターが TRUE で、 nValue が 0 未満の場合は、文字列の最初の桁の前に負符号が配置されます。このパラメーターが FALSEの場合、 nValue は符号なしになります。

解説

SetDlgItemInt は、 WM_SETTEXT メッセージを特定のコントロールに送信します。

例

CWnd::SetDlgItemText の例を参照してください。

`CWnd::SetDlgItemText`

ウィンドウまたはダイアログボックスが所有するコントロールのキャプションまたはテキストを設定します。

void SetDlgItemText(
    int nID,
    LPCTSTR lpszString);

パラメーター

nID
テキストを設定するコントロールを識別します。

lpszString
コントロールにコピーするテキストを含む、 CString オブジェクトまたは null で終わる文字列を指します。

解説

SetDlgItemText は、 WM_SETTEXT メッセージを特定のコントロールに送信します。

例

// The following code fragment is from CMyDlg::OnInitDialog
// CMyDlg is derived from CDialog.

// Initialize dialog controls
SetDlgItemText(IDC_EDITNAME, _T("Type in text"));
SetDlgItemInt(IDC_EDITNUM, 100);

`CWnd::SetForegroundWindow`

ウィンドウを作成したスレッドをフォアグラウンドに置き、そのウィンドウをアクティブにします。

BOOL SetForegroundWindow();

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

キーボード入力がそのウィンドウに送られ、さまざまな視覚的な合図がユーザー向けに変更されます。フォアグラウンドウィンドウは、ユーザーが現在作業しているウィンドウです。フォアグラウンドウィンドウは、最上位のウィンドウ (フレームウィンドウまたはダイアログボックス) にのみ適用されます。

例

CWnd::FindWindow の例を参照してください。

`CWnd::SetFocus`

入力フォーカスを要求します。

CWnd* SetFocus();

戻り値

以前に入力フォーカスを持っていたウィンドウオブジェクトへのポインター。このようなウィンドウがない場合は NULL 。返されるポインターは一時的な場合があり、格納しないでください。

解説

入力フォーカスは、後続のすべてのキーボード入力をこのウィンドウに向けます。以前に入力フォーカスが設定されていたウィンドウでは、そのウィンドウは失われます。

SetFocusメンバー関数は、入力フォーカスを失うウィンドウにWM_KILLFOCUS メッセージを送信し、入力フォーカスを受け取るウィンドウにWM_SETFOCUS メッセージを送信します。また、ウィンドウまたはその親がアクティブになります。

現在のウィンドウがアクティブであってもフォーカスがない場合 (つまり、ウィンドウにフォーカスがない場合)、押されたキーを押すと、メッセージ WM_SYSCHAR、 WM_SYSKEYDOWN、または WM_SYSKEYUPが生成されます。

`CWnd::SetFont`

WM_SETFONT メッセージをウィンドウに送信して、指定したフォントを使用します。

void SetFont(
    CFont* pFont,
    BOOL bRedraw = TRUE);

パラメーター

pFont
CFont オブジェクトを指すポインター。

bRedraw
TRUE ウィンドウが WM_SETFONT メッセージを処理した直後にウィンドウを再描画する場合は、それ以外の場合は FALSE。

解説

ウィンドウが WM_SETFONT メッセージを処理しない限り、このメソッドは効果がありません。 CWndから派生した多くの MFC クラスは、WM_SETFONT メッセージのメッセージハンドラーを含む定義済みのウィンドウクラスにアタッチされているため、このメッセージを処理します。このメソッドを使用するには、 CWnd から派生したクラスで、 WM_SETFONT メッセージのメソッドハンドラーを定義する必要があります。

`CWnd::SetIcon`

このメンバー関数を呼び出して、ハンドルを特定のアイコンに設定します( hIconで識別されます)。

HICON SetIcon(
    HICON hIcon,
    BOOL bBigIcon);

パラメーター

hIcon
前のアイコンへのハンドル。

bBigIcon
TRUE場合は 32 ピクセル x 32 ピクセルのアイコンを指定し、FALSE場合は 16 ピクセル x 16 ピクセルのアイコンを指定します。

戻り値

アイコンにへのハンドル。

解説

ウィンドウクラスが登録されると、アイコンが選択されます。

例

CWnd::GetSystemMenu の例を参照してください。

`CWnd::SetLayeredWindowAttributes`

レイヤードウィンドウの不透明度および透明度のカラーキーを設定します。

BOOL SetLayeredWindowAttributes(
    COLORREF crKey,
    BYTE bAlpha,
    DWORD dwFlags);

パラメーター

crKey
レイヤーウィンドウの作成時に使用する透明度カラーキーを指定する COLORREF 値へのポインター。ウィンドウによってこの色で塗りつぶされたすべてのピクセルは透明になります。 COLORREFを生成するには、RGB マクロを使用します。

bAlpha
レイヤーウィンドウの不透明度を表すために使用されるアルファ値。詳細については、BLENDFUNCTION構造体のSourceConstantAlpha メンバーを参照してください。 bAlphaが 0 の場合、ウィンドウは完全に透明になります。 bAlphaが 255 の場合、ウィンドウは不透明になります。

dwFlags
実行するアクションを指定します。このパラメーターには、次の値のいずれかを指定できます。使用可能な値の一覧については、 SetLayeredWindowAttributesを参照してください。

戻り値

関数が正常終了した場合は 0 以外。それ以外の場合は 0。

解説

このメンバー関数は、Windows SDK で説明されているように、関数 SetLayeredWindowAttributesの機能をエミュレートします。

`CWnd::SetMenu`

現在のメニューを指定したメニューに設定します。

BOOL SetMenu(CMenu* pMenu);

パラメーター

pMenu
新しいメニューを識別します。このパラメーターが NULLされている場合、現在のメニューは削除されます。

戻り値

メニューが変更された場合は 0 以外。それ以外の場合は 0。

解説

メニューの変更を反映するようにウィンドウを再描画します。

SetMenu は前のメニューを破棄しません。このタスクを実行するには、アプリケーションで CMenu::DestroyMenu メンバー関数を呼び出す必要があります。

例

CMenu::LoadMenu の例を参照してください。

`CWnd::SetOwner`

現在のウィンドウの所有者を指定したウィンドウオブジェクトに設定します。

void SetOwner(CWnd* pOwnerWnd);

パラメーター

pOwnerWnd
ウィンドウオブジェクトの新しい所有者を識別します。このパラメーターが NULLの場合、ウィンドウオブジェクトには所有者がありません。

解説

この所有者は、現在のウィンドウオブジェクトからコマンドメッセージを受信できます。既定では、現在のウィンドウの親は所有者です。

多くの場合、ウィンドウ階層に関係のないウィンドウオブジェクト間の接続を確立すると便利です。たとえば、 CToolBar は、親ではなく所有者に通知を送信します。これにより、ツールバーは、別のウィンドウ (インプレースフレームウィンドウなど) に通知を送信しながら、1 つのウィンドウ (OLE コンテナーアプリケーションウィンドウなど) の子になります。さらに、インプレース編集中にサーバーウィンドウが非アクティブ化またはアクティブ化されると、フレームウィンドウが所有するウィンドウは非表示または表示されます。この所有権は、 SetOwnerの呼び出しで明示的に設定されます。

この関数の所有権の概念は、 GetWindowの所有権の概念とは異なります。

`CWnd::SetParent`

子ウィンドウの親ウィンドウを変更します。

CWnd* SetParent(CWnd* pWndNewParent);

パラメーター

pWndNewParent
新しい親ウィンドウを識別します。

戻り値

成功した場合は、前の親ウィンドウオブジェクトへのポインター。返されるポインターは一時的な場合があり、後で使用するために格納しないでください。

解説

子ウィンドウが表示されている場合、Windows は適切な再描画と再描画を実行します。

`CWnd::SetProperty`

このメンバー関数を呼び出して、 dwDispIDで指定された OLE コントロールプロパティを設定します。

void AFX_CDECL SetProperty(
    DISPID dwDispID,
    VARTYPE vtProp, ...);

パラメーター

dwDispID
設定するプロパティを識別します。

vtProp
設定するプロパティの型を指定します。使用可能な値については、 COleDispatchDriver::InvokeHelperの「解説」セクションを参照してください。

...
vtPropによって指定された型の 1 つのパラメーターです。

解説

Note

この関数は、OLE コントロールを表す CWnd オブジェクトでのみ呼び出す必要があります。

OLE コントロールコンテナーでこのメンバー関数を使用する方法の詳細については、「 ActiveX コントロールコンテナー: ActiveX コントロールコンテナーでの ActiveX コントロールのプログラミング」を参照してください。

`CWnd::SetRedraw`

アプリケーションは SetRedraw を呼び出して、変更を再描画したり、変更が再描画されないようにしたりします。

void SetRedraw(BOOL bRedraw = TRUE);

パラメーター

bRedraw
再描画フラグの状態を指定します。このパラメーターが TRUEの場合、再描画フラグが設定されます。 FALSE場合、フラグはクリアされます。

解説

このメンバー関数は、再描画フラグを設定またはクリアします。再描画フラグがクリアされている間、内容は変更のたびに更新されず、再描画フラグが設定されるまで再描画されません。たとえば、リストボックスに複数の項目を追加する必要があるアプリケーションでは、再描画フラグをクリアし、項目を追加してから、再描画フラグを設定できます。最後に、アプリケーションは Invalidate または InvalidateRect メンバー関数を呼び出して、リストボックスを再描画できます。

例

// Updating a control or window with large amounts of data may cause
// flicker. In such cases it may be better to turn off drawing

//m_list is a member of type CListCtrl
m_List.SetRedraw(FALSE); // turn drawing off regardless of list mode

//
// Update control
//

m_List.SetRedraw(TRUE); // turn drawing back on and update the window

// invalidate the entire control, force painting
m_List.Invalidate();
m_List.UpdateWindow();

`CWnd::SetScrollInfo`

このメンバー関数を呼び出して、 SCROLLINFO 構造体がスクロールバーについて保持する情報を設定します。

BOOL SetScrollInfo(
    int nBar,
    LPSCROLLINFO lpScrollInfo,
    BOOL bRedraw = TRUE);

パラメーター

nBar
スクロールバーがコントロールであるか、ウィンドウの非クライアント領域の一部であるかを指定します。非クライアント領域の一部である場合、nBar は、スクロールバーが水平方向、垂直方向、またはその両方に配置されているかどうかを示します。次のいずれかである必要があります。

SB_CTL スクロールバーコントロールのパラメーターを格納します。 m_hWnd データメンバーは、スクロールバーコントロールのハンドルである必要があります。
SB_HORZ ウィンドウが水平スクロールバーであることを指定します。
SB_VERT ウィンドウが垂直スクロールバーであることを指定します。

lpScrollInfo
SCROLLINFO 構造体へのポインター。この構造の詳細については、Windows SDK を参照してください。

bRedraw
新しい位置を反映するようにスクロールバーを再描画するかどうかを指定します。 bRedrawがTRUEされている場合は、スクロールバーが再描画されます。 FALSEされている場合は、再描画されません。既定では、スクロールバーが再描画されます。

戻り値

成功した場合、戻り値は TRUE。それ以外の場合は、FALSE となります。

解説

スクロールバーの位置、 CWnd::OnHScroll 、および CWnd::OnVScrollを示す MFC Windows メッセージハンドラーは、位置データの 16 ビットのみを提供します。 GetScrollInfo と SetScrollInfo は、32 ビットのスクロールバー位置データを提供します。したがって、アプリケーションは、CWnd::OnHScrollまたはCWnd::OnVScrollの処理中にGetScrollInfoを呼び出して、32 ビットのスクロールバー位置データを取得できます。

Note

CWnd::GetScrollInfo を使用すると、アプリケーションは 32 ビットのスクロールバー位置を使用できます。

`CWnd::SetScrollPos`

スクロールボックスの現在位置を設定し、必要に応じて、スクロールボックスの新しい位置を反映するようにスクロールバーを再描画します。

int SetScrollPos(
    int nBar,
    int nPos,
    BOOL bRedraw = TRUE);

パラメーター

nBar
設定するスクロールバーを指定します。このパラメーターには、次のいずれかを指定できます。

SB_HORZ ウィンドウの水平スクロールバーのスクロールボックスの位置を設定します。
SB_VERT ウィンドウの垂直スクロールバーのスクロールボックスの位置を設定します。

nPos
スクロールボックスの新しい位置を指定します。スクロール範囲内である必要があります。

bRedraw
新しいスクロールボックスの位置を反映するようにスクロールバーを再描画するかどうかを指定します。このパラメーターが TRUE場合、スクロールバーは再描画されます。 FALSE場合、スクロールバーは再描画されません。

戻り値

スクロールボックスの前の位置。

解説

bRedrawをFALSEに設定すると、スクロールバーが別の関数の後続の呼び出しによって再描画されるたびに役立ちます。

`CWnd::SetScrollRange`

指定されたスクロールバーの最小位置と最大位置の値を設定します。

void SetScrollRange(
    int nBar,
    int nMinPos,
    int nMaxPos,
    BOOL bRedraw = TRUE);

パラメーター

nBar
設定するスクロールバーを指定します。このパラメーターには、次のいずれかの値を指定できます。

SB_HORZ ウィンドウの水平スクロールバーの範囲を設定します。
SB_VERT ウィンドウの垂直スクロールバーの範囲を設定します。

nMinPos
最小スクロール位置を指定します。

nMaxPos
最大スクロール位置を指定します。

bRedraw
変更を反映するためにスクロールバーを再描画するかどうかを指定します。 bRedrawがTRUE場合、スクロールバーは再描画されます。FALSE場合、スクロールバーは再描画されません。

解説

また、標準のスクロールバーを非表示または表示するためにも使用できます。

アプリケーションでは、スクロールバー通知メッセージの処理中にスクロールバーを非表示にするために、この関数を呼び出さないでください。

SetScrollPos メンバー関数の呼び出しの直後にSetScrollRangeを呼び出す場合、スクロールバーが 2 回描画されないように、SetScrollPos メンバー関数のbRedraw パラメーターは 0 にする必要があります。

標準スクロールバーの既定の範囲は 0 ~ 100 です。スクロールバーコントロールの既定の範囲は空です ( nMinPos と nMaxPos の両方の値は 0 です)。 nMinPosとnMaxPosで指定された値の差は、INT_MAXより大きくすることはできません。

`CWnd::SetTimer`

システムタイマーをインストールします。

UINT_PTR SetTimer(
    UINT_PTR nIDEvent,
    UINT nElapse,
    void (CALLBACK* lpfnTimer)(HWND,
    UINT,
    UINT_PTR,
    DWORD));

パラメーター

nIDEvent
0 以外のタイマーの識別子を指定します。タイマーの識別子が一意の場合、この同じ値が SetTimer によって返されます。一意でない場合、SetTimer は、新しい一意の値を指定して返します。ウィンドウタイマー ( NULL コールバック関数を持つ) の場合、値は現在のウィンドウに関連付けられている他のウィンドウタイマーに対してのみ一意である必要があります。コールバックのタイマーの場合、値はすべてのプロセスのすべてのタイマーで一意である必要があります。したがって、コールバックタイマーを作成すると、戻り値が指定した値と異なる可能性が高くなります。

nElapse
タイムアウト値 (間隔) をミリ秒単位で指定します。

lpfnTimer
WM_TIMER メッセージを処理するアプリケーション提供のTimerProcコールバック関数のアドレスを指定します。このパラメーターが NULLの場合、 WM_TIMER メッセージはアプリケーションのメッセージキューに配置され、 CWnd オブジェクトによって処理されます。

戻り値

関数が正常に完了した場合の、新しいタイマーのタイマー識別子。この値は、 nIDEvent パラメーターを介して渡される値と等しい場合と等しくない場合があります。アプリケーションは、タイマーを強制終了するために、常に戻り値を KillTimer メンバー関数に渡す必要があります。正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

間隔値が指定され、間隔が経過するたびに、システムは、インストールしているアプリケーションのインストール中のメッセージキューに WM_TIMER メッセージをポストするか、アプリケーション定義の TimerProc コールバック関数にメッセージを渡します。

lpfnTimerコールバック関数はTimerProcという名前を付ける必要はありませんが、静的として宣言し、次のように定義する必要があります。

void CALLBACK TimerProc(
    HWND hWnd,   // handle of CWnd that called SetTimer
    UINT nMsg,   // WM_TIMER
    UINT_PTR nIDEvent,   // timer identification
    DWORD dwTime    // system time);

例

この例では、 CWnd::SetTimer、 CWnd::OnTimer、および CWnd::KillTimer を使用して、 WM_TIMER メッセージを処理します。最初のタイマーは、OnStartTimerで 2 秒ごとにメインフレームウィンドウにWM_TIMER メッセージを送信するように設定されます。 OnTimer イベントハンドラーは、メインフレームウィンドウWM_TIMERメッセージを処理します。このメソッドにより、PC スピーカーは 2 秒ごとにビープ音を鳴らします。 2 番目のタイマーは、3.75 秒ごとにコールバック関数にメッセージを送信します。 OnStopTimer は、各タイマー ID の CWnd::KillTimer を呼び出して、両方のタイマーを停止します。

void CMainFrame::OnStartTimer()
{
   // This timer uses a WM_TIMER message, not a callback.
   // Therefore, the timer is specific to this window.
   // m_nWindowTimer is a UINT_PTR field.
   m_nWindowTimer = SetTimer(1, 2000, NULL);

   // For this demo, we specify an interval that won't overlap
   // with the window timer.
   m_nCallbackTimer = SetTimer(2, 3750, &CMainFrame::MyTimerProc);

   // See whether we got the ID we requested in the first parameter.
#ifdef _DEBUG
   CString str;
   str.Format(_T("m_ncallbackTImer ID = %d"), m_nCallbackTimer);
   TRACE(str);
#endif
}

void CALLBACK CMainFrame::MyTimerProc(
    HWND hWnd,         // handle of CWnd that called SetTimer
    UINT nMsg,         // WM_TIMER
    UINT_PTR nIDEvent, // timer identification
    DWORD dwTime       // system time
)
{
   MessageBeep(0x00000030L); // Windows question sound.
}

void CMainFrame::OnStopTimer()
{
   KillTimer(m_nWindowTimer);
   KillTimer(m_nCallbackTimer);
}

void CMainFrame::OnTimer(UINT nIDEvent)
{
   MessageBeep(0xFFFFFFFF); // Beep

   // Call base class handler.
   CMDIFrameWnd::OnTimer(nIDEvent);
}

`CWnd::SetWindowContextHelpId`

このメンバー関数を呼び出して、ヘルプコンテキスト識別子を指定されたウィンドウに関連付けます。

BOOL SetWindowContextHelpId(DWORD dwContextHelpId);

パラメーター

dwContextHelpId
ヘルプコンテキスト識別子。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

子ウィンドウにヘルプコンテキスト識別子がない場合は、その親ウィンドウの識別子を継承します。同様に、所有ウィンドウにヘルプコンテキスト識別子がない場合は、その所有者ウィンドウの識別子が継承されます。このヘルプコンテキスト識別子の継承により、アプリケーションはダイアログボックスとそのすべてのコントロールに対して 1 つの識別子のみを設定できます。

例

// The following code fragment is from CMyDlg::OnInitDialog
// CMyDlg is derived from CDialog.

// Associate a help context id with the control.
// IDC_TESTHELP_CONTROL is the id of the control
// and HIDC_TESTHELP_CONTROL is its help context
// id associated with the control.
CWnd *pWnd = GetDlgItem(IDC_TESTHELP_CONTROL);
pWnd->SetWindowContextHelpId(HIDC_TESTHELP_CONTROL);

`CWnd::SetWindowPlacement`

ウィンドウの表示状態、通常の位置 (復元された位置)、最小化された位置、および最大表示された位置を設定します。

BOOL SetWindowPlacement(const WINDOWPLACEMENT* lpwndpl);

パラメーター

lpwndpl
新しい表示状態と位置を指定する WINDOWPLACEMENT 構造体を指します。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

`CWnd::SetWindowPos`

子ウィンドウ、ポップアップウィンドウ、トップレベルウィンドウのサイズ、位置、Z オーダーを変更します。

BOOL SetWindowPos(
    const CWnd* pWndInsertAfter,
    int x,
    int y,
    int cx,
    int cy,
    UINT nFlags);

パラメーター

pWndInsertAfter
このCWndオブジェクトの前 (より大きい) CWndオブジェクトを Z オーダーで識別します。このパラメーターには、 CWnd へのポインターまたは次のいずれかの値へのポインターを指定できます。

wndBottom ウィンドウを Z オーダーの下部に配置します。この CWnd が一番上のウィンドウの場合、ウィンドウは最上位の状態を失います。システムは、他のすべてのウィンドウの下部にウィンドウを配置します。
wndTop ウィンドウを Z オーダーの一番上に配置します。
wndTopMost 最上位以外のすべてのウィンドウの上にウィンドウを配置します。非アクティブ化された場合でも、ウィンドウは最上位の位置を維持します。
wndNoTopMost ウィンドウを最上位以外のすべてのウィンドウの上部 (つまり、すべての最上位ウィンドウの背後) に再配置します。ウィンドウが既に最上位以外のウィンドウである場合、このフラグは無効です。

このパラメーターの使用方法に関する規則については、このトピックの「解説」セクションを参照してください。

x
ウィンドウの左側の新しい位置を指定します。

y
ウィンドウの上部の新しい位置を指定します。

cx
ウィンドウの新しい幅を指定します。

cy
ウィンドウの新しい高さを指定します。

nFlags
サイズ設定と配置のオプションを指定します。このパラメーターには、次のフラグを組み合わせて使用できます。

SWP_DRAWFRAME ウィンドウの周囲にフレーム (ウィンドウの作成時に定義) を描画します。
SWP_FRAMECHANGED ウィンドウのサイズが変更されていない場合でも、 WM_NCCALCSIZE メッセージをウィンドウに送信します。このフラグが指定されていない場合、 WM_NCCALCSIZE はウィンドウのサイズが変更されている場合にのみ送信されます。
SWP_HIDEWINDOW ウィンドウを非表示にします。
SWP_NOACTIVATE ウィンドウをアクティブにしません。このフラグが設定されていない場合、ウィンドウがアクティブになり、最上位または最上位以外のグループの一番上に移動されます ( pWndInsertAfter パラメーターの設定に応じて)。
SWP_NOCOPYBITS クライアント領域の内容全体を破棄します。このフラグが指定されていない場合、ウィンドウのサイズまたは位置を変更した後、クライアント領域の有効な内容が保存され、クライアント領域にコピーされます。
SWP_NOMOVE 現在の位置を保持します ( x パラメーターと y パラメーターは無視されます)。
SWP_NOOWNERZORDER Z オーダーでの所有者ウィンドウの位置を変更しません。
SWP_NOREDRAW 変更を再描画しません。このフラグが設定されている場合、どのような種類の再描画も行われません。これは、クライアント領域、非クライアント領域 (タイトルとスクロールバーを含む)、および移動されたウィンドウの結果として発見された親ウィンドウの任意の部分に適用されます。このフラグが設定されている場合、アプリケーションは、再描画する必要があるウィンドウと親ウィンドウの部分を明示的に無効化または再描画する必要があります。
SWP_NOREPOSITIONSWP_NOOWNERZORDER と同じです。
SWP_NOSENDCHANGING ウィンドウが WM_WINDOWPOSCHANGING メッセージを受信できないようにします。
SWP_NOSIZE 現在のサイズを保持します ( cx パラメーターと cy パラメーターは無視されます)。
SWP_NOZORDER 現在の順序を保持します ( pWndInsertAfterは無視されます)。
SWP_SHOWWINDOW ウィンドウを表示します。

戻り値

関数が成功した場合は 0 以外。それ以外の場合は 0。

解説

Windows は Z オーダーに従って画面上に並べ替えられます。Z オーダーの上部にあるウィンドウが、他のすべてのウィンドウの上に順番に表示されます。

子ウィンドウのすべての座標は、(親ウィンドウのクライアント領域の左上隅を基準とする) クライアント座標です。

ウィンドウは、 pWndInsertAfter パラメーターを &wndTopMost に設定し、 SWP_NOZORDER フラグが設定されていないことを確認するか、既存の最上位ウィンドウの上になるようにウィンドウの Z オーダーを設定することで、Z オーダーの先頭に移動できます。最上位以外のウィンドウが一番上に作成されると、その所有ウィンドウも最上位になります。その所有者は変更されません。

Z オーダーの一番下 (&wndBottom) に位置が変更された場合、または最上位以外のウィンドウの後に最上位のウィンドウが配置されなくなりました。一番上のウィンドウが一番上以外のウィンドウになると、そのすべての所有者とその所有ウィンドウも最上位以外のウィンドウになります。

SWP_NOACTIVATEもSWP_NOZORDERも指定されていない場合 (つまり、アプリケーションがウィンドウを同時にアクティブ化して指定した Z オーダーに配置することを要求した場合)、pWndInsertAfterで指定された値は次の状況でのみ使用されます。

pWndInsertAfter パラメーターでは、&wndTopMostも&wndNoTopMostも指定しません。
このウィンドウはアクティブウィンドウではありません。

アプリケーションは、非アクティブなウィンドウを Z オーダーの先頭に移動しないとアクティブにできません。アプリケーションは、アクティブ化されたウィンドウの Z オーダーを制限なしで変更できます。

最上位以外のウィンドウは一番上のウィンドウを所有できますが、その逆は所有できません。一番上のウィンドウが所有するウィンドウ (ダイアログボックスなど) は、そのウィンドウ自体が最上位のウィンドウに設定され、所有されているすべてのウィンドウが所有者の上に維持されます。

Windows バージョン 3.1 以降では、ウィンドウを Z オーダーの先頭に移動し、 WS_EX_TOPMOST スタイルを設定してロックできます。このような最上位ウィンドウは、非アクティブ化された場合でも最上位の位置を維持します。たとえば、WinHelp Always On Top コマンドを選択すると、ヘルプウィンドウが一番上に表示され、アプリケーションに戻ったときに表示されたままになります。

最上位のウィンドウを作成するには、&wndTopMostと等しいpWndInsertAfter パラメーターを使用してSetWindowPosを呼び出すか、ウィンドウの作成時にWS_EX_TOPMOSTスタイルを設定します。

Z オーダーに WS_EX_TOPMOST スタイルのウィンドウが含まれている場合、 &wndTopMost 値を使用して移動されたウィンドウは、最上位以外のすべてのウィンドウの一番上に配置され、一番上のウィンドウの下に配置されます。アプリケーションが WS_EX_TOPMOST ビットなしで非アクティブなウィンドウをアクティブにすると、ウィンドウは最上位以外のすべてのウィンドウの上に移動され、一番上のウィンドウの下に移動されます。

pWndInsertAfter パラメーターが&wndBottomされ、CWndが一番上のウィンドウであるときにSetWindowPosが呼び出されると、ウィンドウは最上位の状態を失い (WS_EX_TOPMOSTはクリアされます)、ウィンドウは Z オーダーの下部に配置されます。

例

void CMyApp::OnHideApplication()
{
   //m_pMainWnd is the main application window, a member of CMyApp
   ASSERT_VALID(m_pMainWnd);

   // hide the application's windows before closing all the documents
   m_pMainWnd->ShowWindow(SW_HIDE);
   m_pMainWnd->ShowOwnedPopups(FALSE);

   // put the window at the bottom of z-order, so it isn't activated
   m_pMainWnd->SetWindowPos(&CWnd::wndBottom, 0, 0, 0, 0,
                            SWP_NOMOVE | SWP_NOSIZE | SWP_NOACTIVATE);
}

`CWnd::SetWindowRgn`

このメンバー関数を呼び出して、ウィンドウの領域を設定します。

int SetWindowRgn(
    HRGN hRgn,
    BOOL bRedraw);

パラメーター

hRgn
リージョンへのハンドル。

bRedraw
TRUE場合、オペレーティングシステムは領域の設定後にウィンドウを再描画します。それ以外の場合は、ウィンドウは再描画されません。通常、ウィンドウが表示されている場合は、 bRedraw を TRUE に設定します。 TRUEに設定すると、WM_WINDOWPOSCHANGINGおよびWM_WINDOWPOSCHANGEDメッセージがウィンドウに送信されます。

戻り値

関数が成功すると、戻り値は 0 以外になります。関数が失敗した場合は、0 を返します。

解説

ウィンドウのウィンドウ領域の座標は、ウィンドウのクライアント領域ではなく、ウィンドウの左上隅を基準にしています。

SetWindowRgnの呼び出しが成功すると、オペレーティングシステムはリージョンハンドル hRgnで指定されたリージョンを所有します。オペレーティングシステムはリージョンのコピーを作成しないため、このリージョンハンドルを使用してそれ以上関数呼び出しを行わず、このリージョンハンドルを閉じないでください。

`CWnd::SetWindowText`

ウィンドウのタイトルを指定したテキストに設定します。

void SetWindowText(LPCTSTR lpszString);

パラメーター

lpszString
新しいタイトルまたはコントロールテキストとして使用する CString オブジェクトまたは null で終わる文字列を指します。

解説

ウィンドウがコントロールの場合、コントロール内のテキストが設定されます。

この関数により、 WM_SETTEXT メッセージがこのウィンドウに送信されます。

例

// set the text in IDC_EDITNAME
CWnd *pWnd = GetDlgItem(IDC_EDITNAME);
pWnd->SetWindowText(_T("Gerald Samper"));

// Get the text back. CString is convenient, because MFC
// will automatically allocate enough memory to hold the
// text--no matter how large it is.

CString str;
pWnd->GetWindowText(str);
ASSERT(str == _T("Gerald Samper"));

// The LPTSTR override works, too, but it might be too short.
// If we supply a buffer that's too small, we'll only get those
// characters that fit.

TCHAR sz[10];
int nRet = pWnd->GetWindowText(sz, 10);

// Nine characters, plus terminating null
ASSERT(_tcscmp(sz, _T("Gerald Sa")) == 0);
ASSERT(nRet == 9);

// You can query the length of the text without the length of
// the string using CWnd::GetWindowTextLength()
nRet = pWnd->GetWindowTextLength();
ASSERT(nRet == 13);

`CWnd::ShowCaret`

キャレットの現在位置の画面にキャレットを表示します。

void ShowCaret();

解説

キャレットは、表示されると自動的に点滅します。

ShowCaretメンバー関数は、キャレットが現在の図形を持ち、連続して 2 回以上非表示になっていない場合にのみ、キャレットを表示します。キャレットがこのウィンドウによって所有されていない場合、キャレットは表示されません。

キャレットの非表示は累積されます。 HideCaretメンバー関数が 5 回連続して呼び出された場合、キャレットを表示するには、ShowCaretを 5 回呼び出す必要があります。

キャレットは共有リソースです。ウィンドウには、入力フォーカスがある場合、またはアクティブな場合にのみキャレットが表示されます。

例

CWnd::CreateCaret の例を参照してください。

`CWnd::ShowOwnedPopups`

このウィンドウが所有するすべてのポップアップウィンドウを表示または非表示にします。

void ShowOwnedPopups(BOOL bShow = TRUE);

パラメーター

bShow
ポップアップウィンドウを表示するか非表示にするかを指定します。このパラメーターが TRUEされている場合は、すべての非表示のポップアップウィンドウが表示されます。このパラメーターが FALSEされている場合、表示されているすべてのポップアップウィンドウは非表示になります。

例

CWnd::SetWindowPos の例を参照してください。

`CWnd::ShowScrollBar`

スクロールバーの表示と非表示を切り替えます。

void ShowScrollBar(
    UINT nBar,
    BOOL bShow = TRUE);

パラメーター

SB_BOTH ウィンドウの水平スクロールバーと垂直スクロールバーを指定します。
SB_HORZ ウィンドウが水平スクロールバーであることを指定します。
SB_VERT ウィンドウが垂直スクロールバーであることを指定します。

bShow
Windows でスクロールバーを表示するか非表示にするかを指定します。このパラメーターが TRUE場合、スクロールバーが表示されます。それ以外の場合、スクロールバーは非表示になります。

解説

アプリケーションは、スクロールバー通知メッセージの処理中にスクロールバーを非表示にする ShowScrollBar を呼び出すべきではありません。

`CWnd::ShowWindow`

ウィンドウの表示状態を設定します。

BOOL ShowWindow(int nCmdShow);

パラメーター

nCmdShow
CWndの表示方法を指定します。次のいずれかの値を指定する必要があります。

SW_HIDE このウィンドウを非表示にし、アクティブ化を別のウィンドウに渡します。
SW_MINIMIZE ウィンドウを最小化し、システムの一覧の最上位ウィンドウをアクティブにします。
SW_RESTORE ウィンドウをアクティブにして表示します。ウィンドウが最小化または最大化されている場合、Windows は元のサイズと位置に復元します。
SW_SHOW ウィンドウをアクティブにし、現在のサイズと位置で表示します。
SW_SHOWMAXIMIZED ウィンドウをアクティブ化し、最大化されたウィンドウとして表示します。
SW_SHOWMINIMIZED ウィンドウをアクティブ化し、アイコンとして表示します。
SW_SHOWMINNOACTIVE ウィンドウをアイコンとして表示します。現在アクティブなウィンドウはアクティブなままです。
SW_SHOWNA ウィンドウを現在の状態で表示します。現在アクティブなウィンドウはアクティブなままです。
SW_SHOWNOACTIVATE ウィンドウを最新のサイズと位置で表示します。現在アクティブなウィンドウはアクティブなままです。
SW_SHOWNORMAL ウィンドウをアクティブにして表示します。ウィンドウが最小化または最大化されている場合、Windows は元のサイズと位置に復元します。

戻り値

ウィンドウが以前に表示されていた場合は 0 以外。 CWnd が以前に非表示になっていた場合は 0。

解説

ShowWindow は、 CWinApp::m_nCmdShowを持つメインウィンドウに対してアプリケーションごとに 1 回だけ呼び出す必要があります。 ShowWindowへの後続の呼び出しでは、CWinApp::m_nCmdShowで指定された値ではなく、上記の値のいずれかを使用する必要があります。

例

CWnd::CalcWindowRect の例を参照してください。

`CWnd::SubclassDlgItem`

このメンバー関数を呼び出して、ダイアログテンプレートから作成されたコントロールを "動的にサブクラス化" し、この CWnd オブジェクトにアタッチします。

BOOL SubclassDlgItem(
    UINT nID,
    CWnd* pParent);

パラメーター

nID
コントロールの ID。

pParent
コントロールの親 (通常はダイアログボックス)。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

コントロールが動的にサブクラス化されると、windows メッセージは CWndのメッセージマップを介してルーティングされ、最初に CWndのクラスでメッセージハンドラーを呼び出します。基底クラスに渡されるメッセージは、コントロールの既定のメッセージハンドラーに渡されます。

このメンバー関数は、Windows コントロールを CWnd オブジェクトにアタッチし、コントロールの WndProc 関数と AfxWndProc 関数を置き換えます。この関数は、GetSuperWndProcAddr メンバー関数によって返される場所に古いWndProcを格納します。

例

// The following code fragment is from CMyDlg::OnInitDialog
// CMyDlg is derived from CDialog.

// IDC_BUTTON1 is the ID for a button on the
// dialog template used for CMyDlg.
m_MyButton.SubclassDlgItem(IDC_BUTTON1, this);

`CWnd::SubclassWindow`

このメンバー関数を呼び出して、ウィンドウを "動的にサブクラス化" し、この CWnd オブジェクトにアタッチします。

BOOL SubclassWindow(HWND hWnd);

パラメーター

hWnd
ウィンドウのハンドル。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

ウィンドウが動的にサブクラス化されると、windows メッセージは CWndのメッセージマップを介してルーティングされ、最初に CWndのクラスでメッセージハンドラーを呼び出します。基底クラスに渡されるメッセージは、ウィンドウ内の既定のメッセージハンドラーに渡されます。

このメンバー関数は、Windows コントロールを CWnd オブジェクトにアタッチし、ウィンドウの WndProc 関数と AfxWndProc 関数を置き換えます。この関数は、CWnd オブジェクト内の古いWndProcへのポインターを格納します。

Note

この関数を呼び出すときに、ウィンドウを MFC オブジェクトにまだアタッチしないでください。

例

// The following code shows how to subclass the edit control and list box
// controls inside a combo box. It uses WM_CTLCOLOR for subclassing.
// CSuperComboBox represents the combo box
HBRUSH CSuperComboBox::OnCtlColor(CDC *pDC, CWnd *pWnd, UINT nCtlColor)
{
   if (nCtlColor == CTLCOLOR_EDIT)
   {
      //Edit control
      if (m_edit.GetSafeHwnd() == NULL)
         m_edit.SubclassWindow(pWnd->GetSafeHwnd());
   }
   else if (nCtlColor == CTLCOLOR_LISTBOX)
   {
      //ListBox control
      if (m_listbox.GetSafeHwnd() == NULL)
         m_listbox.SubclassWindow(pWnd->GetSafeHwnd());
   }

   HBRUSH hbr = CComboBox::OnCtlColor(pDC, pWnd, nCtlColor);
   return hbr;
}

void CSuperComboBox::OnDestroy()
{
   //unsubclass edit and list box before destruction
   if (m_edit.GetSafeHwnd() != NULL)
      m_edit.UnsubclassWindow();
   if (m_listbox.GetSafeHwnd() != NULL)
      m_listbox.UnsubclassWindow();
   CComboBox::OnDestroy();
}

`CWnd::UnlockWindowUpdate`

このメンバー関数を呼び出して、 CWnd::LockWindowUpdateでロックされたウィンドウのロックを解除します。

void UnlockWindowUpdate();

解説

LockWindowUpdateを使用してロックできるのは、一度に 1 つのウィンドウだけです。ウィンドウのロックの詳細については、 CWnd::LockWindowUpdate または Win32 関数の LockWindowUpdate を参照してください。

`CWnd::UnsubclassWindow`

このメンバー関数を呼び出して WndProc 元の値に戻し、HWND によって識別されるウィンドウを CWnd オブジェクトからデタッチします。

HWND UnsubclassWindow();

戻り値

未分類ウィンドウへのハンドル。

例

CWnd::SubclassWindow の例を参照してください。

`CWnd::UpdateData`

このメンバー関数を呼び出して、ダイアログボックス内のデータを初期化するか、ダイアログデータを取得して検証します。

BOOL UpdateData(BOOL bSaveAndValidate = TRUE);

パラメーター

bSaveAndValidate
ダイアログボックスが初期化中 (FALSE) か、データが取得中 (TRUE) かを示すフラグ。

戻り値

操作が成功した場合は 0 以外。それ以外の場合は 0。 bSaveAndValidateがTRUEの場合、戻り値が 0 以外の場合は、データが正常に検証されることを意味します。

解説

フレームワークは、CDialog::OnInitDialogの既定の実装でモーダルダイアログボックスが作成されたときに、bSaveAndValidateがFALSEに設定されたUpdateDataを自動的に呼び出します。この呼び出しは、ダイアログボックスが表示される前に発生します。 CDialog::OnOKの既定の実装では、bSaveAndValidateをTRUEに設定してこのメンバー関数を呼び出してデータを取得し、成功した場合はダイアログボックスを閉じます。 (ダイアログボックスで [キャンセル] ボタンをクリックすると、データを取得せずにダイアログボックスが閉じます)。

`CWnd::UpdateDialogControls`

このメンバー関数を呼び出して、 ON_UPDATE_COMMAND_UI コールバックメカニズムを使用するダイアログボックスまたはウィンドウ内のダイアログボタンおよびその他のコントロールの状態を更新します。

void UpdateDialogControls(
    CCmdTarget* pTarget,
    BOOL bDisableIfNoHndler);

パラメーター

pTarget
アプリケーションのメインフレームウィンドウをポイントし、更新メッセージのルーティングに使用されます。

bDisableIfNoHndler
更新ハンドラーを持たないコントロールを自動的に無効として表示するかどうかを示すフラグ。

解説

子コントロールにハンドラーが存在せず、 bDisableIfNoHndler が TRUE場合、子コントロールは無効になります。

フレームワークは、アプリケーションのアイドル処理の一部として、ダイアログバーまたはツールバー内のコントロールに対してこのメンバー関数を呼び出します。

`CWnd::UpdateLayeredWindow`

レイヤードウィンドウの位置、サイズ、形状、内容、および透明度を更新します。

BOOL UpdateLayeredWindow(
    CDC* pDCDst,
    POINT* pptDst,
    SIZE* psize,
    CDC* pDCSrc,
    POINT* pptSrc,
    COLORREF crKey,
    BLENDFUNCTION* pblend,
    DWORD dwFlags);

パラメーター

pDCDst
画面のデバイスコンテキストへのポインター。これは、ウィンドウの内容が更新されたときにパレットの色の一致に使用されます。 pDCDstがNULLされている場合は、既定のパレットが使用されます。

pDCSrcがNULLの場合は、pDCDstをNULLする必要があります。

pptDst
階層化されたウィンドウの新しい画面位置を指定する POINT 構造体へのポインター。現在の位置が変更されていない場合は、 pptDst を NULLできます。

psize
階層化されたウィンドウの新しいサイズを指定する SIZE 構造体へのポインター。ウィンドウのサイズが変更されていない場合は、 psize を NULLできます。

pDCSrcがNULLの場合は、psizeをNULLする必要があります。

pDCSrc
レイヤードウィンドウを定義するサーフェスの DC へのポインター。ウィンドウの図形と視覚コンテキストが変更されていない場合は、 pDCSrc を NULLできます。

pptSrc
デバイスコンテキスト内のレイヤーの場所を指定する POINT 構造体へのポインター。

pDCSrcがNULLされている場合は、pptSrcをNULLする必要があります。

crKey
レイヤーウィンドウの作成時に使用する透明度カラーキーを指定する COLORREF 値へのポインター。ウィンドウによってこの色で塗りつぶされたすべてのピクセルは透明になります。 COLORREFを生成するには、RGB マクロを使用します。

pblend
レイヤーウィンドウの作成時に使用する透明度の値を指定する BLENDFUNCTION 構造体へのポインター。

dwFlags
実行するアクションを指定します。このパラメーターには、次の値のいずれかを指定できます。使用可能な値の一覧については、 UpdateLayeredWindowを参照してください。

戻り値

関数が正常終了した場合は 0 以外。それ以外の場合は 0。

解説

このメンバー関数は、Windows SDK で説明されているように、関数 UpdateLayeredWindowの機能をエミュレートします。

`CWnd::UpdateWindow`

更新リージョンが空でない場合は、 WM_PAINT メッセージを送信してクライアント領域を更新します。

void UpdateWindow();

解説

UpdateWindow メンバー関数は、アプリケーションキューをバイパスして、WM_PAINT メッセージを直接送信します。更新リージョンが空の場合、 WM_PAINT は送信されません。

例

// In this example a rectangle is drawn in a view.
// The OnChangeRect() function changes the dimensions
// of the rectangle and then calls CWnd::Invalidate() so the
// client area of the view will be redrawn next time the
// window is updated.  It then calls CWnd::UpdateWindow
// to force the new rectangle to be painted.

void CMdiView::OnChangeRect()
{
   // Change Rectangle size.
   m_rcBox = CRect(20, 20, 210, 210);

   // Invalidate window so entire client area
   // is redrawn when UpdateWindow is called.
   Invalidate();

   // Update Window to cause View to redraw.
   UpdateWindow();
}

// On Draw function draws the rectangle.
void CMdiView::OnDraw(CDC *pDC)
{
   // Other draw code here.

   pDC->Draw3dRect(m_rcBox, 0x00FF0000, 0x0000FF00);
}

`CWnd::ValidateRect`

ウィンドウの更新領域から四角形を削除して、指定された四角形内のクライアント領域を検証します。

void ValidateRect(LPCRECT lpRect);

パラメーター

lpRect
更新領域から削除する四角形のクライアント座標を含む CRect オブジェクトまたはRECT構造体を指します。 lpRectがNULLされている場合は、ウィンドウ全体が検証されます。

解説

BeginPaint メンバー関数は、クライアント領域全体を自動的に検証します。次にWM_PAINTが生成される前に更新リージョンの一部を検証する必要がある場合は、ValidateRectとValidateRgnメンバー関数の両方を呼び出す必要があります。

Windows は、現在の更新リージョンが検証されるまで、 WM_PAINT メッセージを生成し続けます。

`CWnd::ValidateRgn`

ウィンドウの現在の更新リージョンからリージョンを削除して、特定のリージョン内のクライアント領域を検証します。

void ValidateRgn(CRgn* pRgn);

パラメーター

pRgn
更新領域から削除する領域を定義する領域を識別する CRgn オブジェクトへのポインター。このパラメーターを NULLすると、クライアント領域全体が削除されます。

解説

指定されたリージョンは、リージョン関数によって以前に作成されている必要があります。領域座標はクライアント座標と見なされます。

BeginPaint メンバー関数は、クライアント領域全体を自動的に検証します。次のWM_PAINT メッセージが生成される前に更新領域の一部を検証する必要がある場合は、ValidateRectとValidateRgnメンバー関数のどちらも呼び出さないでください。

`CWnd::WindowFromPoint`

指定したポイントを含むウィンドウを取得します。 point 画面上のポイントの画面座標を指定する必要があります。

static CWnd* PASCAL WindowFromPoint(POINT point);

パラメーター

point
チェックするポイントを定義する CPoint オブジェクトまたは POINT データ構造を指定します。

戻り値

ポイントが存在するウィンドウオブジェクトへのポインター。特定の時点にウィンドウが存在しない場合は NULL されます。返されるポインターは一時的な場合があり、後で使用するために格納しないでください。

解説

WindowFromPoint は、ポイントがウィンドウ内にある場合でも、非表示または無効なウィンドウを取得しません。アプリケーションでは、 ChildWindowFromPoint メンバー関数を使用して非制限検索を行う必要があります。

`CWnd::WindowProc`

CWnd オブジェクトの Windows プロシージャ (WindowProc) を提供します。

virtual LRESULT WindowProc(
    UINT message,
    WPARAM wParam,
    LPARAM lParam);

パラメーター

message
処理する Windows メッセージを指定します。

wParam
メッセージの処理に使用される追加情報を提供します。パラメーター値はメッセージによって異なります。

lParam
メッセージの処理に使用される追加情報を提供します。パラメーター値はメッセージによって異なります。

戻り値

戻り値はメッセージによって異なります。

解説

ウィンドウのメッセージマップを介してメッセージをディスパッチします。

`CWnd::WinHelp`

WinHelp アプリケーションを起動します。

virtual void WinHelp(
    DWORD_PTR dwData,
    UINT nCmd = HELP_CONTEXT);

パラメーター

dwData
追加のデータを指定します。使用される値は、 nCmd パラメーターの値によって異なります。

nCmd
要求されるヘルプの種類を指定します。使用可能な値の一覧と、 dwData パラメーターに与える影響については、Windows SDK の windows 関数 WinHelp を参照してください。

解説

詳細については、「 CWinApp::WinHelp 」を参照してください。

`CWnd::RegisterTouchWindow`

Windows タッチサポートを登録または登録解除します。

BOOL RegisterTouchWindow(
    BOOL bRegister = TRUE,
    ULONG ulFlags = 0);

パラメーター

bRegister
TRUE は、Windows タッチサポートの登録を示します。それ以外の場合 FALSE 。

ulFlags
省略可能な変更を指定するビットフラグのセット。このフィールドには、0 または次のいずれかの値を含む場合があります: TWF_FINETOUCH、 TWF_WANTPALM。

戻り値

成功した場合は TRUE。それ以外の場合は FALSE。

解説

`CWnd::ResizeDynamicLayout`

ウィンドウで動的レイアウトが有効な場合、子ウィンドウのレイアウトを調整するためにウィンドウのサイズが変更されると、フレームワークによって呼び出されます。

virtual void ResizeDynamicLayout();

次の方法で共有

CWnd クラス

構文

メンバー

パブリック コンストラクター

パブリック メソッド

保護メソッド

パブリック演算子

パブリック データ メンバー

解説

継承階層

要件

CWnd::accDoDefaultAction

パラメーター

戻り値

解説

CWnd::accHitTest

パラメーター

戻り値

解説

CWnd::accLocation

パラメーター

戻り値

解説

CWnd::accNavigate

パラメーター

戻り値

解説

CWnd::accSelect

パラメーター

戻り値

解説

CWnd::AnimateWindow

パラメーター

戻り値

解説

CWnd::ArrangeIconicWindows

戻り値

解説

例

CWnd::Attach

パラメーター

戻り値

例

CWnd::BeginModalState

CWnd::BeginPaint

パラメーター

戻り値

解説

例

CWnd::BindDefaultProperty

パラメーター

解説

例

CWnd::BindProperty

パラメーター

解説

例

CWnd::BringWindowToTop

解説

例

CWnd::CalcWindowRect

パラメーター

解説

例

CWnd::CancelToolTips

パラメーター

解説

例

CWnd::CenterWindow

パラメーター

解説

例

CWnd::ChangeClipboardChain

パラメーター

戻り値

CWnd::CheckDlgButton

パラメーター

解説

例

`CWnd` クラス

パブリックコンストラクター

パブリックメソッド

パブリックデータメンバー

`CWnd::accHitTest`

`CWnd::accLocation`

`CWnd::accNavigate`

`CWnd::accSelect`

`CWnd::AnimateWindow`

`CWnd::ArrangeIconicWindows`

`CWnd::Attach`

`CWnd::BeginModalState`

`CWnd::BeginPaint`

`CWnd::BindDefaultProperty`

`CWnd::BindProperty`

`CWnd::BringWindowToTop`

`CWnd::CalcWindowRect`

`CWnd::CancelToolTips`

`CWnd::CenterWindow`

`CWnd::ChangeClipboardChain`

`CWnd::CheckDlgButton`

`CWnd::CheckRadioButton`

`CWnd::ChildWindowFromPoint`

`CWnd::ClientToScreen`

`CWnd::CloseWindow`

`CWnd::ContinueModal`

`CWnd::Create`

`CWnd::CreateAccessibleProxy`

`CWnd::CreateCaret`

`CWnd::CreateControl`

`CWnd::CreateEx`

`CWnd::CreateGrayCaret`

`CWnd::CreateSolidCaret`

`CWnd::CWnd`

`CWnd::Default`

`CWnd::DefWindowProc`

`CWnd::DeleteTempMap`

`CWnd::DestroyWindow`

`CWnd::Detach`

`CWnd::DlgDirList`