La classe `CWindow`

Article
10/12/2023

Cette classe fournit des méthodes pour manipuler une fenêtre.

Important

Cette classe et ses membres ne peuvent pas être utilisés dans les applications qui s’exécutent dans Windows Runtime.

Syntaxe

class CWindow

Membres

Constructeurs publics

Nom	Description
`CWindow::CWindow`	Constructeur.

Méthodes publiques

Nom	Description
`CWindow::ArrangeIconicWindows`	Organise toutes les fenêtres enfants réduites.
`CWindow::Attach`	Attache une fenêtre à l’objet `CWindow` .
`CWindow::BeginPaint`	Prépare la fenêtre pour la peinture.
`CWindow::BringWindowToTop`	Affiche la fenêtre en haut de l’ordre Z.
`CWindow::CenterWindow`	Centre la fenêtre sur une fenêtre donnée.
`CWindow::ChangeClipboardChain`	Supprime la fenêtre de la chaîne de visionneuses du Presse-papiers.
`CWindow::CheckDlgButton`	Modifie l’état de vérification du bouton spécifié.
`CWindow::CheckRadioButton`	Vérifie la case d’option spécifiée.
`CWindow::ChildWindowFromPoint`	Récupère la fenêtre enfant contenant le point spécifié.
`CWindow::ChildWindowFromPointEx`	Récupère un type particulier de fenêtre enfant contenant le point spécifié.
`CWindow::ClientToScreen`	Convertit les coordonnées du client en coordonnées d’écran.
`CWindow::Create`	Crée une fenêtre.
`CWindow::CreateCaret`	Crée une forme pour le caret système.
`CWindow::CreateGrayCaret`	Crée un rectangle gris pour le caret système.
`CWindow::CreateSolidCaret`	Crée un rectangle solide pour le caret système.
`CWindow::DeferWindowPos`	Met à jour la structure de position à plusieurs fenêtres spécifiée pour la fenêtre spécifiée.
`CWindow::DestroyWindow`	Détruit la fenêtre associée à l’objet `CWindow` .
`CWindow::Detach`	Détache la fenêtre de l’objet `CWindow` .
`CWindow::DlgDirList`	Remplit une zone de liste avec les noms de tous les fichiers correspondant à un chemin d’accès ou un nom de fichier spécifié.
`CWindow::DlgDirListComboBox`	Remplit une zone de liste déroulante avec les noms de tous les fichiers correspondant à un chemin d’accès ou un nom de fichier spécifié.
`CWindow::DlgDirSelect`	Récupère la sélection actuelle d'une zone de liste.
`CWindow::DlgDirSelectComboBox`	Récupère la sélection actuelle à partir d’une zone de liste modifiable.
`CWindow::DragAcceptFiles`	Inscrit si la fenêtre accepte les fichiers déplacés.
`CWindow::DrawMenuBar`	Redessine la barre de menus de la fenêtre.
`CWindow::EnableScrollBar`	Active ou désactive les flèches de barre de défilement.
`CWindow::EnableWindow`	Active ou désactive l’entrée.
`CWindow::EndPaint`	Marque la fin de la peinture.
`CWindow::FlashWindow`	Fait clignoter la fenêtre une fois.
`CWindow::GetClientRect`	Récupère les coordonnées de la zone cliente.
`CWindow::GetDC`	Récupère un contexte d’appareil pour la zone cliente.
`CWindow::GetDCEx`	Récupère un contexte d’appareil pour la zone cliente et autorise les options de découpage.
`CWindow::GetDescendantWindow`	Récupère la fenêtre descendante spécifiée.
`CWindow::GetDlgControl`	Récupère une interface sur le contrôle spécifié.
`CWindow::GetDlgCtrlID`	Récupère l’identificateur de la fenêtre (pour les fenêtres enfants uniquement).
`CWindow::GetDlgHost`	Récupère un pointeur vers une interface vers le conteneur d’hébergement du contrôle ATL.
`CWindow::GetDlgItem`	Récupère la fenêtre enfant spécifiée.
`CWindow::GetDlgItemInt`	Traduit le texte d’un contrôle en entier.
`CWindow::GetDlgItemText`	Récupère le texte d’un contrôle.
`CWindow::GetExStyle`	Récupère les styles de fenêtre étendus.
`CWindow::GetFont`	Récupère la police actuelle de la fenêtre.
`CWindow::GetHotKey`	Détermine la touche chaude associée à la fenêtre.
`CWindow::GetIcon`	Récupère l’icône grande ou petite de la fenêtre.
`CWindow::GetLastActivePopup`	Récupère la fenêtre contextuelle active la plus récente.
`CWindow::GetMenu`	Récupère le menu de la fenêtre.
`CWindow::GetNextDlgGroupItem`	Récupère le contrôle précédent ou suivant dans un groupe de contrôles.
`CWindow::GetNextDlgTabItem`	Récupère le contrôle précédent ou suivant ayant le `WS_TABSTOP` style.
`CWindow::GetParent`	Récupère la fenêtre parente immédiate.
`CWindow::GetScrollInfo`	Récupère les paramètres d’une barre de défilement.
`CWindow::GetScrollPos`	Récupère la position de la zone de défilement.
`CWindow::GetScrollRange`	Récupère la plage de barres de défilement.
`CWindow::GetStyle`	Récupère les styles de fenêtre.
`CWindow::GetSystemMenu`	Crée une copie du menu système pour modification.
`CWindow::GetTopLevelParent`	Récupère la fenêtre parent ou propriétaire de niveau supérieur.
`CWindow::GetTopLevelWindow`	Récupère la fenêtre propriétaire de niveau supérieur.
`CWindow::GetTopWindow`	Récupère la fenêtre enfant de niveau supérieur.
`CWindow::GetUpdateRect`	Récupère les coordonnées du plus petit rectangle qui englobe entièrement la région de mise à jour .
`CWindow::GetUpdateRgn`	Récupère la région de mise à jour et la copie dans une région spécifiée.
`CWindow::GetWindow`	Récupère la fenêtre spécifiée.
`CWindow::GetWindowContextHelpId`	Récupère l’identificateur de contexte d’aide de la fenêtre.
`CWindow::GetWindowDC`	Récupère un contexte d’appareil pour la fenêtre entière.
`CWindow::GetWindowLong`	Récupère une valeur 32 bits à un décalage spécifié dans la mémoire de fenêtre supplémentaire.
`CWindow::GetWindowLongPtr`	Récupère des informations sur la fenêtre spécifiée, y compris une valeur à un décalage spécifié dans la mémoire supplémentaire de la fenêtre.
`CWindow::GetWindowPlacement`	Récupère l’état et les positions d’affichage.
`CWindow::GetWindowProcessID`	Récupère l’identificateur du processus qui a créé la fenêtre.
`CWindow::GetWindowRect`	Récupère les dimensions englobantes de la fenêtre.
`CWindow::GetWindowRgn`	Obtient une copie de la zone de fenêtre d’une fenêtre.
`CWindow::GetWindowText`	Récupère le texte de la fenêtre.
`CWindow::GetWindowTextLength`	Récupère la longueur du texte de la fenêtre.
`CWindow::GetWindowThreadID`	Récupère l’identificateur du thread qui a créé la fenêtre spécifiée.
`CWindow::GetWindowWord`	Récupère une valeur 16 bits à un décalage spécifié dans la mémoire de fenêtre supplémentaire.
`CWindow::GotoDlgCtrl`	Définit le focus clavier sur un contrôle dans la boîte de dialogue.
`CWindow::HideCaret`	Masque l’attention du système.
`CWindow::HiliteMenuItem`	Met en surbrillance ou supprime la mise en surbrillance d’un élément de menu de niveau supérieur.
`CWindow::Invalidate`	Invalide la zone cliente dans son intégralité.
`CWindow::InvalidateRect`	Invalide la zone cliente dans le rectangle spécifié.
`CWindow::InvalidateRgn`	Invalide la zone cliente dans la région spécifiée.
`CWindow::IsChild`	Détermine si la fenêtre spécifiée est une fenêtre enfant.
`CWindow::IsDialogMessage`	Détermine si un message est destiné à la boîte de dialogue spécifiée.
`CWindow::IsDlgButtonChecked`	Détermine l’état de vérification du bouton.
`CWindow::IsIconic`	Détermine si la fenêtre est réduite.
`CWindow::IsParentDialog`	Détermine si la fenêtre parente d’un contrôle est une fenêtre de dialogue.
`CWindow::IsWindow`	Détermine si le handle de fenêtre spécifié identifie une fenêtre existante.
`CWindow::IsWindowEnabled`	Détermine si la fenêtre est activée pour l’entrée.
`CWindow::IsWindowUnicode`	Détermine si la fenêtre spécifiée est une fenêtre Unicode native.
`CWindow::IsWindowVisible`	Détermine l’état de visibilité de la fenêtre.
`CWindow::IsZoomed`	Détermine si la fenêtre est agrandie.
`CWindow::KillTimer`	Détruit un événement de minuteur.
`CWindow::LockWindowUpdate`	Désactive ou active le dessin dans la fenêtre.
`CWindow::MapWindowPoints`	Convertit un ensemble de points de l’espace de coordonnées de la fenêtre en espace de coordonnées d’une autre fenêtre.
`CWindow::MessageBox`	Affiche une zone de message.
`CWindow::ModifyStyle`	Modifie les styles de fenêtre.
`CWindow::ModifyStyleEx`	Modifie les styles de fenêtre étendus.
`CWindow::MoveWindow`	Modifie la taille et la position de la fenêtre.
`CWindow::NextDlgCtrl`	Définit le focus clavier sur le contrôle suivant dans la boîte de dialogue.
`CWindow::OpenClipboard`	Ouvre le Presse-papiers.
`CWindow::PostMessage`	Place un message dans la file d’attente de messages associée au thread qui a créé la fenêtre. Retourne sans attendre que le thread traite le message.
`CWindow::PrevDlgCtrl`	Définit le focus clavier sur le contrôle précédent dans la boîte de dialogue.
`CWindow::Print`	Demande que la fenêtre soit dessinée dans un contexte d’appareil spécifié.
`CWindow::PrintClient`	Demande que la zone cliente de la fenêtre soit dessinée dans un contexte d’appareil spécifié.
`CWindow::RedrawWindow`	Met à jour un rectangle ou une région spécifié dans la zone cliente.
`CWindow::ReleaseDC`	Libère un contexte d’appareil.
`CWindow::ResizeClient`	Redimensionne la fenêtre.
`CWindow::ScreenToClient`	Convertit les coordonnées de l’écran en coordonnées clientes.
`CWindow::ScrollWindow`	Fait défiler la zone cliente spécifiée.
`CWindow::ScrollWindowEx`	Fait défiler la zone cliente spécifiée avec des fonctionnalités supplémentaires.
`CWindow::SendDlgItemMessage`	Envoie un message à un contrôle.
`CWindow::SendMessage`	Envoie un message à la fenêtre et ne retourne pas tant que la procédure de fenêtre n’a pas traité le message.
`CWindow::SendMessageToDescendants`	Envoie un message aux fenêtres descendantes spécifiées.
`CWindow::SendNotifyMessage`	Envoie un message à la fenêtre. Si la fenêtre a été créée par le thread appelant, `SendNotifyMessage` ne retourne pas tant que la procédure de fenêtre n’a pas traité le message. Sinon, elle retourne immédiatement.
`CWindow::SetActiveWindow`	Active la fenêtre.
`CWindow::SetCapture`	Envoie toutes les entrées de souris suivantes à la fenêtre.
`CWindow::SetClipboardViewer`	Ajoute la fenêtre à la chaîne de visionneuse du Presse-papiers.
`CWindow::SetDlgCtrlID`	Modifie l’identificateur de la fenêtre.
`CWindow::SetDlgItemInt`	Remplace le texte d’un contrôle par la représentation sous forme de chaîne d’une valeur entière.
`CWindow::SetDlgItemText`	Modifie le texte d’un contrôle.
`CWindow::SetFocus`	Définit le focus d’entrée sur la fenêtre.
`CWindow::SetFont`	Modifie la police actuelle de la fenêtre.
`CWindow::SetHotKey`	Associe une touche d’accès rapide à la fenêtre.
`CWindow::SetIcon`	Modifie l’icône grande ou petite de la fenêtre.
`CWindow::SetMenu`	Modifie le menu actif de la fenêtre.
`CWindow::SetParent`	Modifie la fenêtre parente.
`CWindow::SetRedraw`	Définit ou efface l’indicateur de redessination.
`CWindow::SetScrollInfo`	Définit les paramètres d’une barre de défilement.
`CWindow::SetScrollPos`	Modifie la position de la zone de défilement.
`CWindow::SetScrollRange`	Modifie la plage de barres de défilement.
`CWindow::SetTimer`	Crée un événement de minuteur.
`CWindow::SetWindowContextHelpId`	Définit l’identificateur de contexte d’aide de la fenêtre.
`CWindow::SetWindowLong`	Définit une valeur 32 bits à un décalage spécifié dans la mémoire de fenêtre supplémentaire.
`CWindow::SetWindowLongPtr`	Modifie un attribut de la fenêtre spécifiée et définit également une valeur au décalage spécifié dans la mémoire supplémentaire de la fenêtre.
`CWindow::SetWindowPlacement`	Définit l’état et les positions d’affichage.
`CWindow::SetWindowPos`	Définit la taille, la position et l’ordre Z.
`CWindow::SetWindowRgn`	Définit la région de la fenêtre d’une fenêtre.
`CWindow::SetWindowText`	Modifie le texte de la fenêtre.
`CWindow::SetWindowWord`	Définit une valeur 16 bits à un décalage spécifié dans la mémoire de fenêtre supplémentaire.
`CWindow::ShowCaret`	Affiche le caret système.
`CWindow::ShowOwnedPopups`	Affiche ou masque les fenêtres contextuelles appartenant à la fenêtre.
`CWindow::ShowScrollBar`	Affiche ou masque une barre de défilement.
`CWindow::ShowWindow`	Définit l’état d’affichage de la fenêtre.
`CWindow::ShowWindowAsync`	Définit l’état d’affichage d’une fenêtre créée par un autre thread.
`CWindow::UpdateWindow`	Met à jour la zone cliente.
`CWindow::ValidateRect`	Valide la zone cliente dans le rectangle spécifié.
`CWindow::ValidateRgn`	Valide la zone cliente dans la région spécifiée.
`CWindow::WinHelp`	Démarre l’aide de Windows.

Opérateurs publics

Nom	Description
`CWindow::operator HWND`	Convertit l’objet `CWindow` en `HWND`.
`CWindow::operator =`	Affecte un `HWND` objet `CWindow` .

Membres de données publics

Nom	Description
`CWindow::m_hWnd`	Handle de la fenêtre associée à l’objet `CWindow` .
`CWindow::rcDefault`	Contient les dimensions de fenêtre par défaut.

Notes

CWindow fournit les fonctionnalités de base pour manipuler une fenêtre dans ATL. CWindow De nombreuses méthodes encapsulent simplement l’une des fonctions d’API Win32. Par exemple, comparez les prototypes pour CWindow::ShowWindow et ShowWindow:

CWindow, méthode	Fonction Win32
`BOOL ShowWindow( int nCmdShow );`	`BOOL ShowWindow( HWND hWnd , int nCmdShow );`

CWindow::ShowWindow appelle la fonction ShowWindow Win32 en passant CWindow::m_hWnd comme premier paramètre. Chaque CWindow méthode qui encapsule directement une fonction Win32 transmet le m_hWnd membre ; par conséquent, une grande partie de la CWindow documentation vous fait référence au Kit de développement logiciel (SDK) Windows.

Remarque

Toutes les fonctions Win32 liées à la fenêtre ne sont pas encapsulées CWindowpar , et toutes les CWindow méthodes encapsulent une fonction Win32.

CWindow::m_hWnd stocke la HWND fenêtre qui identifie une fenêtre. Un HWND objet est attaché à votre objet lorsque vous :

Spécifiez un HWND constructeur dans CWindow's.
Appelez CWindow::Attach.
Utilisez CWindow's operator =.
Créez ou sous-classez une fenêtre à l’aide de l’une des classes suivantes dérivées de CWindow:

CWindowImpl Vous permet de créer une fenêtre ou une sous-classe d’une fenêtre existante.

CContainedWindow Implémente une fenêtre contenue dans un autre objet. Vous pouvez créer une nouvelle fenêtre ou une sous-classe d’une fenêtre existante.

CDialogImpl Vous permet de créer une boîte de dialogue modale ou sans mode.

Pour plus d’informations sur Windows, consultez les rubriques Windows et suivantes dans le Kit de développement logiciel (SDK) Windows. Pour plus d’informations sur l’utilisation de fenêtres dans ATL, consultez l’article ATL Window Classes.

Spécifications

En-tête : atlwin.h

`CWindow::ArrangeIconicWindows`

Organise toutes les fenêtres enfants réduites.

UINT ArrangeIconicWindows() throw();

Notes

Consultez ArrangeIconicWindows le Kit de développement logiciel (SDK) Windows.

`CWindow::Attach`

Attache la fenêtre identifiée par hWndNew l’objet CWindow .

void Attach(HWND hWndNew) throw();

Paramètres

hWndNew
[in] Poignée d’une fenêtre.

Exemple

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

`CWindow::BeginPaint`

Prépare la fenêtre pour la peinture.

HDC BeginPaint(LPPAINTSTRUCT lpPaint) throw();

Notes

Consultez BeginPaint le Kit de développement logiciel (SDK) Windows.

Exemple

//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`

Affiche la fenêtre en haut de l’ordre Z.

BOOL BringWindowToTop() throw();

Notes

Consultez BringWindowToTop le Kit de développement logiciel (SDK) Windows.

Exemple

//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`

Centre la fenêtre sur une fenêtre donnée.

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

Paramètres

hWndCenter
[in] Handle vers la fenêtre sur laquelle centrer. Si ce paramètre est NULL (valeur par défaut), la méthode est définie hWndCenter sur la fenêtre parente de la fenêtre s’il s’agit d’une fenêtre enfant. Sinon, elle est définie hWndCenter sur la fenêtre propriétaire de la fenêtre.

Valeur de retour

TRUE si la fenêtre est centrée avec succès ; sinon, FALSE.

Exemple

//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`

Supprime la fenêtre de la chaîne de visionneuses du Presse-papiers.

BOOL ChangeClipboardChain(HWND hWndNewNext) throw();

Notes

Consultez ChangeClipboardChain le Kit de développement logiciel (SDK) Windows.

`CWindow::CheckDlgButton`

Modifie l’état de vérification du bouton spécifié.

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

Notes

Consultez CheckDlgButton le Kit de développement logiciel (SDK) Windows.

`CWindow::CheckRadioButton`

Vérifie la case d’option spécifiée.

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

Notes

Consultez CheckRadioButton le Kit de développement logiciel (SDK) Windows.

`CWindow::ChildWindowFromPoint`

Récupère la fenêtre enfant contenant le point spécifié.

HWND ChildWindowFromPoint(POINT point) const throw();

Notes

Consultez ChildWindowFromPoint le Kit de développement logiciel (SDK) Windows.

`CWindow::ChildWindowFromPointEx`

Récupère un type particulier de fenêtre enfant contenant le point spécifié.

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

Notes

Consultez ChildWindowFromPointEx le Kit de développement logiciel (SDK) Windows.

`CWindow::ClientToScreen`

Convertit les coordonnées du client en coordonnées d’écran.

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

Notes

Consultez ClientToScreen le Kit de développement logiciel (SDK) Windows.

La deuxième version de cette méthode vous permet de convertir les coordonnées d’une RECT structure.

`CWindow::Create`

Crée une fenêtre.

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();

Paramètres

lpstrWndClass
[in] Pointeur vers la classe de la fenêtre.

hWndParent
[in] Handle de la fenêtre parent ou propriétaire.

rect
[in] Variable de type _U_RECT spécifiant la position de la fenêtre. La valeur par défaut est NULL. Lorsque ce paramètre est NULL, la valeur de celle-ci CWindow::rcDefault est utilisée.

szWindowName
[in] Spécifie le nom de la fenêtre. La valeur par défaut est NULL.

dwStyle
[in] Style de la fenêtre. La valeur par défaut est 0, ce qui signifie qu’aucun style n’est spécifié. Pour obtenir la liste des valeurs possibles, consultez CreateWindow le Kit de développement logiciel (SDK) Windows.

dwExStyle
[in] Style de fenêtre étendu. La valeur par défaut est 0, ce qui signifie qu’aucun style étendu n’est spécifié. Pour obtenir la liste des valeurs possibles, consultez CreateWindowEx le Kit de développement logiciel (SDK) Windows.

MenuOrID
[in] Variable de type _U_MENUorID spécifiant un handle dans un menu ou un identificateur de fenêtre. La valeur par défaut est 0U.

lpCreateParam
Pointeur vers les données de création de fenêtre contenues dans une CREATESTRUCT structure.

Valeur de retour

En cas de réussite, le handle de la fenêtre nouvellement créée, spécifié par m_hWnd. Sinon, NULL.

Notes

CWindow::rcDefault est défini comme __declspec(selectany) RECT CWindow::rcDefault = {CW_USEDEFAULT, CW_USEDEFAULT, 0, 0};.

Pour plus d’informations, consultez CreateWindow le Kit de développement logiciel (SDK) Windows.

Remarque Si 0 est utilisé comme valeur pour le MenuOrID paramètre, il doit être spécifié comme 0U (valeur par défaut) pour éviter une erreur du compilateur.

`CWindow::CreateCaret`

Crée une forme pour le caret système.

BOOL CreateCaret(HBITMAP pBitmap) throw();

Notes

Consultez CreateCaret le Kit de développement logiciel (SDK) Windows.

`CWindow::CreateGrayCaret`

Crée un rectangle gris pour le caret système.

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

Notes

Consultez CreateCaret le Kit de développement logiciel (SDK) Windows.

Passe (HBITMAP) 1 le paramètre de handle bitmap à la fonction Win32.

`CWindow::CreateSolidCaret`

Crée un rectangle solide pour le caret système.

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

Notes

Consultez CreateCaret le Kit de développement logiciel (SDK) Windows.

Passe (HBITMAP) 0 le paramètre de handle bitmap à la fonction Win32.

`CWindow::CWindow`

Constructeur .

CWindow(HWND hWnd = NULL) throw();

Paramètres

hWnd
[in] Poignée d’une fenêtre.

Notes

Initialise le m_hWnd membre à hWnd, qui par défaut est NULL.

Remarque

CWindow::CWindow ne crée pas de fenêtre. Les classes , et CDialogImpl (qui dérivent CWindowde ) fournissent une méthode pour créer une fenêtre ou une boîte de dialogue, qui est ensuite affectée à CWindow::m_hWnd. CContainedWindowCWindowImpl Vous pouvez également utiliser la CreateWindow fonction Win32.

`CWindow::DeferWindowPos`

Met à jour la structure de position à plusieurs fenêtres spécifiée pour la fenêtre spécifiée.

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

Notes

Consultez DeferWindowPos le Kit de développement logiciel (SDK) Windows.

`CWindow::DestroyWindow`

Détruit la fenêtre associée à l’objet CWindow et définit m_hWnd la NULLvaleur .

BOOL DestroyWindow() throw();

Notes

Consultez DestroyWindow le Kit de développement logiciel (SDK) Windows.

Il ne détruit pas l’objet CWindow lui-même.

Exemple

  //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`

m_hWnd Détache de l’objet CWindow et définit m_hWnd sur NULL.

HWND Detach() throw();

Valeur de retour

HWND associé à l'objet CWindow.

Exemple

//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`

Remplit une zone de liste avec les noms de tous les fichiers correspondant à un chemin d’accès ou un nom de fichier spécifié.

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

Notes

Consultez DlgDirList le Kit de développement logiciel (SDK) Windows.

`CWindow::DlgDirListComboBox`

Remplit une zone de liste déroulante avec les noms de tous les fichiers correspondant à un chemin d’accès ou un nom de fichier spécifié.

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

Notes

Consultez DlgDirListComboBox le Kit de développement logiciel (SDK) Windows.

`CWindow::DlgDirSelect`

Récupère la sélection actuelle d'une zone de liste.

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

Notes

Consultez DlgDirSelectEx le Kit de développement logiciel (SDK) Windows.

`CWindow::DlgDirSelectComboBox`

Récupère la sélection actuelle à partir d’une zone de liste modifiable.

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

Notes

Consultez DlgDirSelectComboBoxEx le Kit de développement logiciel (SDK) Windows.

`CWindow::DragAcceptFiles`

Inscrit si la fenêtre accepte les fichiers déplacés.

void DragAcceptFiles(BOOL bAccept = TRUE);

Notes

Consultez DragAcceptFiles le Kit de développement logiciel (SDK) Windows.

`CWindow::DrawMenuBar`

Redessine la barre de menus de la fenêtre.

BOOL DrawMenuBar() throw();

Notes

Consultez DrawMenuBar le Kit de développement logiciel (SDK) Windows.

`CWindow::EnableScrollBar`

Active ou désactive les flèches de barre de défilement.

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

Notes

Consultez EnableScrollBar le Kit de développement logiciel (SDK) Windows.

`CWindow::EnableWindow`

Active ou désactive l’entrée.

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

Notes

Consultez EnableWindow le Kit de développement logiciel (SDK) Windows.

Exemple

//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`

Marque la fin de la peinture.

void EndPaint(LPPAINTSTRUCT lpPaint) throw();

Notes

Consultez EndPaint le Kit de développement logiciel (SDK) Windows.

Exemple

//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`

Fait clignoter la fenêtre une fois.

BOOL FlashWindow(BOOL bInvert) throw();

Notes

Consultez FlashWindow le Kit de développement logiciel (SDK) Windows.

`CWindow::GetClientRect`

Récupère les coordonnées de la zone cliente.

BOOL GetClientRect(LPRECT lpRect) const throw();

Notes

Consultez GetClientRect le Kit de développement logiciel (SDK) Windows.

Exemple

//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`

Récupère un contexte d’appareil pour la zone cliente.

HDC GetDC() throw();

Notes

Consultez GetDC le Kit de développement logiciel (SDK) Windows.

Exemple

// 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`

Récupère un contexte d’appareil pour la zone cliente et autorise les options de découpage.

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

Notes

Consultez GetDCEx le Kit de développement logiciel (SDK) Windows.

`CWindow::GetDescendantWindow`

Recherche la fenêtre descendante spécifiée par l’identificateur donné.

HWND GetDescendantWindow(int nID) const throw();

Paramètres

nID
[in] Identificateur de la fenêtre descendante à récupérer.

Valeur de retour

Handle vers une fenêtre descendante.

Notes

GetDescendantWindow recherche l’ensemble de l’arborescence des fenêtres enfants, et non seulement les fenêtres qui sont des enfants immédiats.

`CWindow::GetDlgControl`

Appelez cette fonction pour obtenir un pointeur vers une interface d’un contrôle ActiveX hébergé par un contrôle composite ou une boîte de dialogue d’hébergement de contrôle.

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

Paramètres

nID
[in] ID de ressource du contrôle en cours de récupération.

iid
[in] ID de l’interface que vous souhaitez obtenir à partir du contrôle.

ppCtrl
[out] Pointeur vers l’interface.

Valeur de retour

Retourne S_OK la réussite ou toute erreur HRESULTvalide . Par exemple, la fonction retourne E_FAIL si le contrôle spécifié par nID ne peut pas être trouvé et qu’il retourne E_NOINTERFACE si le contrôle est trouvé, mais ne prend pas en charge l’interface spécifiée par iid.

Notes

À l’aide de ce pointeur, vous pouvez appeler des méthodes sur l’interface.

`CWindow::GetDlgCtrlID`

Récupère l’identificateur de la fenêtre (pour les fenêtres enfants uniquement).

int GetDlgCtrlID() const throw();

Notes

Consultez GetDlgCtrlID le Kit de développement logiciel (SDK) Windows.

`CWindow::GetDlgHost`

Récupère un pointeur vers une interface vers le conteneur d’hébergement du contrôle ATL.

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

Paramètres

nID
[in] ID de ressource du contrôle en cours de récupération.

iid
[in] ID de l’interface que vous souhaitez obtenir à partir du contrôle.

ppHost
[out] Pointeur vers l’interface.

Valeur de retour

Retourne S_OK si la fenêtre spécifiée par iid est un conteneur de contrôle et que l’interface demandée peut être récupérée. Retourne E_FAIL si la fenêtre n’est pas un conteneur de contrôle ou si l’interface demandée n’a pas pu être récupérée. Si une fenêtre avec l’ID spécifié est introuvable, la valeur de retour est égale à HRESULT_FROM_WIN32(ERROR_CONTROL_ID_NOT_FOUND).

Notes

À l’aide de ce pointeur, vous pouvez appeler des méthodes sur l’interface.

`CWindow::GetDlgItem`

Récupère la fenêtre enfant spécifiée.

HWND GetDlgItem(int nID) const throw();

Notes

Consultez GetDlgItem dans le Kit de développement logiciel (SDK) Windows.

`CWindow::GetDlgItemInt`

Traduit le texte d’un contrôle en entier.

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

Notes

Consultez GetDlgItemInt le Kit de développement logiciel (SDK) Windows.

`CWindow::GetDlgItemText`

Récupère le texte d’un contrôle.

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

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

Notes

Pour plus d’informations, consultez GetDlgItemText le Kit de développement logiciel (SDK) Windows.

La deuxième version de cette méthode vous permet de copier le texte du contrôle dans un BSTR. Cette version retourne TRUE si le texte est correctement copié ; sinon, FALSE.

`CWindow::GetExStyle`

Récupère les styles de fenêtre étendus de la fenêtre.

DWORD GetExStyle() const throw();

Valeur de retour

Styles étendus de la fenêtre.

Notes

Pour récupérer les styles de fenêtre standard, appelez GetStyle.

Exemple

//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`

Récupère la police actuelle de la fenêtre en envoyant un WM_GETFONT message à la fenêtre.

HFONT GetFont() const throw();

Valeur de retour

Poignée de police.

`CWindow::GetHotKey`

Détermine la touche chaude associée à la fenêtre en envoyant un WM_GETHOTKEY message.

DWORD GetHotKey() const throw();

Valeur de retour

Code et modificateurs de clé virtuelle pour la clé chaude associée à la fenêtre. Pour obtenir la liste des modificateurs possibles, consultez WM_GETHOTKEY le Kit de développement logiciel (SDK) Windows. Pour obtenir la liste des codes de clé virtuelle standard, consultez Winuser.h.

`CWindow::GetIcon`

Récupère la poignée sur l’icône grande ou petite de la fenêtre.

HICON GetIcon(BOOL bBigIcon = TRUE) const;

Paramètres

bBigIcon
[in] Si TRUE (la valeur par défaut) la méthode retourne l’icône volumineuse. Sinon, elle retourne la petite icône.

Valeur de retour

Handle d’icône.

Notes

GetIcon envoie un WM_GETICON message à la fenêtre.

`CWindow::GetLastActivePopup`

Récupère la fenêtre contextuelle active la plus récente.

HWND GetLastActivePopup() const throw();

Notes

Consultez GetLastActivePopup le Kit de développement logiciel (SDK) Windows.

`CWindow::GetMenu`

Récupère le menu de la fenêtre.

HMENU GetMenu() const throw();

Notes

Consultez GetMenu le Kit de développement logiciel (SDK) Windows.

`CWindow::GetNextDlgGroupItem`

Récupère le contrôle précédent ou suivant dans un groupe de contrôles.

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

Notes

Consultez GetNextDlgGroupItem le Kit de développement logiciel (SDK) Windows.

`CWindow::GetNextDlgTabItem`

Récupère le contrôle précédent ou suivant ayant le WS_TABSTOP style.

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

Notes

Consultez GetNextDlgTabItem le Kit de développement logiciel (SDK) Windows.

`CWindow::GetParent`

Récupère la fenêtre parente immédiate.

HWND GetParent() const throw();

Notes

Consultez GetParent le Kit de développement logiciel (SDK) Windows.

Exemple

// 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`

Récupère les paramètres d’une barre de défilement.

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

Notes

Consultez GetScrollInfo le Kit de développement logiciel (SDK) Windows.

`CWindow::GetScrollPos`

Récupère la position de la zone de défilement.

int GetScrollPos(int nBar) const throw();

Notes

Consultez GetScrollPos le Kit de développement logiciel (SDK) Windows.

`CWindow::GetScrollRange`

Récupère la plage de barres de défilement.

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

Notes

Consultez GetScrollRange le Kit de développement logiciel (SDK) Windows.

`CWindow::GetStyle`

Récupère les styles de fenêtre de la fenêtre.

DWORD GetStyle() const throw();

Valeur de retour

Styles de la fenêtre.

Notes

Pour récupérer les styles de fenêtre étendus, appelez GetExStyle.

Exemple

//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`

Crée une copie du menu système pour modification.

HMENU GetSystemMenu(BOOL bRevert) const throw();

Notes

Consultez GetSystemMenu le Kit de développement logiciel (SDK) Windows.

`CWindow::GetTopLevelParent`

Récupère la fenêtre parente de niveau supérieur de la fenêtre.

HWND GetTopLevelParent() const throw();

Valeur de retour

Handle vers la fenêtre parente de niveau supérieur.

`CWindow::GetTopLevelWindow`

Récupère la fenêtre parent ou propriétaire de niveau supérieur de la fenêtre.

HWND GetTopLevelWindow() const throw();

Valeur de retour

Handle de la fenêtre de propriétaire de niveau supérieur.

`CWindow::GetTopWindow`

Récupère la fenêtre enfant de niveau supérieur.

HWND GetTopWindow() const throw();

Notes

Consultez GetTopWindow le Kit de développement logiciel (SDK) Windows.

Exemple

//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`

Récupère les coordonnées du plus petit rectangle qui englobe entièrement la région de mise à jour .

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

Notes

Consultez GetUpdateRect le Kit de développement logiciel (SDK) Windows.

`CWindow::GetUpdateRgn`

Récupère la région de mise à jour et la copie dans une région spécifiée.

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

Notes

Consultez GetUpdateRgn le Kit de développement logiciel (SDK) Windows.

`CWindow::GetWindow`

Récupère la fenêtre spécifiée.

HWND GetWindow(UINT nCmd) const throw();

Notes

Consultez GetWindow le Kit de développement logiciel (SDK) Windows.

`CWindow::GetWindowContextHelpId`

Récupère l’identificateur de contexte d’aide de la fenêtre.

DWORD GetWindowContextHelpId() const throw();

Notes

Consultez GetWindowContextHelpId le Kit de développement logiciel (SDK) Windows.

`CWindow::GetWindowDC`

Récupère un contexte d’appareil pour la fenêtre entière.

HDC GetWindowDC() throw();

Notes

Consultez GetWindowDC le Kit de développement logiciel (SDK) Windows.

Exemple

//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`

Récupère une valeur 32 bits à un décalage spécifié dans la mémoire de fenêtre supplémentaire.

LONG GetWindowLong(int nIndex) const throw();

Notes

Consultez GetWindowLong le Kit de développement logiciel (SDK) Windows.

Remarque

Pour écrire du code compatible avec les versions 32 bits et 64 bits de Windows, utilisez CWindow::GetWindowLongPtr.

`CWindow::GetWindowLongPtr`

Récupère des informations sur la fenêtre spécifiée, y compris une valeur à un décalage spécifié dans la mémoire supplémentaire de la fenêtre.

LONG_PTR GetWindowLongPtr(int nIndex) const throw();

Notes

Pour plus d’informations, consultez GetWindowLongPtr le Kit de développement logiciel (SDK) Windows.

Si vous récupérez un pointeur ou un handle, cette fonction remplace la CWindow::GetWindowLong méthode.

Remarque

Les pointeurs et les handles sont 32 bits sur Windows 32 bits et 64 bits sur Windows 64 bits.

Pour écrire du code compatible avec les versions 32 bits et 64 bits de Windows, utilisez CWindow::GetWindowLongPtr.

`CWindow::GetWindowPlacement`

Récupère l’état et les positions d’affichage.

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

Notes

Consultez GetWindowPlacement le Kit de développement logiciel (SDK) Windows.

`CWindow::GetWindowProcessID`

Récupère l’identificateur du processus qui a créé la fenêtre.

DWORD GetWindowProcessID() throw();

Notes

Consultez GetWindowThreadProcessID le Kit de développement logiciel (SDK) Windows.

Exemple

//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`

Récupère les dimensions englobantes de la fenêtre.

BOOL GetWindowRect(LPRECT lpRect) const throw();

Notes

Consultez GetWindowRect le Kit de développement logiciel (SDK) Windows.

`CWindow::GetWindowRgn`

Obtient une copie de la zone de fenêtre d’une fenêtre.

int GetWindowRgn(HRGN hRgn) throw();

Notes

Consultez GetWindowRgn le Kit de développement logiciel (SDK) Windows.

`CWindow::GetWindowText`

Récupère le texte de la fenêtre.

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

Paramètres

lpszStringBuf
Mémoire tampon dans laquelle écrire le texte de la fenêtre.

nMaxCount
Taille de la mémoire tampon en caractères ; également le nombre maximal de caractères à écrire.

bstrText
Un BSTR dans lequel stocker le texte de la fenêtre.

strText
Un CString dans lequel stocker le texte de la fenêtre.

Valeur de retour

Si le texte est correctement copié, la valeur de retour est TRUE; sinon, la valeur de retour est FALSE.

Notes

Consultez GetWindowText le Kit de développement logiciel (SDK) Windows.

La deuxième version de cette méthode vous permet de stocker le texte dans une BSTR; la troisième version vous permet de stocker le résultat dans un CString, car CSimpleString est la classe de base de CString.

`CWindow::GetWindowTextLength`

Récupère la longueur du texte de la fenêtre.

int GetWindowTextLength() const throw();

Notes

Consultez GetWindowTextLength le Kit de développement logiciel (SDK) Windows.

`CWindow::GetWindowThreadID`

Récupère l’identificateur du thread qui a créé la fenêtre spécifiée.

DWORD GetWindowThreadID() throw();

Notes

Consultez GetWindowThreadProcessID le Kit de développement logiciel (SDK) Windows.

Exemple

//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`

Récupère une valeur 16 bits à un décalage spécifié dans la mémoire de fenêtre supplémentaire.

WORD GetWindowWord(int nIndex) const throw();

Notes

Consultez GetWindowLong le Kit de développement logiciel (SDK) Windows.

`CWindow::GotoDlgCtrl`

Définit le focus clavier sur un contrôle dans la boîte de dialogue.

void GotoDlgCtrl(HWND hWndCtrl) const throw();

Notes

Consultez WM_NEXTDLGCTL le Kit de développement logiciel (SDK) Windows.

`CWindow::HideCaret`

Masque l’attention du système.

BOOL HideCaret() throw();

Notes

Consultez HideCaret le Kit de développement logiciel (SDK) Windows.

Exemple

//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`

Met en surbrillance ou supprime la mise en surbrillance d’un élément de menu de niveau supérieur.

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

Notes

Consultez HiliteMenuItem le Kit de développement logiciel (SDK) Windows.

`CWindow::Invalidate`

Invalide la zone cliente dans son intégralité.

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

Notes

Consultez InvalidateRect le Kit de développement logiciel (SDK) Windows.

Passe NULL le RECT paramètre à la InvalidateRect fonction Win32.

Exemple

//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`

Invalide la zone cliente dans le rectangle spécifié.

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

Notes

Consultez InvalidateRect le Kit de développement logiciel (SDK) Windows.

`CWindow::InvalidateRgn`

Invalide la zone cliente dans la région spécifiée.

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

Notes

Pour plus d’informations, consultez InvalidateRgn le Kit de développement logiciel (SDK) Windows.

Spécifie un void type de retour, tandis que la InvalidateRgn fonction Win32 retourne TRUEtoujours .

`CWindow::IsChild`

Détermine si la fenêtre spécifiée est une fenêtre enfant.

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

Notes

Consultez IsChild le Kit de développement logiciel (SDK) Windows.

`CWindow::IsDialogMessage`

Détermine si un message est destiné à la boîte de dialogue spécifiée.

BOOL IsDialogMessage(LPMSG lpMsg) throw();

Notes

Consultez IsDialogMessage le Kit de développement logiciel (SDK) Windows.

`CWindow::IsDlgButtonChecked`

Détermine l’état de vérification du bouton.

UINT IsDlgButtonChecked(int nIDButton) const throw();

Notes

Consultez IsDlgButtonChecked le Kit de développement logiciel (SDK) Windows.

`CWindow::IsIconic`

Détermine si la fenêtre est réduite.

BOOL IsIconic() const throw();

Notes

Consultez IsIconic le Kit de développement logiciel (SDK) Windows.

Exemple

//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`

Détermine si la fenêtre parente du contrôle est une fenêtre de dialogue.

BOOL IsParentDialog() throw();

Valeur de retour

Retourne TRUE si la fenêtre parente est une boîte de dialogue, FALSE sinon.

`CWindow::IsWindow`

Détermine si le handle de fenêtre spécifié identifie une fenêtre existante.

BOOL IsWindow() throw();

Notes

Consultez IsWindow le Kit de développement logiciel (SDK) Windows.

Exemple

//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`

Détermine si la fenêtre est activée pour l’entrée.

BOOL IsWindowEnabled() const throw();

Notes

Consultez IsWindowEnabled le Kit de développement logiciel (SDK) Windows.

Exemple

//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`

Détermine l’état de visibilité de la fenêtre.

BOOL IsWindowVisible() const throw();

Notes

Consultez IsWindowVisible le Kit de développement logiciel (SDK) Windows.

Exemple

//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`

Détermine si la fenêtre spécifiée est une fenêtre Unicode native.

BOOL IsWindowUnicode() throw();

Notes

Consultez IsWindowUnicode le Kit de développement logiciel (SDK) Windows.

Exemple

//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`

Détermine si la fenêtre est agrandie.

BOOL IsZoomed() const throw();

Notes

Consultez IsZoomed le Kit de développement logiciel (SDK) Windows.

`CWindow::KillTimer`

Détruit un événement de minuteur créé par CWindow::SetTimer.

BOOL KillTimer(UINT nIDEvent) throw();

Notes

Consultez KillTimer le Kit de développement logiciel (SDK) Windows.

`CWindow::LockWindowUpdate`

Désactive ou active le dessin dans la fenêtre en appelant la LockWindowUpdate fonction Win32.

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

Paramètres

bLock
[in] Si TRUE (valeur par défaut), la fenêtre est verrouillée. Sinon, elle sera déverrouillée.

Valeur de retour

TRUE si la fenêtre est correctement verrouillée ; sinon, FALSE.

Notes

Si bLock c’est TRUEle cas, cette méthode passe m_hWnd à la fonction Win32 ; sinon, elle passe NULL.

`CWindow::m_hWnd`

Contient un handle dans la fenêtre associée à l’objet CWindow .

HWND m_hWnd throw() throw();

`CWindow::MapWindowPoints`

Convertit un ensemble de points de l’espace de coordonnées de la fenêtre en espace de coordonnées d’une autre fenêtre.

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

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

Notes

Consultez MapWindowPoints le Kit de développement logiciel (SDK) Windows.

La deuxième version de cette méthode vous permet de convertir les coordonnées d’une RECT structure.

`CWindow::MessageBox`

Affiche une zone de message.

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

Notes

Consultez MessageBox le Kit de développement logiciel (SDK) Windows.

Exemple

//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`

Modifie les styles de fenêtre de l’objet CWindow .

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

Paramètres

dwRemove
[in] Spécifie les styles de fenêtre à supprimer lors de la modification du style.

dwAdd
[in] Spécifie les styles de fenêtre à ajouter lors de la modification du style.

nFlags
[in] Indicateurs de positionnement de fenêtre. Pour obtenir la liste des valeurs possibles, consultez la SetWindowPos fonction dans le Kit de développement logiciel (SDK) Windows.

Valeur de retour

TRUE si les styles de fenêtre sont modifiés ; sinon, FALSE.

Notes

Les styles à ajouter ou à supprimer peuvent être combinés à l’aide de l’opérateur « ou » au| niveau du bit. Consultez la CreateWindow fonction dans le SDK Windows pour obtenir des informations sur les styles de fenêtre disponibles.

S’il nFlags n’est pas différent de zéro, ModifyStyle appelle la fonction SetWindowPosWin32 et redessine la fenêtre en combinant nFlags avec les quatre indicateurs suivants :

SWP_NOSIZE Conserve la taille actuelle.
SWP_NOMOVE Conserve la position actuelle.
SWP_NOZORDER Conserve l’ordre Z actuel.
SWP_NOACTIVATE N’active pas la fenêtre.

Pour modifier les styles étendus d’une fenêtre, appelez ModifyStyleEx.

Exemple

//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`

Modifie les styles de fenêtre étendus de l’objet CWindow .

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

Paramètres

dwRemove
[in] Spécifie les styles étendus à supprimer lors de la modification de style.

dwAdd
[in] Spécifie les styles étendus à ajouter lors de la modification de style.

nFlags
[in] Indicateurs de positionnement de fenêtre. Pour obtenir la liste des valeurs possibles, consultez la SetWindowPos fonction dans le Kit de développement logiciel (SDK) Windows.

Valeur de retour

TRUE si les styles de fenêtre étendus sont modifiés ; sinon, FALSE.

Notes

Les styles à ajouter ou à supprimer peuvent être combinés à l’aide de l’opérateur « ou » au| niveau du bit. Pour plus d’informations sur les styles étendus disponibles, consultez la CreateWindowEx fonction dans le Kit de développement logiciel (SDK) Windows.

S’il nFlags n’est pas différent de zéro, ModifyStyleEx appelle la fonction SetWindowPosWin32 et redessine la fenêtre en combinant nFlags avec les quatre indicateurs suivants :

SWP_NOSIZE Conserve la taille actuelle.
SWP_NOMOVE Conserve la position actuelle.
SWP_NOZORDER Conserve l’ordre Z actuel.
SWP_NOACTIVATE N’active pas la fenêtre.

Pour modifier des fenêtres à l’aide de styles de fenêtre standard, appelez ModifyStyle.

Exemple

//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`

Modifie la taille et la position de la fenêtre.

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

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

Notes

Pour un objet de fenêtre de niveau supérieur, les x paramètres et y les paramètres sont relatifs au coin supérieur gauche de l’écran. Pour un objet de fenêtre enfant, ils sont relatifs au coin supérieur gauche de la zone cliente de la fenêtre parente.

La deuxième version de cette méthode utilise une RECT structure pour déterminer la nouvelle position, la largeur et la hauteur de la fenêtre.

`CWindow::NextDlgCtrl`

Définit le focus clavier sur le contrôle suivant dans la boîte de dialogue.

void NextDlgCtrl() const throw();

Notes

Consultez WM_NEXTDLGCTL le Kit de développement logiciel (SDK) Windows.

`CWindow::OpenClipboard`

Ouvre le Presse-papiers.

BOOL OpenClipboard() throw();

Notes

Consultez OpenClipboard le Kit de développement logiciel (SDK) Windows.

`CWindow::operator HWND`

Convertit un CWindow objet en HWNDun .

operator HWND() const throw();

`CWindow::operator =`

Affecte un HWND objet en CWindow définissant le m_hWnd membre sur hWnd.

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

`CWindow::PostMessage`

Place un message dans la file d’attente de messages associée au thread qui a créé la fenêtre.

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

Notes

Consultez PostMessage le Kit de développement logiciel (SDK) Windows.

Retourne sans attendre que le thread traite le message.

Exemple

//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`

Définit le focus clavier sur le contrôle précédent dans la boîte de dialogue.

void PrevDlgCtrl() const throw();

Notes

Consultez WM_NEXTDLGCTL le Kit de développement logiciel (SDK) Windows.

`CWindow::Print`

Envoie un WM_PRINT message à la fenêtre pour demander qu’elle se dessine dans le contexte de l’appareil spécifié.

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

Paramètres

hDC
[in] Handle vers un contexte d’appareil.

dwFlags
[in] Spécifie les options de dessin. Vous pouvez combiner un ou plusieurs des indicateurs suivants :

PRF_CHECKVISIBLE Dessinez la fenêtre uniquement si elle est visible.
PRF_CHILDREN Dessinez toutes les fenêtres enfants visibles.
PRF_CLIENT Dessinez la zone cliente de la fenêtre.
PRF_ERASEBKGND Effacez l’arrière-plan avant de dessiner la fenêtre.
PRF_NONCLIENT Dessinez la zone non cliente de la fenêtre.
PRF_OWNED Dessinez toutes les fenêtres détenues.

`CWindow::PrintClient`

Envoie un WM_PRINTCLIENT message à la fenêtre pour demander qu’elle dessine sa zone cliente dans le contexte d’appareil spécifié.

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

Paramètres

hDC
[in] Handle vers un contexte d’appareil.

dwFlags
[in] Spécifie les options de dessin. Vous pouvez combiner un ou plusieurs des indicateurs suivants :

PRF_CHECKVISIBLE Dessinez la fenêtre uniquement si elle est visible.
PRF_CHILDREN Dessinez toutes les fenêtres enfants visibles.
PRF_CLIENT Dessinez la zone cliente de la fenêtre.
PRF_ERASEBKGND Effacez l’arrière-plan avant de dessiner la fenêtre.
PRF_NONCLIENT Dessinez la zone non cliente de la fenêtre.
PRF_OWNED Dessinez toutes les fenêtres détenues.

`CWindow::rcDefault`

Contient les dimensions de fenêtre par défaut.

static RECT rcDefault;

`CWindow::RedrawWindow`

Met à jour un rectangle ou une région spécifié dans la zone cliente.

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

throw()

Notes

Consultez RedrawWindow le Kit de développement logiciel (SDK) Windows.

Exemple

//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`

Libère un contexte d’appareil.

int ReleaseDC(HDC hDC);

Notes

Consultez ReleaseDC le Kit de développement logiciel (SDK) Windows.

Exemple

// 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`

Redimensionne la fenêtre à la taille de la zone cliente spécifiée.

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

Paramètres

nWidth
Nouvelle largeur de la fenêtre en pixels.

nHeight
Nouvelle hauteur de la fenêtre en pixels.

bRedraw
Indicateur indiquant s’il faut redessiner les modifications. La valeur par défaut est FALSE, indiquant que la fenêtre ne redessine pas les modifications.

`CWindow::ScreenToClient`

Convertit les coordonnées de l’écran en coordonnées clientes.

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

Notes

Consultez ScreenToClient le Kit de développement logiciel (SDK) Windows.

La deuxième version de cette méthode vous permet de convertir les coordonnées d’une RECT structure.

`CWindow::ScrollWindow`

Fait défiler la zone cliente spécifiée.

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

Notes

Consultez ScrollWindow le Kit de développement logiciel (SDK) Windows.

`CWindow::ScrollWindowEx`

Fait défiler la zone cliente spécifiée avec des fonctionnalités supplémentaires.

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

Notes

Consultez ScrollWindowEx le Kit de développement logiciel (SDK) Windows.

`CWindow::SendDlgItemMessage`

Envoie un message à un contrôle.

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

Notes

Consultez SendDlgItemMessage le Kit de développement logiciel (SDK) Windows.

`CWindow::SendMessage`

Envoie un message à la fenêtre et ne retourne pas tant que la procédure de fenêtre n’a pas traité le message.

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

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

Notes

Consultez SendMessage le Kit de développement logiciel (SDK) Windows.

Exemple

// 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`

Envoie le message spécifié à tous les enfants immédiats de l’objet CWindow .

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

Paramètres

message
[in] Message à envoyer.

wParam
[in] Informations supplémentaires spécifiques aux messages.

lParam
[in] Informations supplémentaires spécifiques aux messages.

bDeep
[in] Si TRUE (valeur par défaut), le message est envoyé à toutes les fenêtres descendantes ; sinon, il est envoyé uniquement aux fenêtres enfants immédiates.

Notes

Si bDeep c’est TRUEle cas, le message est également envoyé à toutes les autres fenêtres descendantes.

`CWindow::SendNotifyMessage`

Envoie un message à la fenêtre.

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

Notes

Consultez SendNotifyMessage le Kit de développement logiciel (SDK) Windows.

Si la fenêtre a été créée par le thread appelant, SendNotifyMessage ne retourne pas tant que la procédure de fenêtre n’a pas traité le message. Sinon, elle retourne immédiatement.

`CWindow::SetActiveWindow`

Active la fenêtre.

HWND SetActiveWindow() throw();

Notes

Consultez SetActiveWindow le Kit de développement logiciel (SDK) Windows.

Exemple

// 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`

Envoie toutes les entrées de souris suivantes à la fenêtre.

HWND SetCapture() throw();

Notes

Consultez SetCapture le Kit de développement logiciel (SDK) Windows.

`CWindow::SetClipboardViewer`

Ajoute la fenêtre à la chaîne de visionneuse du Presse-papiers.

HWND SetClipboardViewer() throw();

Notes

Consultez SetClipboardViewer le Kit de développement logiciel (SDK) Windows.

`CWindow::SetDlgCtrlID`

Définit l’identificateur de la fenêtre sur la valeur spécifiée.

int SetDlgCtrlID(int nID) throw();

Paramètres

nID
[in] Nouvelle valeur à définir pour l’identificateur de la fenêtre.

Valeur de retour

En cas de réussite, l’identificateur précédent de la fenêtre ; sinon 0.

`CWindow::SetDlgItemInt`

Remplace le texte d’un contrôle par la représentation sous forme de chaîne d’une valeur entière.

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

Notes

Consultez SetDlgItemInt le Kit de développement logiciel (SDK) Windows.

`CWindow::SetDlgItemText`

Modifie le texte d’un contrôle.

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

Notes

Consultez SetDlgItemText le Kit de développement logiciel (SDK) Windows.

`CWindow::SetFocus`

Définit le focus d’entrée sur la fenêtre.

HWND SetFocus() throw();

Notes

Consultez SetFocus le Kit de développement logiciel (SDK) Windows.

Exemple

//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`

Modifie la police actuelle de la fenêtre en envoyant un WM_SETFONT message à la fenêtre.

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

Paramètres

hFont
[in] Handle de la nouvelle police.

bRedraw
[in] Si TRUE (valeur par défaut), la fenêtre est redessinée. Sinon, ce n’est pas le cas.

`CWindow::SetHotKey`

Associe une touche active à la fenêtre en envoyant un WM_SETHOTKEY message.

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

Paramètres

wVirtualKeyCode
[in] Code de clé virtuelle de la clé chaude. Pour obtenir la liste des codes de clé virtuelle standard, consultez Winuser.h.

wModifiers
[in] Modificateurs de la touche chaude. Pour obtenir la liste des valeurs possibles, consultez WM_SETHOTKEY le Kit de développement logiciel (SDK) Windows.

Valeur de retour

Pour obtenir la liste des valeurs de retour possibles, consultez WM_SETHOTKEY le Kit de développement logiciel (SDK) Windows.

`CWindow::SetIcon`

Définit l’icône grande ou petite de la fenêtre sur l’icône identifiée par hIcon.

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

Paramètres

hIcon
[in] Handle vers une nouvelle icône.

bBigIcon
[in] Si TRUE (valeur par défaut), la méthode définit une icône volumineuse. Sinon, il définit une petite icône.

Valeur de retour

Handle de l’icône précédente.

Notes

SetIcon envoie un WM_SETICON message à la fenêtre.

`CWindow::SetMenu`

Modifie le menu actif de la fenêtre.

BOOL SetMenu(HMENU hMenu) throw();

Notes

Consultez SetMenu le Kit de développement logiciel (SDK) Windows.

`CWindow::SetParent`

Modifie la fenêtre parente.

HWND SetParent(HWND hWndNewParent) throw();

Notes

Consultez SetParent le Kit de développement logiciel (SDK) Windows.

Exemple

// 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`

Définit ou efface l’indicateur de redessination en envoyant un WM_SETREDRAW message à la fenêtre.

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

Paramètres

bRedraw
[in] Spécifie l’état de l’indicateur de redessination. Si TRUE (valeur par défaut), l’indicateur de redessination est défini ; si FALSE, l’indicateur est effacé.

Notes

Appel SetRedraw pour autoriser le redéployage des modifications ou pour empêcher le redéployage des modifications.

Exemple

//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`

Définit les paramètres d’une barre de défilement.

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

Notes

Consultez SetScrollInfo le Kit de développement logiciel (SDK) Windows.

`CWindow::SetScrollPos`

Modifie la position de la zone de défilement.

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

Notes

Consultez SetScrollPos le Kit de développement logiciel (SDK) Windows.

`CWindow::SetScrollRange`

Modifie la plage de barres de défilement.

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

Notes

Consultez SetScrollRange le Kit de développement logiciel (SDK) Windows.

`CWindow::SetTimer`

Crée un événement de minuteur.

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

Notes

Consultez SetTimer le Kit de développement logiciel (SDK) Windows.

`CWindow::SetWindowContextHelpId`

Définit l’identificateur de contexte d’aide de la fenêtre.

BOOL SetWindowContextHelpId(DWORD dwContextHelpId) throw();

Notes

Consultez SetWindowContextHelpId le Kit de développement logiciel (SDK) Windows.

`CWindow::SetWindowLong`

Définit une valeur 32 bits à un décalage spécifié dans la mémoire de fenêtre supplémentaire.

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

Notes

Consultez SetWindowLong le Kit de développement logiciel (SDK) Windows.

Remarque

Pour écrire du code compatible avec les versions 32 bits et 64 bits de Windows, utilisez CWindow::SetWindowLongPtr.

`CWindow::SetWindowLongPtr`

Modifie un attribut de la fenêtre spécifiée et définit également une valeur au décalage spécifié dans la mémoire supplémentaire de la fenêtre.

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

Notes

Consultez SetWindowLongPtr le Kit de développement logiciel (SDK) Windows.

Cette fonction remplace la CWindow::SetWindowLong méthode. Pour écrire du code compatible avec les versions 32 bits et 64 bits de Windows, utilisez CWindow::SetWindowLongPtr.

`CWindow::SetWindowPlacement`

Définit l’état et les positions d’affichage.

BOOL SetWindowPlacement(const WINDOWPLACEMENT FAR* lpwndpl);

Notes

Consultez SetWindowPlacement le Kit de développement logiciel (SDK) Windows.

`CWindow::SetWindowPos`

Définit la taille, la position et l’ordre Z.

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

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

Notes

Consultez SetWindowPos le Kit de développement logiciel (SDK) Windows.

La deuxième version de cette méthode utilise une RECT structure pour définir la nouvelle position, la largeur et la hauteur de la fenêtre.

`CWindow::SetWindowRgn`

Définit la région de la fenêtre d’une fenêtre.

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

Notes

Consultez SetWindowRgn le Kit de développement logiciel (SDK) Windows.

`CWindow::SetWindowText`

Modifie le texte de la fenêtre.

BOOL SetWindowText(LPCTSTR lpszString) throw();

Notes

Consultez SetWindowText le Kit de développement logiciel (SDK) Windows.

Exemple

//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`

Définit une valeur 16 bits à un décalage spécifié dans la mémoire de fenêtre supplémentaire.

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

Notes

Consultez SetWindowLong le Kit de développement logiciel (SDK) Windows.

`CWindow::ShowCaret`

Affiche le caret système.

BOOL ShowCaret() throw();

Notes

Consultez ShowCaret le Kit de développement logiciel (SDK) Windows.

Exemple

//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`

Affiche ou masque les fenêtres contextuelles appartenant à la fenêtre.

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

Notes

Consultez ShowOwnedPopups le Kit de développement logiciel (SDK) Windows.

`CWindow::ShowScrollBar`

Affiche ou masque une barre de défilement.

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

Notes

Consultez ShowScrollBar le Kit de développement logiciel (SDK) Windows.

`CWindow::ShowWindow`

Définit l’état d’affichage de la fenêtre.

BOOL ShowWindow(int nCmdShow) throw();

Notes

Consultez ShowWindow le Kit de développement logiciel (SDK) Windows.

Exemple

//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`

Définit l’état d’affichage d’une fenêtre créée par un autre thread.

BOOL ShowWindowAsync(int nCmdShow) throw();

Notes

Consultez ShowWindowAsync le Kit de développement logiciel (SDK) Windows.

`CWindow::UpdateWindow`

Met à jour la zone cliente.

BOOL UpdateWindow() throw();

Notes

Consultez UpdateWindow le Kit de développement logiciel (SDK) Windows.

Exemple

//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`

Valide la zone cliente dans le rectangle spécifié.

BOOL ValidateRect(LPCRECT lpRect) throw();

Notes

Consultez ValidateRect le Kit de développement logiciel (SDK) Windows.

`CWindow::ValidateRgn`

Valide la zone cliente dans la région spécifiée.

BOOL ValidateRgn(HRGN hRgn) throw();

Notes

Consultez ValidateRgn le Kit de développement logiciel (SDK) Windows.

`CWindow::WinHelp`

Démarre l’aide de Windows.

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

Notes

Consultez WinHelp le Kit de développement logiciel (SDK) Windows.

Voir aussi

Vue d’ensemble de la classe

Partager via

La classe CWindow

Syntaxe

Membres

Constructeurs publics

Méthodes publiques

Opérateurs publics

Membres de données publics

Notes

Spécifications

CWindow::ArrangeIconicWindows

Notes

CWindow::Attach

Paramètres

Exemple

CWindow::BeginPaint

Notes

Exemple

CWindow::BringWindowToTop

Notes

Exemple

CWindow::CenterWindow

Paramètres

Valeur de retour

Exemple

CWindow::ChangeClipboardChain

Notes

CWindow::CheckDlgButton

Notes

CWindow::CheckRadioButton

Notes

CWindow::ChildWindowFromPoint

Notes

CWindow::ChildWindowFromPointEx

Notes

CWindow::ClientToScreen

Notes

CWindow::Create

Paramètres

Valeur de retour

Notes

CWindow::CreateCaret

Notes

CWindow::CreateGrayCaret

Notes

CWindow::CreateSolidCaret

Notes

CWindow::CWindow

Paramètres

Notes

CWindow::DeferWindowPos

Notes

CWindow::DestroyWindow

Notes

Exemple

CWindow::Detach

Valeur de retour

Exemple

CWindow::DlgDirList

Notes

CWindow::DlgDirListComboBox

Notes

CWindow::DlgDirSelect

Notes

CWindow::DlgDirSelectComboBox

Notes

CWindow::DragAcceptFiles

Notes

CWindow::DrawMenuBar

Notes

CWindow::EnableScrollBar

Notes

CWindow::EnableWindow

Notes

Exemple

CWindow::EndPaint

Notes

Exemple

CWindow::FlashWindow

Notes

La classe `CWindow`

`CWindow::ArrangeIconicWindows`

`CWindow::Attach`

`CWindow::BeginPaint`

`CWindow::BringWindowToTop`

`CWindow::CenterWindow`

`CWindow::ChangeClipboardChain`

`CWindow::CheckDlgButton`

`CWindow::CheckRadioButton`

`CWindow::ChildWindowFromPoint`

`CWindow::ChildWindowFromPointEx`

`CWindow::ClientToScreen`

`CWindow::Create`

`CWindow::CreateCaret`

`CWindow::CreateGrayCaret`

`CWindow::CreateSolidCaret`

`CWindow::CWindow`

`CWindow::DeferWindowPos`

`CWindow::DestroyWindow`

`CWindow::Detach`

`CWindow::DlgDirList`

`CWindow::DlgDirListComboBox`

`CWindow::DlgDirSelect`

`CWindow::DlgDirSelectComboBox`

`CWindow::DragAcceptFiles`

`CWindow::DrawMenuBar`

`CWindow::EnableScrollBar`

`CWindow::EnableWindow`

`CWindow::EndPaint`

`CWindow::FlashWindow`

`CWindow::GetClientRect`

`CWindow::GetDC`

`CWindow::GetDCEx`

`CWindow::GetDescendantWindow`

`CWindow::GetDlgControl`

`CWindow::GetDlgCtrlID`

`CWindow::GetDlgHost`

`CWindow::GetDlgItem`

`CWindow::GetDlgItemInt`

`CWindow::GetDlgItemText`

`CWindow::GetExStyle`

`CWindow::GetFont`

`CWindow::GetHotKey`

`CWindow::GetIcon`

`CWindow::GetLastActivePopup`

`CWindow::GetMenu`

`CWindow::GetNextDlgGroupItem`

`CWindow::GetNextDlgTabItem`

`CWindow::GetParent`

`CWindow::GetScrollInfo`

`CWindow::GetScrollPos`

`CWindow::GetScrollRange`

`CWindow::GetStyle`

`CWindow::GetSystemMenu`

`CWindow::GetTopLevelParent`

`CWindow::GetTopLevelWindow`

`CWindow::GetTopWindow`