TN003: Zuordnen von Fensterhandles zu Objekten
Dieser Hinweis beschreibt die MFC-Routinen, die die Zuordnung von Windows-Objekthandles C++-Objekten zu unterstützen.
Das Problem
Windows-Objekte werden in der Regel von verschiedenen HANDLE-Objekte dargestellt, die die MFC-Klassen-Umbruch Windows-Objekthandles mit C++ Objekte. Die Handleumbruchsfunktionen der MFC-Klassen-Bibliothek lassen Sie das C++-Objekt finden, das das Windows-Objekt umschließt, das ein bestimmtes Handle hat. Bisweilen hat kein Objekt Wrapperobjekt einer C++-Datei und zu diesen Fällen erstellt das System ein temporäres Objekt, das als C++-Wrapper fungiert.
Windows - Objekt, dass Verwendungshandlezuordnungen sind, wie folgt:
HWND (CWnd und CWnd abgeleitete Klassen)
HDC (CDC und CDC abgeleitete Klassen)
HMENU (CMenu)
HPEN (CGdiObject)
HBRUSH (CGdiObject)
HFONT (CGdiObject)
HBITMAP (CGdiObject)
HPALETTE (CGdiObject)
HRGN (CGdiObject)
HIMAGELIST (CImageList)
SOCKET (CSocket)
Ein Handle bis eines dieser Objekte zugewiesen, können Sie das MFC-Objekt finden, das das Handle umschließt, indem die statische Methode FromHandle aufruft. Beispielsweise HWND angegeben dem Namen hWnd, die folgenden Zeilen zurückgibt einen Zeiger auf CWnd auf, der hWnd umschließt:
CWnd::FromHandle(hWnd)
Wenn hWnd kein bestimmtes Wrapperobjekt hat, wird temporäres CWnd, um hWnd zu umschließen. Dies ermöglicht es, ein gültiges C++-Objekt von jedem Handle zu erhalten.
Nachdem Sie ein Wrapperobjekt haben, können Sie das Handle einer Variable des öffentlichen Members der Wrapperklasse abrufen. Bei CWnd enthält m_hWnd HWND für dieses Objekt.
Anfügen von Handles auf MFC-Objekte
Ein neu erstelltes HandleWrapperobjekt und ein Handle für ein Windows-Objekt gegeben, können Sie die beiden zuordnen, indem Sie die Attach-Funktion entsprechend diesem Beispiel aufrufen:
CWnd myWnd;
myWnd.Attach(hWnd);
Dies macht einen Eintrag der permanenten Zuordnung, die myWnd und hWnd zuordnet. CWnd::FromHandle(hWnd) aufrufen, gibt jetzt einen Zeiger auf myWnd zurück. Wenn myWnd gelöscht wird, zerstört der Destruktor automatisch hWnd, indem er der Windows-Funktion DestroyWindow. Wenn dies nicht erforderlich ist, muss hWnd von myWnd getrennt werden, bevor myWnd zerstört wird (normalerweise, wenn der Bereich verlassen wird, in dem myWnd definiert wurde). Die Detach-Methode geschieht.
myWnd.Detach();
Weitere zu temporären Objekte
Temporäre Objekte werden erstellt, wenn FromHandle ein Handle übergeben wird, das noch ein Wrapperobjekt hat. Diese temporäre Objekte werden von ihrem Handle getrennt gelöscht und durch die DeleteTempMap-Funktionen. Standardmäßig ruft CWinThread::OnIdle automatisch DeleteTempMap für jede Klasse, die temporäre Handlezuordnungen unterstützt. Dies bedeutet, dass Sie nicht davon ausgehen können, dass ein Zeiger auf einen temporären Objekt hinter dem Punkt der Beendigung der Funktion gültig ist, in der der Zeiger abgerufen wurde.
Wrapper-Objekte und mehrere Threads
werden temporäre und permanente Objekte pro Thread beibehalten. Das bedeutet, dass ein Thread auf C++-Wrapperobjekte eines anderen Threads nicht zugreifen, unabhängig davon, ob er temporär oder permanent ist.
Damit diese Objekte von einem Thread zu einem anderen zu übergeben, senden Sie sie immer als ihr systemeigener Typ HANDLE. Durch Übergeben des Wrapperobjekts eine C++-Headerdatei von einem Thread zu anderen verursacht oftmals zu unerwarteten Ergebnissen.