CWindow-Klasse

Diese Klasse stellt Methoden zum Bearbeiten eines Fensters bereit.

Syntax

class CWindow

Member

Öffentliche Konstruktoren

Öffentliche Methoden

Öffentliche Operatoren

Öffentliche Datenmember

Hinweise

CWindow stellt die Basisfunktionalität zum Bearbeiten eines Fensters in ATL bereit. Viele der CWindow Methoden umschließen einfach eine der Win32-API-Funktionen. Vergleichen Sie z. B. die Prototypen für CWindow::ShowWindow und ShowWindow:

CWindow::ShowWindow ruft die Win32-Funktion ShowWindow auf, indem sie als erster Parameter übergeben CWindow::m_hWnd wird. Jede CWindow Methode, die direkt eine Win32-Funktion umschließt, übergibt das m_hWnd Element. Daher verweisen Viele der CWindow Dokumentationen auf das Windows SDK.

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

• Geben Sie einen HWND Konstruktor in CWindow's an.

• Rufen Sie CWindow::Attach auf.

• Verwenden Sie CWindow's operator =.

• Erstellen oder Unterklassen eines Fensters mit einer der folgenden Klassen, die von CWindow:

CWindowImpl Ermöglicht ihnen das Erstellen eines neuen Fensters oder einer Unterklasse eines vorhandenen Fensters.

CContainedWindow Implementiert ein Fenster, das in einem anderen Objekt enthalten ist. Sie können ein neues Fenster oder eine Unterklasse eines vorhandenen Fensters erstellen.

CDialogImpl Ermöglicht ihnen das Erstellen eines modalen oder moduslosen Dialogfelds.

Weitere Informationen zu Windows finden Sie unter Windows und nachfolgenden Themen im Windows SDK. Weitere Informationen zur Verwendung von Fenstern in ATL finden Sie im Artikel ATL-Fensterklassen.

Anforderungen

Header: atlwin.h

CWindow::ArrangeIconicWindows

Ordnet alle minimierten untergeordneten Fenster an.

UINT ArrangeIconicWindows() throw();

Hinweise

Siehe ArrangeIconicWindows im Windows SDK.

CWindow::Attach

Fügt das dem hWndNew Objekt identifizierte Fenster an CWindow .

void Attach(HWND hWndNew) throw();

Parameter

hWndNew
[in] Der Ziehpunkt für ein Fenster.

Beispiel

//The following example attaches an HWND to the CWindow object
HWND hWnd  = ::GetDesktopWindow();
CWindow myWindow;
myWindow.Attach(hWnd);

CWindow::BeginPaint

Bereitet das Fenster auf das Malen vor.

HDC BeginPaint(LPPAINTSTRUCT lpPaint) throw();

Hinweise

Siehe BeginPaint im Windows SDK.

Beispiel

//The following example attaches an HWND to the CWindow object
//and calls CWindow::BeginPaint() and CWindow::EndPaint() in the 
// WM_PAINT handler of a CWindowImpl-derived class
LRESULT CMyCtrl::OnPaint(UINT /*uMsg*/, WPARAM /*wParam*/, LPARAM /*lParam*/, 
   BOOL& /*bHandled*/)
{
   CWindow myWindow;
   myWindow.Attach(m_hWnd);
   PAINTSTRUCT ps;
   HDC hDC  = myWindow.BeginPaint(&ps);
   //Use the hDC as much as you want
   ::Rectangle(hDC, 0, 0, 50, 50);

   myWindow.EndPaint(&ps);

   return 0;
}

CWindow::BringWindowToTop

Bringt das Fenster an den Anfang der Z-Reihenfolge.

BOOL BringWindowToTop() throw();

Hinweise

Siehe BringWindowToTop im Windows SDK.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::BringWindowToTop() to bring the window to the top 
//of the z-order.

CWindow myWindow;
myWindow.Attach(hWnd);
BOOL bOnTop = myWindow.BringWindowToTop();

//check if we could bring the window on top
if(bOnTop)
{
   //Do something
}

CWindow::CenterWindow

Zentrieren Sie das Fenster auf ein bestimmtes Fenster.

BOOL CenterWindow(HWND hWndCenter = NULL) throw();

Parameter

hWndCenter
[in] Der Ziehpunkt für das Fenster, gegen das zentrieren soll. Wenn dieser Parameter (Standardwert) ist NULL , wird die Methode auf das übergeordnete Fenster des Fensters festgelegt hWndCenter , wenn es sich um ein untergeordnetes Fenster handelt. Andernfalls wird sie auf das Besitzerfenster des Fensters festgelegt hWndCenter .

Rückgabewert

TRUEwenn das Fenster erfolgreich zentriert ist; andernfalls . FALSE

Beispiel

//The following example attaches various HWNDs to the CWindow objects 
//and calls CWindow::CenterWindow() for each of them

CWindow childWindow, popupWindow, overlappedWindow;

childWindow.Attach(hWndChild); //a window created with WS_CHILD style
childWindow.CenterWindow();    //This will center the child 
                               //window against its Parent window

popupWindow.Attach(hWndPopup); //a window created with WS_POPUP style
popupWindow.CenterWindow();    //This will center the popup window 
                               //against its Owner window

overlappedWindow.Attach(hWndOverlapped); //a window created with 
                                         //WS_OVERLAPPED style
overlappedWindow.CenterWindow(::GetDesktopWindow()); //This will center 
                       //the overlapped window against the DeskTop window

CWindow::ChangeClipboardChain

Entfernt das Fenster aus der Kette der Zwischenablageanzeigen.

BOOL ChangeClipboardChain(HWND hWndNewNext) throw();

Hinweise

Siehe ChangeClipboardChain im Windows SDK.

CWindow::CheckDlgButton

Ändert den Prüfstatus der angegebenen Schaltfläche.

BOOL CheckDlgButton(int nIDButton, UINT nCheck) throw();

Hinweise

Siehe CheckDlgButton im Windows SDK.

CWindow::CheckRadioButton

Überprüft das angegebene Optionsfeld.

BOOL CheckRadioButton(
    int nIDFirstButton,
    int nIDLastButton,
    int nIDCheckButton) throw();

Hinweise

Siehe CheckRadioButton im Windows SDK.

CWindow::ChildWindowFromPoint

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

HWND ChildWindowFromPoint(POINT point) const throw();

Hinweise

Siehe ChildWindowFromPoint im Windows SDK.

CWindow::ChildWindowFromPointEx

Ruft einen bestimmten Typ des untergeordneten Fensters ab, das den angegebenen Punkt enthält.

HWND ChildWindowFromPoint(POINT point, UINT uFlags) const throw();

Hinweise

Siehe ChildWindowFromPointEx im Windows SDK.

CWindow::ClientToScreen

Konvertiert Clientkoordinaten in Bildschirmkoordinaten.

BOOL ClientToScreen(LPPOINT lpPoint) const throw();
BOOL ClientToScreen(LPRECT lpRect) const throw();

Hinweise

Siehe ClientToScreen im Windows SDK.

Mit der zweiten Version dieser Methode können Sie die Koordinaten einer RECT Struktur konvertieren.

CWindow::Create

Erstellt ein Fenster.

HWND Create(
    LPCTSTR lpstrWndClass,
    HWND hWndParent,
    _U_RECT rect = NULL,
    LPCTSTR szWindowName = NULL,
    DWORD dwStyle = 0,
    DWORD dwExStyle = 0,
    _U_MENUorID MenuOrID = 0U,
    LPVOID lpCreateParam = NULL) throw();

Parameter

lpstrWndClass
[in] Ein Zeiger auf die Klasse des Fensters.

hWndParent
[in] Das Handle für das übergeordnete Fenster oder das Besitzerfenster.

rect
[in] Eine Variable vom Typ _U_RECT , die die Position des Fensters angibt. Der Standardwert ist NULL. Wenn dieser Parameter lautet NULL, wird der Wert verwendet CWindow::rcDefault .

szWindowName
[in] Gibt den Namen des Fensters an. Der Standardwert ist NULL.

dwStyle
[in] Die Formatvorlage des Fensters. Der Standardwert ist 0, d. h., es wird keine Formatvorlage angegeben. Eine Liste der möglichen Werte finden Sie im CreateWindow Windows SDK.

dwExStyle
[in] Die Formatvorlage des erweiterten Fensters. Der Standardwert ist 0, d. h., es wird keine erweiterte Formatvorlage angegeben. Eine Liste der möglichen Werte finden Sie im CreateWindowEx Windows SDK.

MenuOrID
[in] Eine Variable vom Typ _U_MENUorID , die ein Handle für ein Menü oder einen Fensterbezeichner angibt. Der Standardwert ist 0U.

lpCreateParam
Ein Zeiger auf die Fenstererstellungsdaten, die in einer CREATESTRUCT Struktur enthalten sind.

Rückgabewert

Wenn dies erfolgreich ist, wird das Handle für das neu erstellte Fenster verwendet, das durch m_hWnd. Andernfalls NULL.

Hinweise

CWindow::rcDefault ist als __declspec(selectany) RECT CWindow::rcDefault = {CW_USEDEFAULT, CW_USEDEFAULT, 0, 0}; definiert.

Weitere Informationen finden Sie CreateWindow im Windows SDK.

Hinweis : Wenn 0 als Wert für den MenuOrID Parameter verwendet wird, muss er als 0U (Standardwert) angegeben werden, um einen Compilerfehler zu vermeiden.

CWindow::CreateCaret

Erstellt ein neues Shape für das System caret.

BOOL CreateCaret(HBITMAP pBitmap) throw();

Hinweise

Siehe CreateCaret im Windows SDK.

CWindow::CreateGrayCaret

Erstellt ein graues Rechteck für das System caret.

BOOL CreateGrayCaret(int nWidth, int nHeight) throw();

Hinweise

Siehe CreateCaret im Windows SDK.

Übergibt (HBITMAP) 1 den Bitmaphandleparameter an die Win32-Funktion.

CWindow::CreateSolidCaret

Erstellt ein einfarbiges Rechteck für das System caret.

BOOL CreateSolidCaret(int nWidth, int nHeight) throw();

Hinweise

Siehe CreateCaret im Windows SDK.

Übergibt (HBITMAP) 0 den Bitmaphandleparameter an die Win32-Funktion.

CWindow::CWindow

Der Konstruktor.

CWindow(HWND hWnd = NULL) throw();

Parameter

hWnd
[in] Der Ziehpunkt für ein Fenster.

Hinweise

Initialisiert das m_hWnd Element hWnd, das standardmäßig ist NULL.

CWindow::DeferWindowPos

Aktualisiert die angegebene Struktur mit mehreren Fenstern für das angegebene Fenster.

HDWP DeferWindowPos(
    HDWP hWinPosInfo,
    HWND hWndInsertAfter,
    int x,
    int y,
    int cx,
    int cy,
    UINT uFlags) throw();

Hinweise

Siehe DeferWindowPos im Windows SDK.

CWindow::DestroyWindow

Zerstört das fenster, das dem CWindow Objekt zugeordnet ist, und legt es m_hWnd fest auf NULL.

BOOL DestroyWindow() throw();

Hinweise

Siehe DestroyWindow im Windows SDK.

Das Objekt selbst wird nicht zerstört CWindow .

Beispiel

  //The following example attaches an HWND to the CWindow object and 
  //calls CWindow::DestroyWindow() to destroy the window

  CWindow myWindow;
  myWindow.Attach(hWndChild);
  //call the CWindow wrappers

  myWindow.DestroyWindow();
  hWndChild = NULL;

CWindow::Detach

Trennt m_hWnd vom Objekt und legt diesen m_hWnd wert fest auf NULLCWindow .

HWND Detach() throw();

Rückgabewert

Der HWND, der dem CWindow-Objekt zugeordnet ist.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//later detaches the CWindow object from the HWND when no longer needed

CWindow myWindow;
myWindow.Attach(hWnd);

//call CWindow wrappers

//We don't need the C++ object any more, so detach it from the HWND.
myWindow.Detach(); 

CWindow::DlgDirList

Füllt ein Listenfeld mit den Namen aller Dateien, die einem angegebenen Pfad oder Dateinamen entsprechen.

int DlgDirList(
    LPTSTR lpPathSpec,
    int nIDListBox,
    int nIDStaticPath,
    UINT nFileType) throw();

Hinweise

Siehe DlgDirList im Windows SDK.

CWindow::DlgDirListComboBox

Füllt ein Kombinationsfeld mit den Namen aller Dateien, die einem angegebenen Pfad oder Dateinamen entsprechen.

int DlgDirListComboBox(
    LPTSTR lpPathSpec,
    int nIDComboBox,
    int nIDStaticPath,
    UINT nFileType) throw();

Hinweise

Siehe DlgDirListComboBox im Windows SDK.

CWindow::DlgDirSelect

Ruft die aktuelle Auswahl aus einem Listenfeld ab.

BOOL DlgDirSelect(
    LPTSTR lpString,
    int nCount,
    int nIDListBox) throw();

Hinweise

Siehe DlgDirSelectEx im Windows SDK.

CWindow::DlgDirSelectComboBox

Ruft die aktuelle Auswahl aus einem Kombinationsfeld ab.

BOOL DlgDirSelectComboBox(
    LPTSTR lpString,
    int nCount,
    int nIDComboBox) throw();

Hinweise

Siehe DlgDirSelectComboBoxEx im Windows SDK.

CWindow::DragAcceptFiles

Registriert, ob das Fenster gezogene Dateien akzeptiert.

void DragAcceptFiles(BOOL bAccept = TRUE);

Hinweise

Siehe DragAcceptFiles im Windows SDK.

CWindow::DrawMenuBar

Zeichnen Sie die Menüleiste des Fensters neu.

BOOL DrawMenuBar() throw();

Hinweise

Siehe DrawMenuBar im Windows SDK.

CWindow::EnableScrollBar

Aktiviert oder deaktiviert die Bildlaufleistenpfeile.

BOOL EnableScrollBar(UINT uSBFlags, UINT uArrowFlags = ESB_ENABLE_BOTH) throw();

Hinweise

Siehe EnableScrollBar im Windows SDK.

CWindow::EnableWindow

Aktiviert oder deaktiviert Eingaben.

BOOL EnableWindow(BOOL bEnable = TRUE) throw();

Hinweise

Siehe EnableWindow im Windows SDK.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::EnableWindow() to enable and disable the window
//wrapped by the CWindow object

CWindow myWindow;
myWindow.Attach(hWnd);

//The following call enables the window 
//CWindow::EnableWindow() takes TRUE as the default parameter

myWindow.EnableWindow();

if(myWindow.IsWindowEnabled())
{
   //Do something now that the window is enabled

   //Now it's time to disable the window again
   myWindow.EnableWindow(FALSE);
}

CWindow::EndPaint

Markiert das Ende der Zeichnung.

void EndPaint(LPPAINTSTRUCT lpPaint) throw();

Hinweise

Siehe EndPaint im Windows SDK.

Beispiel

//The following example attaches an HWND to the CWindow object
//and calls CWindow::BeginPaint() and CWindow::EndPaint() in the 
// WM_PAINT handler of a CWindowImpl-derived class
LRESULT CMyCtrl::OnPaint(UINT /*uMsg*/, WPARAM /*wParam*/, LPARAM /*lParam*/, 
   BOOL& /*bHandled*/)
{
   CWindow myWindow;
   myWindow.Attach(m_hWnd);
   PAINTSTRUCT ps;
   HDC hDC  = myWindow.BeginPaint(&ps);
   //Use the hDC as much as you want
   ::Rectangle(hDC, 0, 0, 50, 50);

   myWindow.EndPaint(&ps);

   return 0;
}

CWindow::FlashWindow

Bringt das Fenster einmal zum Blinken.

BOOL FlashWindow(BOOL bInvert) throw();

Hinweise

Siehe FlashWindow im Windows SDK.

CWindow::GetClientRect

Ruft die Koordinaten des Clientbereichs ab.

BOOL GetClientRect(LPRECT lpRect) const throw();

Hinweise

Siehe GetClientRect im Windows SDK.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::GetClientRect() to get the client area rectangle
//of the window

CWindow myWindow;
myWindow.Attach(hWnd);
RECT rc;
myWindow.GetClientRect(&rc);

CWindow::GetDC

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

HDC GetDC() throw();

Hinweise

Siehe GetDC im Windows SDK.

Beispiel

// The following example attaches a HWND to the CWindow object,
// calls CWindow::GetDC to retrieve the DC of the client
// area of the window wrapped by CWindow Object, and calls
// CWindow::ReleaseDC to release the DC. 

CWindow myWindow;
myWindow.Attach(hWnd);   
HDC hDC = myWindow.GetDC();

// Use the DC

myWindow.ReleaseDC(hDC);
hDC = NULL;

CWindow::GetDCEx

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

HDC GetDCEx(HRGN hRgnClip, DWORD flags) throw();

Hinweise

Siehe GetDCEx im Windows SDK.

CWindow::GetDescendantWindow

Sucht das durch den angegebenen Bezeichner angegebene untergeordnete Fenster.

HWND GetDescendantWindow(int nID) const throw();

Parameter

nID
[in] Der Bezeichner des untergeordneten Fensters, das abgerufen werden soll.

Rückgabewert

Das Handle zu einem untergeordneten Fenster.

Hinweise

GetDescendantWindow durchsucht die gesamte Struktur untergeordneter Fenster, nicht nur die Fenster, die direkt untergeordnete Elemente sind.

CWindow::GetDlgControl

Rufen Sie diese Funktion auf, um einen Zeiger auf eine Schnittstelle eines ActiveX-Steuerelements abzurufen, das von einem zusammengesetzten Steuerelement oder einem Steuerelementhosting-Dialogfeld gehostet wird.

HRESULT GetDlgControl(
    int nID,
    REFIID iid,
    void** ppCtrl) throw();

Parameter

nID
[in] Die Ressourcen-ID des abzurufenden Steuerelements.

iid
[in] Die ID der Schnittstelle, die Sie aus dem Steuerelement abrufen möchten.

ppCtrl
[out] Der Zeiger auf die Schnittstelle.

Rückgabewert

Gibt bei Erfolg oder einem gültigen Fehler zurück S_OK HRESULT. Die Funktion gibt z. B. zurück E_FAIL , wenn das angegebene nID Steuerelement nicht gefunden werden kann, und es wird zurückgegeben E_NOINTERFACE , ob das Steuerelement gefunden werden kann, aber die durch iiddie angegebene Schnittstelle nicht unterstützt.

Hinweise

Mit diesem Zeiger können Sie Methoden auf der Schnittstelle aufrufen.

CWindow::GetDlgCtrlID

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

int GetDlgCtrlID() const throw();

Hinweise

Siehe GetDlgCtrlID im Windows SDK.

CWindow::GetDlgHost

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

HRESULT GetDlgHost(
    int nID,
    REFIID iid,
    void** ppHost) throw();

Parameter

nID
[in] Die Ressourcen-ID des abzurufenden Steuerelements.

iid
[in] Die ID der Schnittstelle, die Sie aus dem Steuerelement abrufen möchten.

ppHost
[out] Der Zeiger auf die Schnittstelle.

Rückgabewert

Gibt zurück S_OK , wenn das durch iid ein Steuerelementcontainer angegebene Fenster und die angeforderte Schnittstelle abgerufen werden kann. Gibt zurück E_FAIL , wenn das Fenster kein Steuerelementcontainer ist oder die angeforderte Schnittstelle nicht abgerufen werden konnte. Wenn ein Fenster mit der angegebenen ID nicht gefunden werden konnte, ist der Rückgabewert gleich HRESULT_FROM_WIN32(ERROR_CONTROL_ID_NOT_FOUND).

Hinweise

Mit diesem Zeiger können Sie Methoden auf der Schnittstelle aufrufen.

CWindow::GetDlgItem

Ruft das angegebene untergeordnete Fenster ab.

HWND GetDlgItem(int nID) const throw();

Hinweise

Siehe GetDlgItem im Windows SDK.

CWindow::GetDlgItemInt

Übersetzt den Text eines Steuerelements in eine ganze Zahl.

UINT GetDlgItemInt(
    int nID,
    BOOL* lpTrans = NULL,
    BOOL bSigned = TRUE) const throw();

Hinweise

Siehe GetDlgItemInt im Windows SDK.

CWindow::GetDlgItemText

Ruft den Text eines Steuerelements ab.

UINT GetDlgItemText(
    int nID,
    LPTSTR lpStr,
    int nMaxCount) const throw();

BOOL GetDlgItemText(
    int nID,
    BSTR& bstrText) const throw();

Hinweise

Weitere Informationen finden Sie im GetDlgItemText Windows SDK.

Mit der zweiten Version dieser Methode können Sie den Text des Steuerelements in einen BSTRkopieren. Diese Version gibt zurück TRUE , wenn der Text erfolgreich kopiert wurde; andernfalls FALSE.

CWindow::GetExStyle

Ruft die Formatvorlagen des erweiterten Fensters des Fensters ab.

DWORD GetExStyle() const throw();

Rückgabewert

Die erweiterten Formatvorlagen des Fensters.

Hinweise

Rufen Sie auf, um GetStyledie normalen Fensterformatvorlagen abzurufen.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::GetExStyle() to retrieve the extended styles of 
//the window

CWindow myWindow;
myWindow.Attach(hWnd);
DWORD dwExStyles = myWindow.GetExStyle();

CWindow::GetFont

Ruft die aktuelle Schriftart des Fensters ab, indem eine WM_GETFONT Nachricht an das Fenster gesendet wird.

HFONT GetFont() const throw();

Rückgabewert

Ein Schriftarthandle.

CWindow::GetHotKey

Bestimmt die dem Fenster zugeordnete Hot Key durch Senden einer WM_GETHOTKEY Nachricht.

DWORD GetHotKey() const throw();

Rückgabewert

Der virtuelle Schlüsselcode und Die Modifizierer für den hot key, der dem Fenster zugeordnet ist. Eine Liste der möglichen Modifizierer finden Sie im WM_GETHOTKEY Windows SDK. Eine Liste der standardmäßigen virtuellen Schlüsselcodes finden Sie unter Winuser.h.

CWindow::GetIcon

Ruft den Ziehpunkt zum großen oder kleinen Symbol des Fensters ab.

HICON GetIcon(BOOL bBigIcon = TRUE) const;

Parameter

bBigIcon
[in] Wenn TRUE (der Standardwert) die Methode das große Symbol zurückgibt. Andernfalls wird das kleine Symbol zurückgegeben.

Rückgabewert

Ein Symbolziehpunkt.

Hinweise

GetIcon sendet eine WM_GETICON Nachricht an das Fenster.

CWindow::GetLastActivePopup

Ruft das zuletzt aktive Popupfenster ab.

HWND GetLastActivePopup() const throw();

Hinweise

Siehe GetLastActivePopup im Windows SDK.

CWindow::GetMenu

Ruft das Menü des Fensters ab.

HMENU GetMenu() const throw();

Hinweise

Siehe GetMenu im Windows SDK.

CWindow::GetNextDlgGroupItem

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

HWND GetNextDlgGroupItem(HWND hWndCtl, BOOL bPrevious = FALSE) const throw();

Hinweise

Siehe GetNextDlgGroupItem im Windows SDK.

CWindow::GetNextDlgTabItem

Ruft das vorherige oder nächste Steuerelement mit der WS_TABSTOP Formatvorlage ab.

HWND GetNextDlgTabItem(HWND hWndCtl, BOOL bPrevious = FALSE) const throw();

Hinweise

Siehe GetNextDlgTabItem im Windows SDK.

CWindow::GetParent

Ruft das direkt übergeordnete Fenster ab.

HWND GetParent() const throw();

Hinweise

Siehe GetParent im Windows SDK.

Beispiel

// The following example attaches a HWND to the CWindow object
// and calls CWindow::GetParent to find out the parent
// window of the window wrapped by CWindow object.

CWindow myWindow;
myWindow.Attach(hWnd);   
HWND hWndParent = myWindow.GetParent();

CWindow::GetScrollInfo

Ruft die Parameter einer Bildlaufleiste ab.

BOOL GetScrollInfo(int nBar, LPSCROLLINFO lpScrollInfo) throw();

Hinweise

Siehe GetScrollInfo im Windows SDK.

CWindow::GetScrollPos

Ruft die Position des Bildlauffelds ab.

int GetScrollPos(int nBar) const throw();

Hinweise

Siehe GetScrollPos im Windows SDK.

CWindow::GetScrollRange

Ruft den Bereich der Bildlaufleiste ab.

BOOL GetScrollRange(
    int nBar,
    LPINT lpMinPos,
    LPINT lpMaxPos) const throw();

Hinweise

Siehe GetScrollRange im Windows SDK.

CWindow::GetStyle

Ruft die Fensterformatvorlagen des Fensters ab.

DWORD GetStyle() const throw();

Rückgabewert

Die Formatvorlagen des Fensters.

Hinweise

Rufen Sie auf, um GetExStyledie Formatvorlagen des erweiterten Fensters abzurufen.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::GetStyle() to retrieve the styles of the window

CWindow myWindow;
myWindow.Attach(hWnd);
DWORD dwStyles = myWindow.GetStyle();

CWindow::GetSystemMenu

Erstellt eine Kopie des Systemmenüs zur Änderung.

HMENU GetSystemMenu(BOOL bRevert) const throw();

Hinweise

Siehe GetSystemMenu im Windows SDK.

CWindow::GetTopLevelParent

Ruft das übergeordnete Fenster der obersten Ebene des Fensters ab.

HWND GetTopLevelParent() const throw();

Rückgabewert

Das Handle zum übergeordneten Fenster der obersten Ebene.

CWindow::GetTopLevelWindow

Ruft das übergeordnete oder Besitzerfenster des Fensters der obersten Ebene ab.

HWND GetTopLevelWindow() const throw();

Rückgabewert

Das Handle für das Besitzerfenster der obersten Ebene.

CWindow::GetTopWindow

Ruft das untergeordnete Fenster der obersten Ebene ab.

HWND GetTopWindow() const throw();

Hinweise

Siehe GetTopWindow im Windows SDK.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::GetTopWindow() to get the top-level child window

CWindow myWindow;
myWindow.Attach(hWnd);
HWND hWndFavoriteChild = myWindow.GetTopWindow();

CWindow::GetUpdateRect

Ruft die Koordinaten des kleines Rechtecks ab, das die -Aktualisierungsregion komplett umschließt.

BOOL GetUpdateRect(LPRECT lpRect, BOOL bErase = FALSE) throw();

Hinweise

Siehe GetUpdateRect im Windows SDK.

CWindow::GetUpdateRgn

Ruft den Aktualisierungsbereich ab und kopiert ihn in einen angegebenen Bereich.

int GetUpdateRgn(HRGN hRgn, BOOL bErase = FALSE) throw();

Hinweise

Siehe GetUpdateRgn im Windows SDK.

CWindow::GetWindow

Ruft das angegebene Fenster ab.

HWND GetWindow(UINT nCmd) const throw();

Hinweise

Siehe GetWindow im Windows SDK.

CWindow::GetWindowContextHelpId

Ruft den Hilfekontextbezeichner des Fensters ab.

DWORD GetWindowContextHelpId() const throw();

Hinweise

Siehe GetWindowContextHelpId im Windows SDK.

CWindow::GetWindowDC

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

HDC GetWindowDC() throw();

Hinweise

Siehe GetWindowDC im Windows SDK.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::GetWindowDC() to retrieve the DC of the entire window

CWindow myWindow;
myWindow.Attach(hWnd);
HDC hDC = myWindow.GetWindowDC();

CWindow::GetWindowLong

Ruft einen 32-Bit-Wert bei einem angegebenen Offset in den zusätzlichen Fensterspeicher ab.

LONG GetWindowLong(int nIndex) const throw();

Hinweise

Siehe GetWindowLong im Windows SDK.

CWindow::GetWindowLongPtr

Ruft Informationen zum angegebenen Fenster ab, einschließlich eines Werts bei einem angegebenen Offset im zusätzlichen Fensterspeicher.

LONG_PTR GetWindowLongPtr(int nIndex) const throw();

Hinweise

Weitere Informationen finden Sie im GetWindowLongPtr Windows SDK.

Wenn Sie einen Zeiger oder ein Handle abrufen, ersetzt diese Funktion die CWindow::GetWindowLong Methode.

Verwenden Sie CWindow::GetWindowLongPtrzum Schreiben von Code, der sowohl mit 32-Bit- als auch mit 64-Bit-Versionen von Windows kompatibel ist.

CWindow::GetWindowPlacement

Ruft den Anzeigezustand und die Positionen ab.

BOOL GetWindowPlacement(WINDOWPLACEMENT FAR* lpwndpl) const throw();

Hinweise

Siehe GetWindowPlacement im Windows SDK.

CWindow::GetWindowProcessID

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

DWORD GetWindowProcessID() throw();

Hinweise

Siehe GetWindowThreadProcessID im Windows SDK.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::GetWindowProcessID() to retrieve the id of the 
//process that created the window

CWindow myWindow;
myWindow.Attach(hWnd);
DWORD dwID = myWindow.GetWindowProcessID();

CWindow::GetWindowRect

Ruft die Begrenzungsmaße des Fensters ab.

BOOL GetWindowRect(LPRECT lpRect) const throw();

Hinweise

Siehe GetWindowRect im Windows SDK.

CWindow::GetWindowRgn

Ruft eine Kopie des Fensterbereichs eines Fensters ab.

int GetWindowRgn(HRGN hRgn) throw();

Hinweise

Siehe GetWindowRgn im Windows SDK.

CWindow::GetWindowText

Ruft den Text des Fensters ab.

int GetWindowText(LPTSTR lpszStringBuf, int nMaxCount) const throw();
BOOL GetWindowText(BSTR& bstrText) throw();
int GetWindowText(CSimpleString& strText) const;

Parameter

lpszStringBuf
Ein Puffer, in den der Fenstertext geschrieben wird.

nMaxCount
Die Größe des Puffers in Zeichen. Außerdem die maximale Anzahl der zu schreibenden Zeichen.

bstrText
Ein BSTR-Element zum Speichern des Fenstertexts.

strText
Ein CString-Element zum Speichern des Fenstertexts.

Rückgabewert

Wenn der Text erfolgreich kopiert wird, lautet TRUEder Rückgabewert ; andernfalls lautet FALSEder Rückgabewert .

Hinweise

Siehe GetWindowText im Windows SDK.

Mit der zweiten Version dieser Methode können Sie den Text in einer BSTR; die dritte Version ermöglicht es Ihnen, das Ergebnis in einem CString, da CSimpleString die Basisklasse von CString.

CWindow::GetWindowTextLength

Ruft die Länge des Fenstertexts ab.

int GetWindowTextLength() const throw();

Hinweise

Siehe GetWindowTextLength im Windows SDK.

CWindow::GetWindowThreadID

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

DWORD GetWindowThreadID() throw();

Hinweise

Siehe GetWindowThreadProcessID im Windows SDK.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::GetWindowThreadID() to retrieve the id of the thread 
//that created the window

CWindow myWindow;
myWindow.Attach(hWnd);
DWORD dwID = myWindow.GetWindowThreadID();

CWindow::GetWindowWord

Ruft einen 16-Bit-Wert bei einem angegebenen Offset im zusätzlichen Fensterspeicher ab.

WORD GetWindowWord(int nIndex) const throw();

Hinweise

Siehe GetWindowLong im Windows SDK.

CWindow::GotoDlgCtrl

Legt den Tastaturfokus auf ein Steuerelement im Dialogfeld fest.

void GotoDlgCtrl(HWND hWndCtrl) const throw();

Hinweise

Siehe WM_NEXTDLGCTL im Windows SDK.

CWindow::HideCaret

Blendet das System caret aus.

BOOL HideCaret() throw();

Hinweise

Siehe HideCaret im Windows SDK.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::HideCaret() to hide the caret of the window owning 
//the caret

CWindow myWindow;
myWindow.Attach(hWndEdit);
myWindow.HideCaret();

CWindow::HiliteMenuItem

Hebt hervor oder entfernt die Hervorhebung aus einem Menüelement der obersten Ebene.

BOOL HiliteMenuItem(
    HMENU hMenu,
    UINT uHiliteItem,
    UINT uHilite) throw();

Hinweise

Siehe HiliteMenuItem im Windows SDK.

CWindow::Invalidate

Macht den gesamten Clientbereich ungültig.

BOOL Invalidate(BOOL bErase = TRUE) throw();

Hinweise

Siehe InvalidateRect im Windows SDK.

Übergibt NULL den RECT Parameter an die InvalidateRect Win32-Funktion.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::Invalidate() to invalidate the entire client area

CWindow myWindow;
myWindow.Attach(hWnd);
myWindow.Invalidate();

CWindow::InvalidateRect

Ungültig wird der Clientbereich innerhalb des angegebenen Rechtecks.

BOOL InvalidateRect(LPCRECT lpRect, BOOL bErase = TRUE) throw();

Hinweise

Siehe InvalidateRect im Windows SDK.

CWindow::InvalidateRgn

Ungültig wird der Clientbereich innerhalb des angegebenen Bereichs.

void InvalidateRgn(HRGN hRgn, BOOL bErase = TRUE) throw();

Hinweise

Weitere Informationen finden Sie im InvalidateRgn Windows SDK.

Gibt einen void Rückgabetyp an, während die InvalidateRgn Win32-Funktion immer zurückgegeben wird TRUE.

CWindow::IsChild

Bestimmt, ob das angegebene Fenster ein untergeordnetes Fenster ist.

BOOL IsChild(const HWND hWnd) const throw();

Hinweise

Siehe IsChild im Windows SDK.

CWindow::IsDialogMessage

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

BOOL IsDialogMessage(LPMSG lpMsg) throw();

Hinweise

Siehe IsDialogMessage im Windows SDK.

CWindow::IsDlgButtonChecked

Bestimmt den Überprüfungsstatus der Schaltfläche.

UINT IsDlgButtonChecked(int nIDButton) const throw();

Hinweise

Siehe IsDlgButtonChecked im Windows SDK.

CWindow::IsIconic

Bestimmt, ob das Fenster minimiert ist.

BOOL IsIconic() const throw();

Hinweise

Siehe IsIconic im Windows SDK.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::IsIconic() to determine if the window is minimized

CWindow myWindow;
myWindow.Attach(hWnd);
BOOL bIconic = myWindow.IsIconic();

CWindow::IsParentDialog

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

BOOL IsParentDialog() throw();

Rückgabewert

Gibt zurück TRUE , wenn das übergeordnete Fenster ein Dialogfeld ist, FALSE andernfalls.

CWindow::IsWindow

Bestimmt, ob der angegebene Fensterziehpunkt ein vorhandenes Fenster identifiziert.

BOOL IsWindow() throw();

Hinweise

Siehe IsWindow im Windows SDK.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::IsWindow() to verify if the HWND corresponds 
//to an existing window

CWindow myWindow;
myWindow.Attach(hWnd);
BOOL bWindow = myWindow.IsWindow();

CWindow::IsWindowEnabled

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

BOOL IsWindowEnabled() const throw();

Hinweise

Siehe IsWindowEnabled im Windows SDK.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::IsWindowEnabled() to verify if the window is enabled 
//for receiving input

CWindow myWindow;
myWindow.Attach(hWnd);
BOOL bEnabled = myWindow.IsWindowEnabled();

CWindow::IsWindowVisible

Bestimmt den Sichtbarkeitszustand des Fensters.

BOOL IsWindowVisible() const throw();

Hinweise

Siehe IsWindowVisible im Windows SDK.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::IsWindowVisible() to determine the visibility state 
//of the window

CWindow myWindow;
myWindow.Attach(hWnd);
BOOL bVisible = myWindow.IsWindowVisible();

CWindow::IsWindowUnicode

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

BOOL IsWindowUnicode() throw();

Hinweise

Siehe IsWindowUnicode im Windows SDK.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::IsWindowUnicode() to determine if the window is a 
//UNICODE window or an ANSI one.

CWindow myWindow;
myWindow.Attach(hWnd);
BOOL bUnicode = myWindow.IsWindowUnicode();

CWindow::IsZoomed

Bestimmt, ob das Fenster maximiert ist.

BOOL IsZoomed() const throw();

Hinweise

Siehe IsZoomed im Windows SDK.

CWindow::KillTimer

Zerstört ein timer-Ereignis, das von CWindow::SetTimer.

BOOL KillTimer(UINT nIDEvent) throw();

Hinweise

Siehe KillTimer im Windows SDK.

CWindow::LockWindowUpdate

Deaktiviert oder aktiviert das Zeichnen im Fenster durch Aufrufen der LockWindowUpdate Win32-Funktion.

BOOL LockWindowUpdate(BOOL bLock = TRUE) throw();

Parameter

bLock
[in] Wenn TRUE (der Standardwert) wird das Fenster gesperrt. Andernfalls wird sie entsperrt.

Rückgabewert

TRUEwenn das Fenster erfolgreich gesperrt ist; andernfalls . FALSE

Hinweise

Ist bLock dies TRUEder Fall, wird diese Methode an die Win32-Funktion übergeben m_hWnd . Andernfalls wird sie übergeben NULL.

CWindow::m_hWnd

Enthält ein Handle für das Fenster, das dem CWindow Objekt zugeordnet ist.

HWND m_hWnd throw() throw();

CWindow::MapWindowPoints

Konvertiert eine Reihe von Punkten aus dem Koordinatenbereich des Fensters in den Koordinatenbereich eines anderen Fensters.

int MapWindowPoints(
    HWND hWndTo,
    LPPOINT lpPoint,
    UINT nCount) const throw();

int MapWindowPoints(
    HWND hWndTo,
    LPRECT lpRect) const throw();

Hinweise

Siehe MapWindowPoints im Windows SDK.

Mit der zweiten Version dieser Methode können Sie die Koordinaten einer RECT Struktur konvertieren.

CWindow::MessageBox

Zeigt ein Meldungsfeld an.

int MessageBox(
    LPCTSTR lpszText,
    LPCTSTR lpszCaption = NULL,
    UINT nType = MB_OK) throw();

Hinweise

Siehe MessageBox im Windows SDK.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::MessageBox() to pop up a Windows message box

CWindow myWindow;
myWindow.Attach(hWnd);
myWindow.MessageBox(_T("Hello World"));

CWindow::ModifyStyle

Ändert die Fensterformatvorlagen des CWindow Objekts.

BOOL ModifyStyle(
    DWORD dwRemove,
    DWORD dwAdd,
    UINT nFlags = 0) throw();

Parameter

dwRemove
[in] Gibt die Fensterformatvorlagen an, die während der Formatvorlagenänderung entfernt werden sollen.

dwAdd
[in] Gibt die Fensterformatvorlagen an, die während der Formatvorlagenänderung hinzugefügt werden sollen.

nFlags
[in] Fensterpositionierungskennzeichnungen. Eine Liste der möglichen Werte finden Sie in der SetWindowPos Funktion im Windows SDK.

Rückgabewert

TRUEwenn die Fensterformatvorlagen geändert werden; andernfalls . FALSE

Hinweise

Formatvorlagen, die hinzugefügt oder entfernt werden sollen, können mit dem bitweisen Operator "oder" (|) kombiniert werden. Informationen zu den verfügbaren Fensterformatvorlagen finden Sie in der Windows-SDK unter der Funktion.See the CreateWindow function in the Windows SDKfor information about the available window styles.

Wenn nFlags "nonzero" ist, ModifyStyle wird die Win32-Funktion SetWindowPosaufgerufen, und das Fenster wird neu gezeichnet, indem es mit den folgenden vier Flags kombiniert nFlags wird:

• SWP_NOSIZE Behält die aktuelle Größe bei.

• SWP_NOMOVE Behält die aktuelle Position bei.

• SWP_NOZORDER Behält die aktuelle Z-Reihenfolge bei.

• SWP_NOACTIVATE Aktiviert das Fenster nicht.

Rufen Sie auf ModifyStyleEx, um die erweiterten Formatvorlagen eines Fensters zu ändern.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::ModifyStyle() to add and remove the window styles

CWindow myWindow;
myWindow.Attach(hWnd);

//The following line removes the WS_CLIPCHILDREN style from the 
//window and adds the WS_CAPTION style to the window
myWindow.ModifyStyle(WS_CLIPCHILDREN, WS_CAPTION);

CWindow::ModifyStyleEx

Ändert die Formatvorlagen des erweiterten Fensters des CWindow Objekts.

BOOL ModifyStyleEx(
    DWORD dwRemove,
    DWORD dwAdd,
    UINT nFlags = 0) throw();

Parameter

dwRemove
[in] Gibt die erweiterten Formatvorlagen an, die während der Änderung der Formatvorlage entfernt werden sollen.

dwAdd
[in] Gibt die erweiterten Formatvorlagen an, die während der Änderung der Formatvorlage hinzugefügt werden sollen.

nFlags
[in] Fensterpositionierungskennzeichnungen. Eine Liste der möglichen Werte finden Sie in der SetWindowPos Funktion im Windows SDK.

Rückgabewert

TRUEwenn die Formatvorlagen für erweiterte Fenster geändert werden; andernfalls . FALSE

Hinweise

Formatvorlagen, die hinzugefügt oder entfernt werden sollen, können mit dem bitweisen Operator "oder" (|) kombiniert werden. Informationen zu den verfügbaren erweiterten Formatvorlagen finden Sie in der CreateWindowEx Funktion im Windows SDK.

Wenn nFlags "nonzero" ist, ModifyStyleEx wird die Win32-Funktion SetWindowPosaufgerufen, und das Fenster wird neu gezeichnet, indem es mit den folgenden vier Flags kombiniert nFlags wird:

• SWP_NOSIZE Behält die aktuelle Größe bei.

• SWP_NOMOVE Behält die aktuelle Position bei.

• SWP_NOZORDER Behält die aktuelle Z-Reihenfolge bei.

• SWP_NOACTIVATE Aktiviert das Fenster nicht.

Rufen Sie auf, um ModifyStyleFenster mit normalen Fensterformatvorlagen zu ändern.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::ModifyStyleEx() to add and remove the extended 
//window styles

CWindow myWindow;
myWindow.Attach(hWnd);

//The following line removes WS_EX_CONTEXTHELP extended style from 
//the window and adds WS_EX_TOOLWINDOW extended style to the window 

myWindow.ModifyStyleEx(WS_EX_CONTEXTHELP, WS_EX_TOOLWINDOW);

CWindow::MoveWindow

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

BOOL MoveWindow(
    int x,
    int y,
    int nWidth,
    int nHeight,
    BOOL bRepaint = TRUE) throw();

BOOL MoveWindow(
    LPCRECT lpRect,
    BOOL bRepaint = TRUE) throw();

Hinweise

Bei einem Fensterobjekt auf oberster Ebene sind die x Parameter y relativ zur oberen linken Ecke des Bildschirms. Bei einem untergeordneten Fensterobjekt sind sie relativ zur oberen linken Ecke des Clientbereichs des übergeordneten Fensters.

Die zweite Version dieser Methode verwendet eine RECT Struktur, um die neue Position, Breite und Höhe des Fensters zu bestimmen.

CWindow::NextDlgCtrl

Legt den Tastaturfokus auf das nächste Steuerelement im Dialogfeld fest.

void NextDlgCtrl() const throw();

Hinweise

Siehe WM_NEXTDLGCTL im Windows SDK.

CWindow::OpenClipboard

Öffnet die Zwischenablage.

BOOL OpenClipboard() throw();

Hinweise

Siehe OpenClipboard im Windows SDK.

CWindow::operator HWND

Konvertiert ein CWindow Objekt in ein HWND.

operator HWND() const throw();

CWindow::operator =

Weist dem Objekt ein HWND Objekt zu, indem das m_hWnd Element auf hWnd.CWindow

CWindow& operator= (HWND hWnd) throw();

CWindow::PostMessage

Platziert eine Nachricht in der Nachrichtenwarteschlange, die dem Thread zugeordnet ist, in dem das Fenster erstellt wurde.

BOOL PostMessage(
    UINT message,
    WPARAM wParam = 0,
    LPARAM lParam = 0) throw();

Hinweise

Siehe PostMessage im Windows SDK.

Gibt zurück, ohne darauf zu warten, dass der Thread die Nachricht verarbeitet.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//posts a WM_PAINT message to the Window wrapped by the CWindow object 
//using CWindow::PostMessage() with the default values of WPARAM and 
//LPARAM

CWindow myWindow;
myWindow.Attach(hWnd);
myWindow.PostMessage(WM_PAINT);

CWindow::PrevDlgCtrl

Legt den Tastaturfokus auf das vorherige Steuerelement im Dialogfeld fest.

void PrevDlgCtrl() const throw();

Hinweise

Siehe WM_NEXTDLGCTL im Windows SDK.

CWindow::Print

Sendet eine WM_PRINT Nachricht an das Fenster, um anzufordern, dass es sich selbst im angegebenen Gerätekontext zeichnet.

void Print(HDC hDC, DWORD dwFlags) const throw();

Parameter

hDC
[in] Das Handle für einen Gerätekontext.

dwFlags
[in] Gibt die Zeichnungsoptionen an. Sie können eine oder mehrere der folgenden Flags kombinieren:

• PRF_CHECKVISIBLE Zeichnen Sie das Fenster nur, wenn es sichtbar ist.

• PRF_CHILDREN Zeichnen Sie alle sichtbaren untergeordneten Fenster.

• PRF_CLIENT Zeichnen Sie den Clientbereich des Fensters.

• PRF_ERASEBKGND Löschen Sie den Hintergrund, bevor Sie das Fenster zeichnen.

• PRF_NONCLIENT Zeichnen Sie den Nicht-Clientbereich des Fensters.

• PRF_OWNED Zeichnen Sie alle eigenen Fenster.

CWindow::PrintClient

Sendet eine WM_PRINTCLIENT Nachricht an das Fenster, um anzufordern, dass der Clientbereich im angegebenen Gerätekontext gezeichnet wird.

void PrintClient(HDC hDC, DWORD dwFlags) const throw();

Parameter

hDC
[in] Das Handle für einen Gerätekontext.

dwFlags
[in] Gibt Zeichnungsoptionen an. Sie können eine oder mehrere der folgenden Flags kombinieren:

• PRF_CHECKVISIBLE Zeichnen Sie das Fenster nur, wenn es sichtbar ist.

• PRF_CHILDREN Zeichnen Sie alle sichtbaren untergeordneten Fenster.

• PRF_CLIENT Zeichnen Sie den Clientbereich des Fensters.

• PRF_ERASEBKGND Löschen Sie den Hintergrund, bevor Sie das Fenster zeichnen.

• PRF_NONCLIENT Zeichnen Sie den Nicht-Clientbereich des Fensters.

• PRF_OWNED Zeichnen Sie alle eigenen Fenster.

CWindow::rcDefault

Enthält Standardfensterabmessungen.

static RECT rcDefault;

CWindow::RedrawWindow

Aktualisiert ein angegebenes Rechteck oder eine angegebene Region im Clientbereich.

BOOL RedrawWindow(
    LPCRECT lpRectUpdate = NULL,
    HRGN hRgnUpdate = NULL,
    UINT flags = RDW_INVALIDATE | RDW_UPDATENOW | RDW_ERASE);

throw()

Hinweise

Siehe RedrawWindow im Windows SDK.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::RedrawWindow() to update the entire window using the 
//default arguments

CWindow myWindow;
myWindow.Attach(hWnd);
BOOL bRedrawn = myWindow.RedrawWindow();

CWindow::ReleaseDC

Gibt einen Gerätekontext frei.

int ReleaseDC(HDC hDC);

Hinweise

Siehe ReleaseDC im Windows SDK.

Beispiel

// The following example attaches a HWND to the CWindow object,
// calls CWindow::GetDC to retrieve the DC of the client
// area of the window wrapped by CWindow Object, and calls
// CWindow::ReleaseDC to release the DC. 

CWindow myWindow;
myWindow.Attach(hWnd);   
HDC hDC = myWindow.GetDC();

// Use the DC

myWindow.ReleaseDC(hDC);
hDC = NULL;

CWindow::ResizeClient

Ändert die Größe des Fensters auf die angegebene Clientbereichsgröße.

BOOL ResizeClient(
    int nWidth,
    int nHeight,
    BOOL bRedraw = FALSE) throw();

Parameter

nWidth
Neue Breite des Fensters in Pixeln.

nHeight
Neue Höhe des Fensters in Pixeln.

bRedraw
Ein Kennzeichen, das angibt, ob Änderungen neu gezeichnet werden sollen. Der Standardwert ist FALSE, der angibt, dass das Fenster keine Änderungen neu zeichnet.

CWindow::ScreenToClient

Konvertiert Bildschirmkoordinaten in Clientkoordinaten.

BOOL ScreenToClient(LPPOINT lpPoint) const throw();
BOOL ScreenToClient(LPRECT lpRect) const throw();

Hinweise

Siehe ScreenToClient im Windows SDK.

Mit der zweiten Version dieser Methode können Sie die Koordinaten einer RECT Struktur konvertieren.

CWindow::ScrollWindow

Scrollt den angegebenen Clientbereich.

BOOL ScrollWindow(
    int xAmount,
    int yAmount,
    LPCRECT lpRect = NULL,
    LPCRECT lpClipRect = NULL) throw();

Hinweise

Siehe ScrollWindow im Windows SDK.

CWindow::ScrollWindowEx

Scrollt den angegebenen Clientbereich mit zusätzlichen Features.

int ScrollWindowEx(
    int dx,
    int dy,
    LPCRECT lpRectScroll,
    LPCRECT lpRectClip,
    HRGN hRgnUpdate,
    LPRECT lpRectUpdate,
    UINT flags) throw();

Hinweise

Siehe ScrollWindowEx im Windows SDK.

CWindow::SendDlgItemMessage

Sendet eine Nachricht an ein Steuerelement.

LRESULT SendDlgItemMessage(
    int nID,
    UINT message,
    WPARAM wParam = 0,
    LPARAM lParam = 0) throw();

Hinweise

Siehe SendDlgItemMessage im Windows SDK.

CWindow::SendMessage

Sendet eine Nachricht an das Fenster und gibt erst zurück, wenn die Fensterprozedur die Nachricht verarbeitet hat.

LRESULT SendMessage(
    UINT message,
    WPARAM wParam = 0,
    LPARAM lParam = 0) throw();

static LRESULT SendMessage(
    HWND hWnd,
    UINT message,
    WPARAM wParam,
    LPARAM lParam) throw();

Hinweise

Siehe SendMessage im Windows SDK.

Beispiel

// The following example attaches a HWND to the CWindow
// object and sends a WM_PAINT message to the window
// wrapped by CWindow object using CWindow::SendMessage.

CWindow myWindow;
myWindow.Attach(hWnd);   
myWindow.SendMessage(WM_PAINT, 0L, 0L);

CWindow::SendMessageToDescendants

Sendet die angegebene Nachricht an alle unmittelbaren untergeordneten Elemente des CWindow Objekts.

void SendMessageToDescendants(
    UINT message,
    WPARAM wParam = 0,
    LPARAM lParam = 0,
    BOOL bDeep = TRUE) throw();

Parameter

message
[in] Die zu sendende Nachricht.

wParam
[in] Zusätzliche nachrichtenspezifische Informationen.

lParam
[in] Zusätzliche nachrichtenspezifische Informationen.

bDeep
[in] Wenn TRUE (Der Standardwert) wird die Nachricht an alle untergeordneten Fenster gesendet. Andernfalls wird sie nur an die unmittelbaren untergeordneten Fenster gesendet.

Hinweise

Wenn bDeep ja TRUE, wird die Nachricht zusätzlich an alle anderen untergeordneten Fenster gesendet.

CWindow::SendNotifyMessage

Sendet eine Nachricht an das Fenster.

BOOL SendNotifyMessage(
    UINT message,
    WPARAM wParam = 0,
    LPARAM lParam = 0) throw();

Hinweise

Siehe SendNotifyMessage im Windows SDK.

Wenn das Fenster vom aufrufenden Thread erstellt wurde, wird erst zurückgegeben, SendNotifyMessage wenn die Fensterprozedur die Nachricht verarbeitet hat. Andernfalls wird sie sofort zurückgegeben.

CWindow::SetActiveWindow

Aktiviert das Fenster.

HWND SetActiveWindow() throw();

Hinweise

Siehe SetActiveWindow im Windows SDK.

Beispiel

// The following example attaches a HWND to the CWindow object
// and sets the window as an active window by calling 
// CWindow::SetActiveWindow which returns the HWND of the
// previously active window.

CWindow myWindow;
myWindow.Attach(hWnd);   
HWND hWndPrev = myWindow.SetActiveWindow();

CWindow::SetCapture

Sendet alle nachfolgenden Mauseingaben an das Fenster.

HWND SetCapture() throw();

Hinweise

Siehe SetCapture im Windows SDK.

CWindow::SetClipboardViewer

Fügt das Fenster zur Viewerkette der Zwischenablage hinzu.

HWND SetClipboardViewer() throw();

Hinweise

Siehe SetClipboardViewer im Windows SDK.

CWindow::SetDlgCtrlID

Legt den Bezeichner des Fensters auf den angegebenen Wert fest.

int SetDlgCtrlID(int nID) throw();

Parameter

nID
[in] Der neue Wert, der für den Bezeichner des Fensters festgelegt werden soll.

Rückgabewert

Wenn dies erfolgreich ist, ist der vorherige Bezeichner des Fensters; andernfalls 0.

CWindow::SetDlgItemInt

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

BOOL SetDlgItemInt(
    int nID,
    UINT nValue,
    BOOL bSigned = TRUE) throw();

Hinweise

Siehe SetDlgItemInt im Windows SDK.

CWindow::SetDlgItemText

Ändert den Text eines Steuerelements.

BOOL SetDlgItemText(int nID, LPCTSTR lpszString) throw();

Hinweise

Siehe SetDlgItemText im Windows SDK.

CWindow::SetFocus

Legt den Eingabefokus auf das Fenster fest.

HWND SetFocus() throw();

Hinweise

Siehe SetFocus im Windows SDK.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::SetFocus() to set the input focus

CWindow myWindow;
myWindow.Attach(hWnd);
HWND hWndLeftFocus = myWindow.SetFocus();

CWindow::SetFont

Ändert die aktuelle Schriftart des Fensters, indem eine WM_SETFONT Nachricht an das Fenster gesendet wird.

void SetFont(HFONT hFont, BOOL bRedraw = TRUE) throw();

Parameter

hFont
[in] Der Ziehpunkt für die neue Schriftart.

bRedraw
[in] Wenn TRUE (Der Standardwert) wird das Fenster neu gezeichnet. Andernfalls ist dies nicht der Fehler.

CWindow::SetHotKey

Ordnet dem Fenster eine Abkürzungstaste zu, indem eine WM_SETHOTKEY Nachricht gesendet wird.

int SetHotKey(WORD wVirtualKeyCode, WORD wModifiers) throw();

Parameter

wVirtualKeyCode
[in] Der virtuelle Schlüsselcode des Hot Keys. Eine Liste der standardmäßigen virtuellen Schlüsselcodes finden Sie unter Winuser.h.

wModifiers
[in] Die Modifizierer der Abkürzungstaste. Eine Liste der möglichen Werte finden Sie im WM_SETHOTKEY Windows SDK.

Rückgabewert

Eine Liste der möglichen Rückgabewerte finden Sie im WM_SETHOTKEY Windows SDK.

CWindow::SetIcon

Legt das große oder kleine Symbol des Fensters auf das durch hIcon.

HICON SetIcon(HICON hIcon, BOOL bBigIcon = TRUE) throw();

Parameter

hIcon
[in] Der Ziehpunkt zu einem neuen Symbol.

bBigIcon
[in] If TRUE (the default value), the method sets a large icon. Andernfalls wird ein kleines Symbol festgelegt.

Rückgabewert

Der Ziehpunkt zum vorherigen Symbol.

Hinweise

SetIcon sendet eine WM_SETICON Nachricht an das Fenster.

CWindow::SetMenu

Ändert das aktuelle Menü des Fensters.

BOOL SetMenu(HMENU hMenu) throw();

Hinweise

Siehe SetMenu im Windows SDK.

CWindow::SetParent

Ändert das übergeordnete Fenster.

HWND SetParent(HWND hWndNewParent) throw();

Hinweise

Siehe SetParent im Windows SDK.

Beispiel

// The following example attaches a HWND to the CWindow object
// and sets the hWndParent as the parent window of the 
// window wrapped by CWindow object using CWindow::SetParent.

CWindow myWindow;
myWindow.Attach(hWndChild);
HWND hWndPrevParent = myWindow.SetParent(hWndParent);

CWindow::SetRedraw

Legt die Kennzeichnung zum Neuzeichnen fest oder löscht sie, indem eine WM_SETREDRAW Nachricht an das Fenster gesendet wird.

void SetRedraw(BOOL bRedraw = TRUE) throw();

Parameter

bRedraw
[in] Gibt den Zustand der Kennzeichnung "Neu zeichnen" an. If TRUE (the default value), the redraw flag is set; if FALSE, the flag is cleared.

Hinweise

Rufen Sie SetRedraw auf, um änderungen neu zu zeichnen oder zu verhindern, dass Änderungen neu gezeichnet werden.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::SetRedraw() to set and reset the redraw flag

CWindow myWindow;
myWindow.Attach(hWnd);
myWindow.SetRedraw();      //sets the redraw flag to TRUE
//
//
myWindow.SetRedraw(FALSE); //sets the redraw flag to FALSE

CWindow::SetScrollInfo

Legt die Parameter einer Bildlaufleiste fest.

int SetScrollInfo(
    int nBar,
    LPSCROLLINFO lpScrollInfo,
    BOOL bRedraw = TRUE) throw();

Hinweise

Siehe SetScrollInfo im Windows SDK.

CWindow::SetScrollPos

Ändert die Position des Bildlauffelds.

int SetScrollPos(
    int nBar,
    int nPos,
    BOOL bRedraw = TRUE) throw();

Hinweise

Siehe SetScrollPos im Windows SDK.

CWindow::SetScrollRange

Ändert den Bereich der Bildlaufleiste.

BOOL SetScrollRange(
    int nBar,
    int nMinPos,
    int nMaxPos,
    BOOL bRedraw = TRUE) throw();

Hinweise

Siehe SetScrollRange im Windows SDK.

CWindow::SetTimer

Erstellt ein Timerereignis.

UINT SetTimer(
    UINT nIDEvent,
    UINT nElapse,
    void (CALLBACK* lpfnTimer)(HWND, UINT, UINT, DWORD) = NULL) throw();

Hinweise

Siehe SetTimer im Windows SDK.

CWindow::SetWindowContextHelpId

Legt den Hilfekontextbezeichner des Fensters fest.

BOOL SetWindowContextHelpId(DWORD dwContextHelpId) throw();

Hinweise

Siehe SetWindowContextHelpId im Windows SDK.

CWindow::SetWindowLong

Legt einen 32-Bit-Wert bei einem angegebenen Offset in den zusätzlichen Fensterspeicher fest.

LONG SetWindowLong(int nIndex, LONG dwNewLong) throw();

Hinweise

Siehe SetWindowLong im Windows SDK.

CWindow::SetWindowLongPtr

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

LONG_PTR SetWindowLongPtr(int nIndex, LONG_PTR dwNewLong) throw();

Hinweise

Siehe SetWindowLongPtr im Windows SDK.

Diese Funktion ersetzt die CWindow::SetWindowLong Methode. Verwenden Sie CWindow::SetWindowLongPtrzum Schreiben von Code, der sowohl mit 32-Bit- als auch mit 64-Bit-Versionen von Windows kompatibel ist.

CWindow::SetWindowPlacement

Legt den Anzeigezustand und die Positionen fest.

BOOL SetWindowPlacement(const WINDOWPLACEMENT FAR* lpwndpl);

Hinweise

Siehe SetWindowPlacement im Windows SDK.

CWindow::SetWindowPos

Legt die Größe, Position und Z-Reihenfolge fest.

BOOL SetWindowPos(
    HWND hWndInsertAfter,
    int x,
    int y,
    int cx,
    int cy,
    UINT nFlags) throw();

BOOL SetWindowPos(
    HWND hWndInsertAfter,
    LPCRECT lpRect,
    UINT nFlags) throw();

Hinweise

Siehe SetWindowPos im Windows SDK.

Die zweite Version dieser Methode verwendet eine RECT Struktur, um die neue Position, Breite und Höhe des Fensters festzulegen.

CWindow::SetWindowRgn

Legt den Fensterbereich eines Fensters fest.

int SetWindowRgn(HRGN hRgn, BOOL bRedraw = FALSE) throw();

Hinweise

Siehe SetWindowRgn im Windows SDK.

CWindow::SetWindowText

Ändert den Text des Fensters.

BOOL SetWindowText(LPCTSTR lpszString) throw();

Hinweise

Siehe SetWindowText im Windows SDK.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::SetWindowText() to set the new title-text of the 
//window

CWindow myWindow;
myWindow.Attach(hWnd);
myWindow.SetWindowText(_T("Hello ATL"));

CWindow::SetWindowWord

Legt einen 16-Bit-Wert bei einem angegebenen Offset in den zusätzlichen Fensterspeicher fest.

WORD SetWindowWord(int nIndex, WORD wNewWord) throw();

Hinweise

Siehe SetWindowLong im Windows SDK.

CWindow::ShowCaret

Zeigt das System caret an.

BOOL ShowCaret() throw();

Hinweise

Siehe ShowCaret im Windows SDK.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::ShowCaret() to show the caret

CWindow myWindow;
myWindow.Attach(hWnd);
myWindow.ShowCaret();

CWindow::ShowOwnedPopups

Blendet die Popupfenster im Besitz des Fensters ein oder aus.

BOOL ShowOwnedPopups(BOOL bShow = TRUE) throw();

Hinweise

Siehe ShowOwnedPopups im Windows SDK.

CWindow::ShowScrollBar

Blendet eine Bildlaufleiste ein oder aus.

BOOL ShowScrollBar(UINT nBar, BOOL bShow = TRUE) throw();

Hinweise

Siehe ShowScrollBar im Windows SDK.

CWindow::ShowWindow

Legt den Anzeigezustand des Fensters fest.

BOOL ShowWindow(int nCmdShow) throw();

Hinweise

Siehe ShowWindow im Windows SDK.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::ShowWindow() to show the window in its maximized state

CWindow myWindow;
myWindow.Attach(hWnd);
myWindow.ShowWindow(SW_SHOWMAXIMIZED);

CWindow::ShowWindowAsync

Legt den Anzeigestatus eines Fensters fest, das von einem anderen Thread erstellt wurde.

BOOL ShowWindowAsync(int nCmdShow) throw();

Hinweise

Siehe ShowWindowAsync im Windows SDK.

CWindow::UpdateWindow

Aktualisiert den Clientbereich.

BOOL UpdateWindow() throw();

Hinweise

Siehe UpdateWindow im Windows SDK.

Beispiel

//The following example attaches an HWND to the CWindow object and 
//calls CWindow::UpdateWindow() to update the window

CWindow myWindow;
myWindow.Attach(hWnd);
BOOL bUpdated = myWindow.UpdateWindow();

CWindow::ValidateRect

Überprüft den Clientbereich innerhalb des angegebenen Rechtecks.

BOOL ValidateRect(LPCRECT lpRect) throw();

Hinweise

Siehe ValidateRect im Windows SDK.

CWindow::ValidateRgn

Überprüft den Clientbereich innerhalb der angegebenen Region.

BOOL ValidateRgn(HRGN hRgn) throw();

Hinweise

Siehe ValidateRgn im Windows SDK.

CWindow::WinHelp

Startet die Windows-Hilfe.

BOOL WinHelp(
    LPCTSTR lpszHelp,
    UINT nCmd = HELP_CONTEXT,
    DWORD dwData = 0) throw();

Hinweise

Siehe WinHelp im Windows SDK.

Siehe auch

Klassenübersicht