CWnd::FindWindow

Artigo
06/10/2015

Retorna CWnd de nível superior cuja classe de janela é determinada por lpszClassName e cujos o nome da janela, ou o título, são fornecidos por lpszWindowName.

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

Parâmetros

lpszClassName
Aponta para uma cadeia de caracteres NULL- finalizada que especifica o nome de classe de janela (uma estrutura de WNDCLASS ). Se lpClassName é NULO, todos os nomes de classe correspondente.
lpszWindowName
Aponta para uma cadeia de caracteres NULL- finalizada que especifica o nome da janela (o título da janela). Se lpWindowName é NULO, todos os nomes da janela correspondem.

Valor de retorno

Identifica a janela que tem o nome da classe e o nome especificado da janela. É NULO se nenhuma uma janela está localizada.

CWnd* pode ser temporário e não deve ser armazenado para uso posterior.

Comentários

Essa função não procura janelas filho.

Exemplo

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