Freigeben über


CWindow Class

Diese Klasse stellt Methoden zum Bearbeiten eines Fensters.

Wichtig

Diese Klasse und ihre Member können in Anwendungen nicht verwendet werden, die in der Windows Runtime ausführen.

class CWindow

Mitglieder

Öffentliche Konstruktoren

Name

Beschreibung

CWindow::CWindow

Konstruktor.

Öffentliche Methoden

Name

Beschreibung

CWindow::ArrangeIconicWindows

Ordnet alle minimierten untergeordneten Fenster an.

CWindow::Attach

Fügt ein Fenster mit dem CWindow-Objekt.

CWindow::BeginPaint

Bereitet das Fenster zum Zeichnen vor.

CWindow::BringWindowToTop

Setzt das Fenster zum Anfang der z-Ordnung.

CWindow::CenterWindow

Zentriert das Fenster mit einem angegebenen Fenster.

CWindow::ChangeClipboardChain

Entfernt das Fenster in der Kette von Zwischenablagen-Viewern.

CWindow::CheckDlgButton

Ändert den Aktivierungszustand der angegebenen Schaltfläche.

CWindow::CheckRadioButton

Überprüft das angegebene Optionsfeld.

CWindow::ChildWindowFromPoint

Ruft das untergeordnete Fenster ab, das den angegebenen Punkt enthält.

CWindow::ChildWindowFromPointEx

Ruft einen bestimmten Typ untergeordnetes Fenster den angegebenen Punkt enthalten.

CWindow::ClientToScreen

Konvertiert Clientkoordinaten zu Bildschirmkoordinaten.

CWindow::Create

Stellt ein Fenster erstellt.

CWindow::CreateCaret

Erstellt eine neue Form für das Caretzeichen.

CWindow::CreateGrayCaret

Erstellt ein graues Rechteck für das Caretzeichen.

CWindow::CreateSolidCaret

Erstellt ein ausgefülltes Rechteck für das Caretzeichen.

CWindow::DeferWindowPos

Aktualisiert die angegebene Mehrfachverbindungsstelle-FensterPosition Struktur für das angegebene Fenster.

CWindow::DestroyWindow

Zerstört das Fenster, das mit dem CWindow-Objekt zugeordnet ist.

CWindow::Detach

Trennt das Fenster im CWindow-Objekt.

CWindow::DlgDirList

Füllt ein Listenfeld mit den Namen aller Dateien aus, die einen angegebenen Pfad oder einen Dateinamen übereinstimmen.

CWindow::DlgDirListComboBox

Füllt ein Kombinationsfeld mit den Namen aller Dateien aus, die einen angegebenen Pfad oder einen Dateinamen übereinstimmen.

CWindow::DlgDirSelect

Ruft die aktuelle Auswahl von einem Listenfeld ab.

CWindow::DlgDirSelectComboBox

Ruft die aktuelle Auswahl in einem Kombinationsfeld ab.

CWindow::DragAcceptFiles

Registriert, dass das Fenster gezogene Dateien akzeptiert.

CWindow::DrawMenuBar

Aktualisiert die Menüleiste des Fensters neu.

CWindow::EnableScrollBar

Aktiviert oder deaktiviert die Pfeile der Bildlaufleiste.

CWindow::EnableWindow

Aktiviert oder deaktiviert Eingabe.

CWindow::EndPaint

Markiert das Ende des Zeichnens.

CWindow::FlashWindow

Blinkt das Fenster erneut.

CWindow::GetClientRect

Ruft die Koordinaten des Clientbereichs ab.

CWindow::GetDC

Ruft einen Gerätekontext für den Clientbereich ab.

CWindow::GetDCEx

Ruft einen Gerätekontext für den Clientbereich ab und ermöglicht Clippingoptionen.

CWindow::GetDescendantWindow

Ruft das angegebene untergeordnete Fenster ab.

CWindow::GetDlgControl

Ruft eine Schnittstelle für das angegebene Steuerelement ab.

CWindow::GetDlgCtrlID

Ruft den Bezeichner des Fensters ab (nur für untergeordnete Fenster).

CWindow::GetDlgHost

Ruft einen Zeiger auf eine Schnittstelle zum ATL-Steuerhostingcontainer ab.

CWindow::GetDlgItem

Ruft das angegebene untergeordnete Fenster ab.

CWindow::GetDlgItemInt

Übersetzt den Text eines Steuerelements in eine ganze Zahl.

CWindow::GetDlgItemText

Ruft den Text eines Steuerelements ab.

CWindow::GetExStyle

Ruft die erweiterten Fensterstile ab.

CWindow::GetFont

Ruft die aktuelle Schriftart des Fensters ab.

CWindow::GetHotKey

Bestimmt die Zugriffstaste, die mit dem Fenster zugeordnet ist.

CWindow::GetIcon

Ruft das große oder kleine Symbol des Fensters ab.

CWindow::GetLastActivePopup

Ruft das zuletzt aktive Popupfenster ab.

CWindow::GetMenu

Ruft das Menü des Fensters ab.

CWindow::GetNextDlgGroupItem

Ruft das vorherige oder nächste Steuerelement innerhalb einer Gruppe Steuerelemente ab.

CWindow::GetNextDlgTabItem

Ruft das vorherige oder nächste Steuerelement ab, das das WS_TABSTOP-Format hat.

CWindow::GetParent

Ruft das unmittelbar übergeordnete Fenster ab.

CWindow::GetScrollInfo

Ruft die Parameter einer Bildlaufleiste ab.

CWindow::GetScrollPos

Ruft die Position des Bildlauffelds ab.

CWindow::GetScrollRange

Ruft den Bildlaufleistenbereich ab.

CWindow::GetStyle

Ruft die Fensterstile ab.

CWindow::GetSystemMenu

Erstellt eine Kopie des Systemmenüs für Änderung.

CWindow::GetTopLevelParent

Ruft das übergeordnete Element oder das Besitzerfenster der obersten Ebene ab.

CWindow::GetTopLevelWindow

Ruft das Besitzerfenster der obersten Ebene ab.

CWindow::GetTopWindow

Ruft das untergeordnete Fenster der obersten Ebene ab.

CWindow::GetUpdateRect

Ruft die Koordinaten des kleinsten Rechtecks ab, das vollständig das UpdatePanel einschließt.

CWindow::GetUpdateRgn

Ruft den UpdatePanel ab und kopiert sie in einen angegebenen Bereich.

CWindow::GetWindow

Ruft das angegebene Fenster ab.

CWindow::GetWindowContextHelpId

Ruft den Hilfekontextbezeichner des Fensters ab.

CWindow::GetWindowDC

Ruft einen Gerätekontext für das gesamte Fenster ab.

CWindow::GetWindowLong

Ruft einen 32-Bit-Wert an einem angegebenen Offset in zusätzlichen Fensterarbeitsspeicher ab.

CWindow::GetWindowLongPtr

Ruft Informationen über das angegebene Fenster, einschließlich einen Wert an einem angegebenen Offset in zusätzlichen Fensterarbeitsspeicher ab.

CWindow::GetWindowPlacement

Ruft den Ansichtszustand und Positionen ab.

CWindow::GetWindowProcessID

Ruft den Bezeichner des Prozesses ab, der das Fenster erstellt wurde.

CWindow::GetWindowRect

Ruft die springenden Dimensionen des Fensters ab.

CWindow::GetWindowRgn

Ruft eine Kopie des Fensterbereichs eines Fensters.

CWindow::GetWindowText

Ruft den Text des Fensters ab.

CWindow::GetWindowTextLength

Ruft die Länge des Texts des Fensters ab.

CWindow::GetWindowThreadID

Ruft den Bezeichner des Threads ab, der das angegebene Fenster erstellt wurde.

CWindow::GetWindowWord

Ruft einen 16-Bit-Wert in einem angegebenen Offset in zusätzlichen Fensterarbeitsspeicher ab.

CWindow::GotoDlgCtrl

Legt den Tastaturfokus zu einem Steuerelement im Dialogfeld fest.

CWindow::HideCaret

Blendet das Caretzeichen aus.

CWindow::HiliteMenuItem

Hervorhebungen oder entfernt die Hervorhebung von einem Menüelement der obersten Ebene.

CWindow::Invalidate

Löscht den gesamten Clientbereich ungültig.

CWindow::InvalidateRect

Löscht den Clientbereich innerhalb des angegebenen Rechtecks ungültig.

CWindow::InvalidateRgn

Löscht den Clientbereich innerhalb des angegebenen Bereichs ungültig.

CWindow::IsChild

Bestimmt, ob das angegebene Fenster ein untergeordnetes Fenster ist.

CWindow::IsDialogMessage

Bestimmt, ob eine Meldung für das angegebene Dialogfeld vorgesehen.

CWindow::IsDlgButtonChecked

Bestimmt den Aktivierungszustand der Schaltfläche.

CWindow::IsIconic

Bestimmt, ob das Fenster minimiert wird.

CWindow::IsParentDialog

Bestimmt, ob das übergeordnete Fenster eines Steuerelements ein Dialogfeld ist.

CWindow::IsWindow

Bestimmt, ob das angegebene Fensterhandle ein vorhandenes Fenster identifiziert.

CWindow::IsWindowEnabled

Bestimmt, ob das Fenster für Eingabe aktiviert ist.

CWindow::IsWindowUnicode

Bestimmt, ob das angegebene Fenster ein systemeigenes Unicode-Fenster ist.

CWindow::IsWindowVisible

Bestimmt den Sichtbarkeitszustand des Fensters.

CWindow::IsZoomed

Bestimmt, ob das Fenster maximiert wird.

CWindow::KillTimer

Zerstört ein Zeitgeberereignis.

CWindow::LockWindowUpdate

Deaktiviert oder aktiviert Zeichnung im Fenster.

CWindow::MapWindowPoints

Konvertiert einen von Punkten im Koordinatenraum des Fensters zum Koordinatenraum eines anderen Fensters.

CWindow::MessageBox

Zeigt ein Meldungsfeld an.

CWindow::ModifyStyle

Ändert die Fensterstile.

CWindow::ModifyStyleEx

Ändert die erweiterten Fensterstile.

CWindow::MoveWindow

Ändert die Größe des Fensters und Position.

CWindow::NextDlgCtrl

Legt den Tastaturfokus zum nächsten Steuerelement im Dialogfeld fest.

CWindow::OpenClipboard

Öffnet die Zwischenablage.

CWindow::PostMessage

Setzt eine Meldung in der Meldungswarteschlange, die mit dem Thread zugeordnet ist, der das Fenster erstellt wurde. EINGABETASTE, ohne auf den Thread zu warten, bis die Nachricht zu verarbeiten.

CWindow::PrevDlgCtrl

Legt den Tastaturfokus zum vorherigen Steuerelement im Dialogfeld fest.

CWindow::Print

Die diese Anforderungen das Fenster werden in einem angegebenen Gerätekontext gezeichnet.

CWindow::PrintClient

Die diese Anforderungen der Clientbereich des Fensters werden in einem angegebenen Gerätekontext gezeichnet.

CWindow::RedrawWindow

Aktualisiert ein bestimmtes Rechteck oder einen Bereich im Clientbereich.

CWindow::ReleaseDC

Gibt einen Gerätekontext frei.

CWindow::ResizeClient

Ändert die Größe des Fensters.

CWindow::ScreenToClient

Konvertiert Bildschirmkoordinaten in Clientkoordinaten.

CWindow::ScrollWindow

Führt den angegebenen Clientbereich aus.

CWindow::ScrollWindowEx

Führt den angegebenen Clientbereich mit zusätzlichen Funktionen aus.

CWindow::SendDlgItemMessage

Sendet eine Nachricht an ein Steuerelement.

CWindow::SendMessage

Sendet eine Meldung in die Fenster und wird erst zurückgegeben, wenn die Fensterprozedur die Meldung verarbeitet hat.

CWindow::SendMessageToDescendants

Sendet eine Nachricht an den angegebenen Nachfolgerelemente Fenstern.

CWindow::SendNotifyMessage

Sendet eine Meldung in das Fenster. Wenn das Fenster durch den aufrufenden Thread erstellt wurde, gibt SendNotifyMessage nicht zurück, bis die Fensterprozedur die Meldung verarbeitet hat. Andernfalls wird sie sofort zurück.

CWindow::SetActiveWindow

Ermöglicht das Fenster.

CWindow::SetCapture

Sendet alle folgenden Maus, die an das Fenster eingegeben wird.

CWindow::SetClipboardViewer

Fügt das Fenster der Zwischenablagen-Viewer-Kette hinzu.

CWindow::SetDlgCtrlID

Ändert den Bezeichner des Fensters.

CWindow::SetDlgItemInt

Ändert den Text eines Steuerelements an die Zeichenfolgendarstellung eines ganzzahligen Werts.

CWindow::SetDlgItemText

Ändert den Text eines Steuerelements.

CWindow::SetFocus

Legt den Eingabefokus auf fest.

CWindow::SetFont

Ändert die aktuelle Schriftart des Fensters.

CWindow::SetHotKey

Ordnet eine Zugriffstaste mit dem Fenster zu.

CWindow::SetIcon

Ändert das große oder kleine Symbol des Fensters.

CWindow::SetMenu

Ändert das aktuelle Menü des Fensters.

CWindow::SetParent

Ändert das übergeordnete Fenster.

CWindow::SetRedraw

Setzt oder freie Räume das Aktualisierungsflag.

CWindow::SetScrollInfo

Legt die Parameter einer Bildlaufleiste fest.

CWindow::SetScrollPos

Ändert die Position des Bildlauffelds.

CWindow::SetScrollRange

Ändert den Bildlaufleistenbereich.

CWindow::SetTimer

Erstellt ein Timer-Ereignis.

CWindow::SetWindowContextHelpId

Legt den Hilfekontextbezeichner des Fensters fest.

CWindow::SetWindowLong

Legt einen 32-Bit-Wert an einem angegebenen Offset in zusätzlichen Fensterarbeitsspeicher fest.

CWindow::SetWindowLongPtr

Ändert ein Attribut des angegebenen Fensters und legt auch einen Wert am angegebenen Offset im zusätzlichen Fensterarbeitsspeicher fest.

CWindow::SetWindowPlacement

Legt den Ansichtszustand und Positionen fest.

CWindow::SetWindowPos

Legt die Größe, Position und die z-Ordnung fest.

CWindow::SetWindowRgn

Legt den Fensterbereich eines Fensters fest.

CWindow::SetWindowText

Ändert den Text des Fensters.

CWindow::SetWindowWord

Legt einen 16-Bit-Wert in einem angegebenen Offset in zusätzlichen Fensterarbeitsspeicher fest.

CWindow::ShowCaret

Zeigt das Caretzeichen an.

CWindow::ShowOwnedPopups

In oder aus die Popupfenster im Besitz das Fenster.

CWindow::ShowScrollBar

In oder aus ein Bildlaufleiste.

CWindow::ShowWindow

Legt den Anzeigezustand des Fensters fest.

CWindow::ShowWindowAsync

Legt den Ansichtszustand eines Fensters fest, das von einem anderen Thread erstellt wird.

CWindow::UpdateWindow

Aktualisiert den Clientbereich.

CWindow::ValidateRect

Überprüft den angegebenen Clientbereich innerhalb des Rechtecks.

CWindow::ValidateRgn

Überprüft den Clientbereich innerhalb des angegebenen Bereichs.

CWindow::WinHelp

Anfangs-Windows-Hilfe.

Öffentliche Operatoren

Name

Beschreibung

CWindow::operator HWND

Konvertiert das CWindow-Objekt zu HWND.

CWindow::operator =

Weist HWND zum CWindow-Objekt zu.

Öffentliche Datenmember

Name

Beschreibung

CWindow::m_hWnd

Das Handle für das Fenster, das dem CWindow-Objekt zugeordnet ist.

CWindow::rcDefault

Enthält Standard Fensterdimensionen.

Hinweise

CWindow stellt Basisfunktionen zum Bearbeiten eines Fensters in ATL bereit. Viele der CWindow-Methoden binden einfach eine der Win32-API-Funktionen ein. Beispielsweise vergleichen Sie die Prototypen für CWindow::ShowWindow und ShowWindow:

CWindow-Methode

Win32-Funktion

BOOL ShowWindow( int nCmdShow);

BOOL ShowWindow( HWND hWnd, int nCmdShow);

CWindow::ShowWindow ruft die Win32-Funktion ShowWindow auf, indem sie CWindow::m_hWnd als erster Parameter übergeben. Jede CWindow-Methode, die direkt eine Win32-Funktion umschließt, führt den m_hWnd-Member, daher verweist viel der CWindow Dokumentation Sie zu Windows SDK.

Hinweis

Nicht jede fensterbezogene Win32-Funktion wird durch CWindow und umschließt nicht jeder CWindow-Methode eine Win32-Funktion umschlossen.

CWindow::m_hWnd speichert HWND, das ein Fenster identifiziert. HWND wird dem Objekt angefügt, wenn Sie:

  • Geben Sie HWND im Konstruktor von CWindow an.

  • Rufen Sie CWindow::Attach auf.

  • Verwenden Sie operator = von CWindow.

  • Herstellen oder ordnen Sie ein Fenster mit einer der folgenden Klassen unter, die von CWindow abgeleitet werden:

    CWindowImpl ermöglicht es Ihnen, ein neues Fenster zu erstellen oder ein vorhandenes Fenster unterzuordnen.

    CContainedWindow implementiert ein Fenster, das innerhalb eines anderen Objekts enthalten ist. Sie können ein neues Fenster erstellen oder ein vorhandenes Fenster unterordnen.

    CDialogImpl ermöglicht es Ihnen, ein modales oder ein nicht modales Dialogfeld zu erstellen.

Weitere Informationen zum Fenster, finden Sie unter Windows und folgende Themen in Windows SDK. Weitere Informationen zur Verwendung von Fenstern in ATL, finden Sie im Artikel ATL-Fensterklassen.

Anforderungen

Header: atlwin.h

Siehe auch

Weitere Ressourcen

ATL Class Overview