CWnd::ScrollWindow

CWnd の現在のオブジェクトのクライアント領域の内容をスクロールします。

void ScrollWindow(
   int xAmount,
   int yAmount,
   LPCRECT lpRect = NULL,
   LPCRECT lpClipRect = NULL 
);

パラメーター

  • xAmount
    、水平スクロールのデバイス単位に、量を指定します。このパラメーターは左にスクロールする負の値である必要があります。

  • yAmount
    は、垂直スクロールのデバイス単位に、量を指定します。このパラメーターは、スクロールする負の値である必要があります。

  • lpRect
    スクロールするクライアント領域の部分を指定する RECTCRect のオブジェクトまたは構造体へのポインター。lpRect が null場合は、クライアント領域全体がスクロールされます。キャレットは、カーソルの四角形がスクロールの四角形として位置が変わります。

  • lpClipRect
    スクロールするクリッピング四角形を指定する RECT の構造または CRect オブジェクトをポイントします。この四角形内のビットがスクロールされます。この四角形の外側のビットは lpRect の四角形でも影響を受けません。lpClipRect が nullの場合、クリッピングはスクロールの四角形に行われません。

解説

キャレットがスクロールされる CWnd にある場合は ScrollWindow 防ぐために自動的にキャレットを復元する非表示にし、スクロールが完了するとキャレットを消去できます。キャレットの位置に応じて調整されます。

領域は、関数が再描画が済んでいて、CWnd の現在の更新領域に結合する ScrollWindow のメンバーによって折り返しを取りました。アプリケーションは、最終的に領域の再描画が必要なことを通知 WM_PAINT のメッセージを受信します。見つかったを取得された領域を再描画するには同時にスクロールが行われたり呼び出します。ScrollWindow、を呼び出した直後の UpdateWindow のメンバー関数を参照してください。

lpRect が nullの場合、ウィンドウのすべての子ウィンドウの位置は xAmount と yAmountで指定された量だけ短縮され CWnd の無効な (未塗装) 領域は、オフセットされます。ScrollWindow は lpRect が nullの場合よりも高速です。

lpRect が nullでない場合、子ウィンドウの位置は変更されず、CWnd の無効な領域はオフセットされません。lpRect が nullの場合に問題を更新することを防ぐには、ScrollWindowを呼び出す前に CWnd を再描画するように UpdateWindow のメンバー関数を呼び出します。

必要条件

ヘッダー: afxwin.h

参照

関連項目

CWnd クラス

階層図

CWnd::UpdateWindow

ScrollWindow