CWaitCursor::CWaitCursor

Artigo
08/25/2010

Para exibir um cursor de espera, basta declarar um CWaitCursor objeto antes do código que executa a operação demorada.

CWaitCursor( );

Comentários

O construtor automaticamente faz com que o cursor de espera ser exibido.

Quando o objeto sai do escopo (no participante do bloco em que o CWaitCursor objeto for declarado), seu destruidor define o cursor para o cursor anterior. Em outras palavras, o objeto executa automaticamente a limpeza necessária.

Você pode tirar proveito do fato de que o destruidor é chamado no participante do bloco (que pode ser antes do participante da função) para tornar o cursor de espera ativo somente parte da sua função.Essa técnica é mostrada na segundo exemplo a seguir.

Observação:
Por causa de como funcionam os construtores e destrutores, CWaitCursor objetos sempre são declarados sistema autônomo variáveis locais — nunca são declaradas sistema autônomo variáveis global, nem são alocados com novo.

Exemplo

// 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
   }
}