Partager via


CWnd::FindWindow

Retourne CWnd de niveau supérieur de la classe de fenêtre est fournie par lpszClassName et dont le nom de la fenêtre, ou le titre, est fourni par lpszWindowName.

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

Paramètres

  • lpszClassName
    Pointe vers une chaîne terminée par le caractère NULL qui spécifie le nom de classe de la fenêtre (une structure de WNDCLASS ). Si lpClassName est NULL, tous les noms de classes correspondent.

  • lpszWindowName
    Pointe vers une chaîne terminée par le caractère NULL qui spécifie le nom de fenêtre (le titre de la fenêtre). Si lpWindowName est NULL, tous les noms de fenêtre correspondent.

Valeur de retour

Identifie la fenêtre qui a le nom de classe et le nom de la fenêtre spécifiés. C'est NULL si aucune fenêtre n'est trouvée.

CWnd* peut être temporaire et ne doit pas être enregistré pour une utilisation ultérieure.

Notes

Cette fonction ne trouve pas les fenêtres enfants.

Exemple

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

Configuration requise

Header: afxwin.h

Voir aussi

Référence

CWnd, classe

Graphique de la hiérarchie

FindWindow