CWaitCursor::CWaitCursor

更新 : 2007 年 11 月

待機カーソルを表示するには、時間がかかる処理を実行するコードの前に CWaitCursor オブジェクトを宣言するだけです。

CWaitCursor( );

解説

コンストラクタは、自動的に待機カーソルが表示されるようにします。

オブジェクトがスコープ外 (CWaitCursor オブジェクトが宣言されたブロックの終わり) になると、デストラクタは、カーソルを以前のカーソルに戻します。つまり、オブジェクトは必要な後処理を自動的に行います。

ブロックの終わり (関数の終わりより前) でデストラクタが呼ばれることを利用して、待機カーソルを関数の一部だけでアクティブにすることもできます。この方法は、以下の 2 番目の例で示しています。

メモ :
コンストラクタとデストラクタの動作方法のため、CWaitCursor オブジェクトは、常にローカル変数として宣言します。グローバル変数として宣言したり、new を使って割り当てないでください。

使用例

// The following example illustrates the most common case
// of displaying the wait cursor during some lengthy
// processing.
void LengthyFunction()
{
   // perhaps you display a dialog box before displaying a
   // wait cursor

   CWaitCursor wait;   // display wait cursor

   // do some lengthy processing
   Sleep(1000);

}  // destructor automatically removes the wait cursor

// This example shows using a CWaitCursor object inside a block
// so the wait cursor is displayed only while the program is
// performing a lengthy operation.
void ConditionalFunction()
{
   if (SomeCondition)
   {
      CWaitCursor wait;   // display wait cursor in this block only

      // do some lengthy processing
      Sleep(1000);

   }  // at this point, the destructor removes the wait cursor
   else
   {
      // no wait cursor--only quick processing
   }
}

必要条件

ヘッダー : afxwin.h

参照

参照

CWaitCursor クラス

階層図

CWaitCursor::Restore

CCmdTarget::BeginWaitCursor

CCmdTarget::EndWaitCursor