CWnd::FindWindow

Artikel
06/10/2015

Gibt CWnd der obersten Ebene zurück, dessen Fensterklasse durch lpszClassName zugewiesen wird und dessen Fenstername oder Name, durch lpszWindowName angegeben ist.

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

Parameter

lpszClassName
Zeigt auf eine auf NULL endende Zeichenfolge, die den Klassennamen des Fensters angibt (eine WNDCLASS-Struktur). Wenn lpClassNameNULL ist, werden alle Klassennamen ab.
lpszWindowName
Zeigt auf eine auf NULL endende Zeichenfolge, die den Fensternamen angibt (den Namen des Fensters). Wenn lpWindowNameNULL ist, weist alle Fenster Übereinstimmung.

Rückgabewert

Identifiziert das Fenster, das den angegebenen Klassennamen und den Fensternamen verfügt. Es ist NULL, wenn kein solches Fenster gefunden wird.

CWnd* kann temporär sein und sollte nicht für die spätere Verwendung gespeichert werden.

Hinweise

Diese Funktion findet keine untergeordneten Fenster.

Beispiel

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