Clase `CWindow`

Artículo
04/03/2023

Esta clase proporciona métodos para manipular una ventana.

Importante

Esta clase y sus miembros no se pueden usar en las aplicaciones que se ejecutan en Windows Runtime.

Sintaxis

class CWindow

Miembros

Constructores públicos

Nombre	Descripción
`CWindow::CWindow`	Constructor.

Métodos públicos

Nombre	Descripción
`CWindow::ArrangeIconicWindows`	Organiza todas las ventanas secundarias minimizadas.
`CWindow::Attach`	Asocia una ventana al objeto `CWindow`.
`CWindow::BeginPaint`	Prepara la ventana para pintar.
`CWindow::BringWindowToTop`	Lleva la ventana arriba del orden Z.
`CWindow::CenterWindow`	Centra la ventana en una ventana determinada.
`CWindow::ChangeClipboardChain`	Quita la ventana de la cadena de visores del Portapapeles.
`CWindow::CheckDlgButton`	Cambia el estado de comprobación del botón especificado.
`CWindow::CheckRadioButton`	Comprueba el botón de radio especificado.
`CWindow::ChildWindowFromPoint`	Recupera la ventana secundaria que contiene el punto especificado.
`CWindow::ChildWindowFromPointEx`	Recupera un tipo determinado de ventana secundaria que contiene el punto especificado.
`CWindow::ClientToScreen`	Convierte las coordenadas de cliente en coordenadas de pantalla.
`CWindow::Create`	Crea una ventana.
`CWindow::CreateCaret`	Crea una nueva forma para el símbolo de inserción.
`CWindow::CreateGrayCaret`	Crea un rectángulo gris para el símbolo de inserción.
`CWindow::CreateSolidCaret`	Crea un rectángulo sólido para el símbolo de inserción.
`CWindow::DeferWindowPos`	Actualiza la estructura de posición de varias ventanas especificada para la ventana especificada.
`CWindow::DestroyWindow`	Destruye la ventana asociada al objeto `CWindow`.
`CWindow::Detach`	Desasocia la ventana del objeto `CWindow`.
`CWindow::DlgDirList`	Rellena un cuadro de lista con los nombres de todos los archivos que coinciden con una ruta de acceso o un nombre de archivo especificados.
`CWindow::DlgDirListComboBox`	Rellena un cuadro combinado con los nombres de todos los archivos que coinciden con una ruta de acceso o un nombre de archivo especificados.
`CWindow::DlgDirSelect`	Recupera la selección actual de un cuadro de lista.
`CWindow::DlgDirSelectComboBox`	Recupera la selección actual de un cuadro combinado.
`CWindow::DragAcceptFiles`	Registra si la ventana acepta archivos arrastrados.
`CWindow::DrawMenuBar`	Vuelve a dibujar la barra de menús de la ventana.
`CWindow::EnableScrollBar`	Habilita o deshabilita las flechas de la barra de desplazamiento.
`CWindow::EnableWindow`	Habilita o deshabilita la entrada.
`CWindow::EndPaint`	Marca el final de la pintura.
`CWindow::FlashWindow`	Hace que la ventana parpadee una vez.
`CWindow::GetClientRect`	Recupera las coordenadas del área cliente.
`CWindow::GetDC`	Recupera un contexto de dispositivo del área cliente.
`CWindow::GetDCEx`	Recupera un contexto de dispositivo del área cliente y permite opciones de recorte.
`CWindow::GetDescendantWindow`	Recupera la ventana descendiente especificada.
`CWindow::GetDlgControl`	Recupera una interfaz del control especificado.
`CWindow::GetDlgCtrlID`	Recupera el identificador de la ventana (solo para ventanas secundarias).
`CWindow::GetDlgHost`	Recupera un puntero a una interfaz del contenedor de hospedaje de controles ATL.
`CWindow::GetDlgItem`	Recupera la ventana secundaria especificada.
`CWindow::GetDlgItemInt`	Convierte el texto de un control en un entero.
`CWindow::GetDlgItemText`	Recupera el texto de un control.
`CWindow::GetExStyle`	Recupera los estilos de ventana extendidos.
`CWindow::GetFont`	Recupera la fuente actual de la ventana.
`CWindow::GetHotKey`	Determina la tecla de acceso rápido asociada a la ventana.
`CWindow::GetIcon`	Recupera el icono grande o pequeño de la ventana.
`CWindow::GetLastActivePopup`	Recupera la ventana emergente activa más recientemente.
`CWindow::GetMenu`	Recupera el menú de la ventana.
`CWindow::GetNextDlgGroupItem`	Recupera el control anterior o siguiente dentro de un grupo de controles.
`CWindow::GetNextDlgTabItem`	Recupera el control anterior o siguiente que tiene el estilo `WS_TABSTOP`.
`CWindow::GetParent`	Recupera la ventana principal inmediata.
`CWindow::GetScrollInfo`	Recupera los parámetros de una barra de desplazamiento.
`CWindow::GetScrollPos`	Recupera la posición del cuadro de desplazamiento.
`CWindow::GetScrollRange`	Recupera el intervalo de barras de desplazamiento.
`CWindow::GetStyle`	Recupera los estilos de ventana.
`CWindow::GetSystemMenu`	Crea una copia del menú del sistema para su modificación.
`CWindow::GetTopLevelParent`	Recupera la ventana principal o propietaria de nivel superior.
`CWindow::GetTopLevelWindow`	Recupera la ventana propietaria de nivel superior.
`CWindow::GetTopWindow`	Recupera la ventana secundaria de nivel superior.
`CWindow::GetUpdateRect`	Recupera las coordenadas del rectángulo más pequeño que contiene completamente la región de actualización.
`CWindow::GetUpdateRgn`	Recupera la región de actualización y la copia en una región especificada.
`CWindow::GetWindow`	Recupera la ventana especificada.
`CWindow::GetWindowContextHelpId`	Recupera el identificador de contexto de Ayuda de la ventana.
`CWindow::GetWindowDC`	Recupera un contexto de dispositivo para toda la ventana.
`CWindow::GetWindowLong`	Recupera un valor de 32 bits en un desplazamiento especificado en la memoria de ventana adicional.
`CWindow::GetWindowLongPtr`	Recupera información sobre la ventana especificada, incluido un valor en un desplazamiento especificado en la memoria de ventana adicional.
`CWindow::GetWindowPlacement`	Recupera el estado de presentación y las posiciones.
`CWindow::GetWindowProcessID`	Recupera el identificador del proceso que creó la ventana.
`CWindow::GetWindowRect`	Recupera las dimensiones delimitadoras de la ventana.
`CWindow::GetWindowRgn`	Recupera una copia de la región de ventana de una ventana.
`CWindow::GetWindowText`	Recupera el texto de la ventana.
`CWindow::GetWindowTextLength`	Recupera la longitud del texto de la ventana.
`CWindow::GetWindowThreadID`	Recupera el identificador del subproceso que creó la ventana especificada.
`CWindow::GetWindowWord`	Recupera un valor de 16 bits en un desplazamiento especificado en la memoria de ventana adicional.
`CWindow::GotoDlgCtrl`	Establece el foco del teclado en un control del cuadro de diálogo.
`CWindow::HideCaret`	Oculta el símbolo de inserción.
`CWindow::HiliteMenuItem`	Resalta o quita el resaltado de un elemento de menú de nivel superior.
`CWindow::Invalidate`	Invalida toda el área cliente.
`CWindow::InvalidateRect`	Invalida el área cliente dentro del rectángulo especificado.
`CWindow::InvalidateRgn`	Invalida el área cliente dentro de la región especificada.
`CWindow::IsChild`	Determina si la ventana especificada es una ventana secundaria.
`CWindow::IsDialogMessage`	Determina si un mensaje está pensado para el cuadro de diálogo especificado.
`CWindow::IsDlgButtonChecked`	Determina el estado de comprobación del botón.
`CWindow::IsIconic`	Determina si la ventana está minimizada.
`CWindow::IsParentDialog`	Determina si la ventana principal de un control es una ventana de diálogo.
`CWindow::IsWindow`	Determina si el identificador de ventana especificado identifica una ventana existente.
`CWindow::IsWindowEnabled`	Determina si la ventana está habilitada para la entrada.
`CWindow::IsWindowUnicode`	Determina si la ventana especificada es una ventana Unicode nativa.
`CWindow::IsWindowVisible`	Determina el estado de visibilidad de la ventana.
`CWindow::IsZoomed`	Determina si la ventana está maximizada.
`CWindow::KillTimer`	Destruye un evento de temporizador.
`CWindow::LockWindowUpdate`	Deshabilita o habilita el dibujo en la ventana.
`CWindow::MapWindowPoints`	Convierte un conjunto de puntos del espacio de coordenadas de la ventana al espacio de coordenadas de otra ventana.
`CWindow::MessageBox`	Muestra un cuadro de mensaje.
`CWindow::ModifyStyle`	Modifica los estilos de ventana.
`CWindow::ModifyStyleEx`	Modifica los estilos de ventana extendidos.
`CWindow::MoveWindow`	Cambia el tamaño y la posición de la ventana.
`CWindow::NextDlgCtrl`	Establece el foco del teclado en el siguiente control del cuadro de diálogo.
`CWindow::OpenClipboard`	Abre el Portapapeles.
`CWindow::PostMessage`	Coloca un mensaje en la cola de mensajes asociada al subproceso que creó la ventana. Devuelve resultados sin esperar a que el subproceso procese el mensaje.
`CWindow::PrevDlgCtrl`	Establece el foco del teclado en el control anterior del cuadro de diálogo.
`CWindow::Print`	Solicita que la ventana se dibuje en un contexto de dispositivo especificado.
`CWindow::PrintClient`	Solicita que el área cliente de la ventana se dibuje en un contexto de dispositivo especificado.
`CWindow::RedrawWindow`	Actualiza el rectángulo o la región especificados en el área cliente.
`CWindow::ReleaseDC`	Libera un contexto de dispositivo.
`CWindow::ResizeClient`	Cambia el tamaño de la ventana.
`CWindow::ScreenToClient`	Convierte las coordenadas de la pantalla en coordenadas de cliente.
`CWindow::ScrollWindow`	Desplaza el área cliente especificada.
`CWindow::ScrollWindowEx`	Desplaza el área cliente especificada con características adicionales.
`CWindow::SendDlgItemMessage`	Envía un mensaje a un control.
`CWindow::SendMessage`	Envía un mensaje a la ventana y no devuelve resultados hasta que el procedimiento de ventana haya procesado el mensaje.
`CWindow::SendMessageToDescendants`	Envía un mensaje a las ventanas descendientes especificadas.
`CWindow::SendNotifyMessage`	Envía un mensaje a la ventana. Si el subproceso que realiza la llamada creó la ventana, `SendNotifyMessage` no devuelve resultados hasta que el procedimiento de ventana haya procesado el mensaje. De lo contrario, devuelve resultados inmediatamente.
`CWindow::SetActiveWindow`	Activa la ventana.
`CWindow::SetCapture`	Envía todas las entradas posteriores del mouse a la ventana.
`CWindow::SetClipboardViewer`	Agrega la ventana a la cadena de visores del Portapapeles.
`CWindow::SetDlgCtrlID`	Cambia el identificador de la ventana.
`CWindow::SetDlgItemInt`	Cambia el texto de un control a la representación de cadena de un valor entero.
`CWindow::SetDlgItemText`	Cambia el texto de un control.
`CWindow::SetFocus`	Establece el foco de entrada en la ventana.
`CWindow::SetFont`	Cambia la fuente actual de la ventana.
`CWindow::SetHotKey`	Asocia una tecla activa a la ventana.
`CWindow::SetIcon`	Cambia el icono grande o pequeño de la ventana.
`CWindow::SetMenu`	Cambia el menú actual de la ventana.
`CWindow::SetParent`	Cambia la ventana primaria.
`CWindow::SetRedraw`	Establece o borra la marca de volver a dibujar.
`CWindow::SetScrollInfo`	Establece los parámetros de una barra de desplazamiento.
`CWindow::SetScrollPos`	Cambia la posición del cuadro de desplazamiento.
`CWindow::SetScrollRange`	Cambia el intervalo de barras de desplazamiento.
`CWindow::SetTimer`	Crea un evento de temporizador.
`CWindow::SetWindowContextHelpId`	Establece el identificador de contexto de Ayuda de la ventana.
`CWindow::SetWindowLong`	Establece un valor de 32 bits en un desplazamiento especificado en la memoria de ventana adicional.
`CWindow::SetWindowLongPtr`	Cambia un atributo de la ventana especificada y también establece un valor en el desplazamiento especificado en la memoria de ventana adicional.
`CWindow::SetWindowPlacement`	Establece el estado de presentación y las posiciones.
`CWindow::SetWindowPos`	Establece el tamaño, la posición y el orden Z.
`CWindow::SetWindowRgn`	Establece la región de una ventana.
`CWindow::SetWindowText`	Cambia el texto de la ventana.
`CWindow::SetWindowWord`	Establece un valor de 16 bits en un desplazamiento especificado en la memoria de ventana adicional.
`CWindow::ShowCaret`	Muestra el símbolo de inserción.
`CWindow::ShowOwnedPopups`	Muestra u oculta las ventanas emergentes propiedad de la ventana.
`CWindow::ShowScrollBar`	Muestra u oculta una barra de desplazamiento.
`CWindow::ShowWindow`	Establece el estado de presentación de la ventana.
`CWindow::ShowWindowAsync`	Establece el estado de presentación de una ventana creada por un subproceso diferente.
`CWindow::UpdateWindow`	Actualiza el área de cliente.
`CWindow::ValidateRect`	Valida el área cliente dentro del rectángulo especificado.
`CWindow::ValidateRgn`	Valida el área cliente dentro de la región especificada.
`CWindow::WinHelp`	Inicia la Ayuda de Windows.

Operadores públicos

Nombre	Descripción
`CWindow::operator HWND`	Convierte el objeto `HWND` en un objeto `CWindow`.
`CWindow::operator =`	Asigna un valor `HWND` al objeto `CWindow`.

Miembros de datos públicos

Nombre	Descripción
`CWindow::m_hWnd`	Identificador de la ventana asociada al objeto `CWindow`.
`CWindow::rcDefault`	Contiene dimensiones de ventana predeterminadas.

Comentarios

CWindow proporciona la funcionalidad base para manipular una ventana en ATL. Muchos de los métodos CWindow simplemente encapsulan una de las funciones de la API Win32. Por ejemplo, compare los prototipos de CWindow::ShowWindow y ShowWindow:

Método CWindow	Función de Win32
`BOOL ShowWindow( int nCmdShow );`	`BOOL ShowWindow( HWND hWnd , int nCmdShow );`

CWindow::ShowWindow llama a la función ShowWindow de Win32 pasando CWindow::m_hWnd como primer parámetro. Todos los métodos CWindow que encapsulan directamente una función de Win32 pasan el miembro m_hWnd; por lo tanto, gran parte de la documentación de CWindow le remitirá Windows SDK.

Nota:

No todas las funciones de Win32 relacionadas con ventanas están encapsuladas en CWindow, y no todos los métodos CWindow encapsulan una función de Win32.

CWindow::m_hWnd almacena el valor HWND que identifica una ventana. Se asocia un valor HWND al objeto en las siguientes circunstancias:

Especifica un valor HWND el constructor de CWindow.
Llame a CWindow::Attach.
Usa el valor operator = de CWindow.
Crea o establece una subclase para una ventana con una de las siguientes clases derivadas de CWindow:

CWindowImpl Permite crear una nueva ventana o una subclase de una ventana existente.

CContainedWindow Implementa una ventana contenida dentro de otro objeto. Puede crear una nueva ventana o establecer una subclase para una ventana existente.

CDialogImpl Permite crear un cuadro de diálogo modal o sin modo.

Para más información sobre las ventanas, consulte Ventanas y los temas posteriores de Windows SDK. Para más información sobre el uso de ventanas en ATL, consulte el artículo Clases de ventanas de ATL.

Requisitos

Encabezado: atlwin.h

`CWindow::ArrangeIconicWindows`

Organiza todas las ventanas secundarias minimizadas.

UINT ArrangeIconicWindows() throw();

Comentarios

Consulte el método ArrangeIconicWindows de Windows SDK.

`CWindow::Attach`

Asocia la ventana identificada por hWndNew al objeto CWindow.

void Attach(HWND hWndNew) throw();

Parámetros

hWndNew
[in] Identificador de una ventana.

Ejemplo

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

`CWindow::BeginPaint`

Prepara la ventana para pintar.

HDC BeginPaint(LPPAINTSTRUCT lpPaint) throw();

Comentarios

Consulte el método BeginPaint de Windows SDK.

Ejemplo

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

Lleva la ventana arriba del orden Z.

BOOL BringWindowToTop() throw();

Comentarios

Consulte el método BringWindowToTop de Windows SDK.

Ejemplo

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

Centra la ventana en una ventana determinada.

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

Parámetros

hWndCenter
[in] Identificador de la ventana en la que se va a centrar. Si este parámetro es NULL (el valor predeterminado), el método establecerá hWndCenter en la ventana principal de la ventana si se trata de una ventana secundaria. De lo contrario, establecerá hWndCenter en la ventana propietaria de la ventana.

Valor devuelto

TRUE si la ventana se centra correctamente; de lo contrario, FALSE.

Ejemplo

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

Quita la ventana de la cadena de visores del Portapapeles.

BOOL ChangeClipboardChain(HWND hWndNewNext) throw();

Comentarios

Consulte el método ChangeClipboardChain de Windows SDK.

`CWindow::CheckDlgButton`

Cambia el estado de comprobación del botón especificado.

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

Comentarios

Consulte el método CheckDlgButton de Windows SDK.

`CWindow::CheckRadioButton`

Comprueba el botón de radio especificado.

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

Comentarios

Consulte el método CheckRadioButton de Windows SDK.

`CWindow::ChildWindowFromPoint`

Recupera la ventana secundaria que contiene el punto especificado.

HWND ChildWindowFromPoint(POINT point) const throw();

Comentarios

Consulte el método ChildWindowFromPoint de Windows SDK.

`CWindow::ChildWindowFromPointEx`

Recupera un tipo determinado de ventana secundaria que contiene el punto especificado.

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

Comentarios

Consulte el método ChildWindowFromPointEx de Windows SDK.

`CWindow::ClientToScreen`

Convierte las coordenadas de cliente en coordenadas de pantalla.

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

Comentarios

Consulte el método ClientToScreen de Windows SDK.

La segunda versión de este método permite convertir las coordenadas de una estructura RECT.

`CWindow::Create`

Crea una ventana.

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

Parámetros

lpstrWndClass
[in] Puntero a la clase de la ventana.

hWndParent
[in] Identificador de la ventana primaria o propietaria.

rect
[in] Variable de tipo _U_RECT que especifica la posición de la ventana. El valor predeterminado es NULL. Cuando este parámetro es NULL, se usa el valor de CWindow::rcDefault.

szWindowName
[in] Especifica el nombre de la ventana. El valor predeterminado es NULL.

dwStyle
[in] El estilo de la ventana. El valor predeterminado es 0, lo que significa que no se especifica ningún estilo. Para ver una lista de valores posibles, consulte CreateWindow en Windows SDK.

dwExStyle
[in] Estilos extendidos de la ventana. El valor predeterminado es 0, lo que significa que no se especifica ningún estilo extendido. Para ver una lista de valores posibles, consulte CreateWindowEx en Windows SDK.

MenuOrID
[in] Variable de tipo _U_MENUorID que especifica un identificador de un menú o un identificador de ventana. El valor predeterminado es 0U.

lpCreateParam
Puntero a los datos de creación de ventanas contenidos en una estructura CREATESTRUCT.

Valor devuelto

Si se ejecuta correctamente, el identificador de la ventana recién creada, especificado por m_hWnd. En caso contrario, es NULL.

Comentarios

CWindow::rcDefault se define como __declspec(selectany) RECT CWindow::rcDefault = {CW_USEDEFAULT, CW_USEDEFAULT, 0, 0};.

Para obtener más información, consulte el método CreateWindow en Windows SDK.

Nota Si se usa 0 como valor del parámetro MenuOrID, debe especificarse como 0U (el valor predeterminado) para evitar un error del compilador.

`CWindow::CreateCaret`

Crea una nueva forma para el símbolo de inserción.

BOOL CreateCaret(HBITMAP pBitmap) throw();

Comentarios

Consulte el método CreateCaret de Windows SDK.

`CWindow::CreateGrayCaret`

Crea un rectángulo gris para el símbolo de inserción.

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

Comentarios

Consulte el método CreateCaret de Windows SDK.

Pasa (HBITMAP) 1 para el parámetro de identificador de mapa de bits a la función de Win32.

`CWindow::CreateSolidCaret`

Crea un rectángulo sólido para el símbolo de inserción.

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

Comentarios

Consulte el método CreateCaret de Windows SDK.

Pasa (HBITMAP) 0 para el parámetro de identificador de mapa de bits a la función de Win32.

`CWindow::CWindow`

Constructor .

CWindow(HWND hWnd = NULL) throw();

Parámetros

hWnd
[in] Identificador de una ventana.

Comentarios

Inicializa el miembro m_hWnd en hWnd, que de forma predeterminada es NULL.

Nota:

CWindow::CWindow no crea una ventana. Las clases CWindowImpl, CContainedWindow y CDialogImpl (todas las cuales derivan de CWindow) proporcionan un método para crear una ventana o un cuadro de diálogo, que luego se asigna a CWindow::m_hWnd. También puede usar la función de Win32 CreateWindow.

`CWindow::DeferWindowPos`

Actualiza la estructura de posición de varias ventanas especificada para la ventana especificada.

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

Comentarios

Consulte el método DeferWindowPos de Windows SDK.

`CWindow::DestroyWindow`

Destruye la ventana asociada al objeto CWindow y establece m_hWnd en NULL.

BOOL DestroyWindow() throw();

Comentarios

Consulte el método DestroyWindow de Windows SDK.

No destruye el objeto CWindow propiamente dicho.

Ejemplo

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

Desasocia m_hWnd del objeto CWindow y establece m_hWnd en NULL.

HWND Detach() throw();

Valor devuelto

Objeto HWND asociado al objeto CWindow.

Ejemplo

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

Rellena un cuadro de lista con los nombres de todos los archivos que coinciden con una ruta de acceso o un nombre de archivo especificados.

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

Comentarios

Consulte el método DlgDirList de Windows SDK.

`CWindow::DlgDirListComboBox`

Rellena un cuadro combinado con los nombres de todos los archivos que coinciden con una ruta de acceso o un nombre de archivo especificados.

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

Comentarios

Consulte el método DlgDirListComboBox de Windows SDK.

`CWindow::DlgDirSelect`

Recupera la selección actual de un cuadro de lista.

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

Comentarios

Consulte el método DlgDirSelectEx de Windows SDK.

`CWindow::DlgDirSelectComboBox`

Recupera la selección actual de un cuadro combinado.

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

Comentarios

Consulte el método DlgDirSelectComboBoxEx de Windows SDK.

`CWindow::DragAcceptFiles`

Registra si la ventana acepta archivos arrastrados.

void DragAcceptFiles(BOOL bAccept = TRUE);

Comentarios

Consulte el método DragAcceptFiles de Windows SDK.

`CWindow::DrawMenuBar`

Vuelve a dibujar la barra de menús de la ventana.

BOOL DrawMenuBar() throw();

Comentarios

Consulte el método DrawMenuBar de Windows SDK.

`CWindow::EnableScrollBar`

Habilita o deshabilita las flechas de la barra de desplazamiento.

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

Comentarios

Consulte el método EnableScrollBar de Windows SDK.

`CWindow::EnableWindow`

Habilita o deshabilita la entrada.

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

Comentarios

Consulte el método EnableWindow de Windows SDK.

Ejemplo

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

Marca el final de la pintura.

void EndPaint(LPPAINTSTRUCT lpPaint) throw();

Comentarios

Consulte el método EndPaint de Windows SDK.

Ejemplo

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

Hace que la ventana parpadee una vez.

BOOL FlashWindow(BOOL bInvert) throw();

Comentarios

Consulte el método FlashWindow de Windows SDK.

`CWindow::GetClientRect`

Recupera las coordenadas del área cliente.

BOOL GetClientRect(LPRECT lpRect) const throw();

Comentarios

Consulte el método GetClientRect de Windows SDK.

Ejemplo

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

Recupera un contexto de dispositivo del área cliente.

HDC GetDC() throw();

Comentarios

Consulte el método GetDC de Windows SDK.

Ejemplo

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

Recupera un contexto de dispositivo del área cliente y permite opciones de recorte.

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

Comentarios

Consulte el método GetDCEx de Windows SDK.

`CWindow::GetDescendantWindow`

Busca la ventana descendiente especificada por el identificador especificado.

HWND GetDescendantWindow(int nID) const throw();

Parámetros

nID
[in] Identificador de la ventana descendiente que se va a recuperar.

Valor devuelto

Identificador de una ventana descendiente.

Comentarios

GetDescendantWindow busca en todo el árbol de ventanas secundarias, no solo las ventanas que son elementos secundarios inmediatos.

`CWindow::GetDlgControl`

Llame a esta función para obtener un puntero a una interfaz de un control ActiveX hospedado por un control compuesto o un cuadro de diálogo de hospedaje de controles.

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

Parámetros

nID
[in] Identificador de recurso del control que se va a recuperar.

iid
[in] Identificador de la interfaz que quiere obtener del control.

ppCtrl
[out] Puntero a la interfaz.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente o cualquier error válido HRESULT. Por ejemplo, la función devuelve E_FAIL si no se encuentra el control especificado por nID y devuelve E_NOINTERFACE si se puede encontrar el control, pero no admite la interfaz especificada por iid.

Comentarios

Con este puntero, puede llamar a métodos de la interfaz.

`CWindow::GetDlgCtrlID`

Recupera el identificador de la ventana (solo para ventanas secundarias).

int GetDlgCtrlID() const throw();

Comentarios

Consulte el método GetDlgCtrlID de Windows SDK.

`CWindow::GetDlgHost`

Recupera un puntero a una interfaz del contenedor de hospedaje de controles ATL.

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

Parámetros

nID
[in] Identificador de recurso del control que se va a recuperar.

iid
[in] Identificador de la interfaz que quiere obtener del control.

ppHost
[out] Puntero a la interfaz.

Valor devuelto

Devuelve S_OK si la ventana especificada por iid es un contenedor de controles y se puede recuperar la interfaz solicitada. Devuelve E_FAIL si la ventana no es un contenedor de controles o si no se pudo recuperar la interfaz solicitada. Si no se ha podido encontrar una ventana con el identificador especificado, el valor devuelto es igual a HRESULT_FROM_WIN32(ERROR_CONTROL_ID_NOT_FOUND).

Comentarios

Con este puntero, puede llamar a métodos de la interfaz.

`CWindow::GetDlgItem`

Recupera la ventana secundaria especificada.

HWND GetDlgItem(int nID) const throw();

Comentarios

Consulte GetDlgItem en Windows SDK.

`CWindow::GetDlgItemInt`

Convierte el texto de un control en un entero.

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

Comentarios

Consulte el método GetDlgItemInt de Windows SDK.

`CWindow::GetDlgItemText`

Recupera el texto de un control.

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

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

Comentarios

Para más información, consulte GetDlgItemText en Windows SDK.

La segunda versión de este método permite copiar el texto del control en un objeto BSTR. Esta versión devuelve TRUE si el texto se copia correctamente; de lo contrario, FALSE.

`CWindow::GetExStyle`

Recupera los estilos de ventana extendidos de la ventana.

DWORD GetExStyle() const throw();

Valor devuelto

El estilo extendido de ventana.

Comentarios

Para recuperar los estilos de ventana normales, llame a GetStyle.

Ejemplo

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

Recupera la fuente actual de la ventana mediante el envío de un mensaje WM_GETFONT a la ventana.

HFONT GetFont() const throw();

Valor devuelto

Identificador de fuente.

`CWindow::GetHotKey`

Determina la tecla de acceso rápido asociada a la ventana mediante el envío de un mensaje WM_GETHOTKEY.

DWORD GetHotKey() const throw();

Valor devuelto

El código de tecla virtual y los modificadores de la tecla de acceso rápido asociada a la ventana. Para ver una lista de posibles modificadores, consulte WM_GETHOTKEY en Windows SDK. Para ver una lista de códigos de tecla virtual estándar, consulte Winuser.h.

`CWindow::GetIcon`

Recupera el identificador del icono grande o pequeño de la ventana.

HICON GetIcon(BOOL bBigIcon = TRUE) const;

Parámetros

bBigIcon
[in] Si es TRUE (el valor predeterminado), el método devuelve el icono grande. De lo contrario, devuelve el icono pequeño.

Valor devuelto

Identificador de icono.

Comentarios

GetIcon envía un mensaje WM_GETICON a la ventana.

`CWindow::GetLastActivePopup`

Recupera la ventana emergente activa más recientemente.

HWND GetLastActivePopup() const throw();

Comentarios

Consulte el método GetLastActivePopup de Windows SDK.

`CWindow::GetMenu`

Recupera el menú de la ventana.

HMENU GetMenu() const throw();

Comentarios

Consulte el método GetMenu de Windows SDK.

`CWindow::GetNextDlgGroupItem`

Recupera el control anterior o siguiente dentro de un grupo de controles.

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

Comentarios

Consulte el método GetNextDlgGroupItem de Windows SDK.

`CWindow::GetNextDlgTabItem`

Recupera el control anterior o siguiente que tiene el estilo WS_TABSTOP.

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

Comentarios

Consulte el método GetNextDlgTabItem de Windows SDK.

`CWindow::GetParent`

Recupera la ventana principal inmediata.

HWND GetParent() const throw();

Comentarios

Consulte el método GetParent de Windows SDK.

Ejemplo

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

Recupera los parámetros de una barra de desplazamiento.

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

Comentarios

Consulte el método GetScrollInfo de Windows SDK.

`CWindow::GetScrollPos`

Recupera la posición del cuadro de desplazamiento.

int GetScrollPos(int nBar) const throw();

Comentarios

Consulte el método GetScrollPos de Windows SDK.

`CWindow::GetScrollRange`

Recupera el intervalo de barras de desplazamiento.

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

Comentarios

Consulte el método GetScrollRange de Windows SDK.

`CWindow::GetStyle`

Recupera los estilos de ventana de la ventana.

DWORD GetStyle() const throw();

Valor devuelto

Estilos de la ventana.

Comentarios

Para recuperar los estilos de ventana extendidos, llame a GetExStyle.

Ejemplo

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

Crea una copia del menú del sistema para su modificación.

HMENU GetSystemMenu(BOOL bRevert) const throw();

Comentarios

Consulte el método GetSystemMenu de Windows SDK.

`CWindow::GetTopLevelParent`

Recupera la ventana principal de nivel superior de la ventana.

HWND GetTopLevelParent() const throw();

Valor devuelto

Identificador de la ventana principal de nivel superior.

`CWindow::GetTopLevelWindow`

Recupera la ventana principal o propietaria de nivel superior de la ventana.

HWND GetTopLevelWindow() const throw();

Valor devuelto

Identificador de la ventana propietaria de nivel superior.

`CWindow::GetTopWindow`

Recupera la ventana secundaria de nivel superior.

HWND GetTopWindow() const throw();

Comentarios

Consulte el método GetTopWindow de Windows SDK.

Ejemplo

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

Recupera las coordenadas del rectángulo más pequeño que contiene completamente la región de actualización.

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

Comentarios

Consulte el método GetUpdateRect de Windows SDK.

`CWindow::GetUpdateRgn`

Recupera la región de actualización y la copia en una región especificada.

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

Comentarios

Consulte el método GetUpdateRgn de Windows SDK.

`CWindow::GetWindow`

Recupera la ventana especificada.

HWND GetWindow(UINT nCmd) const throw();

Comentarios

Consulte el método GetWindow de Windows SDK.

`CWindow::GetWindowContextHelpId`

Recupera el identificador de contexto de Ayuda de la ventana.

DWORD GetWindowContextHelpId() const throw();

Comentarios

Consulte el método GetWindowContextHelpId de Windows SDK.

`CWindow::GetWindowDC`

Recupera un contexto de dispositivo para toda la ventana.

HDC GetWindowDC() throw();

Comentarios

Consulte el método GetWindowDC de Windows SDK.

Ejemplo

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

Recupera un valor de 32 bits en un desplazamiento especificado en la memoria de ventana adicional.

LONG GetWindowLong(int nIndex) const throw();

Comentarios

Consulte el método GetWindowLong de Windows SDK.

Nota:

Para escribir código compatible con las versiones de Windows 32 y 64 bits, use CWindow::GetWindowLongPtr.

`CWindow::GetWindowLongPtr`

Recupera información sobre la ventana especificada, incluido un valor en un desplazamiento especificado en la memoria de ventana adicional.

LONG_PTR GetWindowLongPtr(int nIndex) const throw();

Comentarios

Para más información, consulte GetWindowLongPtr en Windows SDK.

Si va a recuperar un puntero o un identificador, esta función sustituye al método CWindow::GetWindowLong.

Nota:

Los punteros y controladores son de 32 bits en Windows de 32 bits y de 64 bits en Windows de 64 bits.

Para escribir código compatible con las versiones de Windows 32 y 64 bits, use CWindow::GetWindowLongPtr.

`CWindow::GetWindowPlacement`

Recupera el estado de presentación y las posiciones.

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

Comentarios

Consulte el método GetWindowPlacement de Windows SDK.

`CWindow::GetWindowProcessID`

Recupera el identificador del proceso que creó la ventana.

DWORD GetWindowProcessID() throw();

Comentarios

Consulte el método GetWindowThreadProcessID de Windows SDK.

Ejemplo

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

Recupera las dimensiones delimitadoras de la ventana.

BOOL GetWindowRect(LPRECT lpRect) const throw();

Comentarios

Consulte el método GetWindowRect de Windows SDK.

`CWindow::GetWindowRgn`

Recupera una copia de la región de ventana de una ventana.

int GetWindowRgn(HRGN hRgn) throw();

Comentarios

Consulte el método GetWindowRgn de Windows SDK.

`CWindow::GetWindowText`

Recupera el texto de la ventana.

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

Parámetros

lpszStringBuf
Un búfer en el que escribir el texto de la ventana.

nMaxCount
El tamaño del búfer en caracteres; también es el número máximo de caracteres que se pueden escribir.

bstrText
Un BSTR en el que almacenar el texto de la ventana.

strText
Un CString en el que almacenar el texto de la ventana.

Valor devuelto

Si el texto se copia correctamente, el valor devuelto es TRUE; de lo contrario, es FALSE.

Comentarios

Consulte el método GetWindowText de Windows SDK.

La segunda versión de este método le permite almacenar el texto en un objeto BSTR; la tercera versión le permite almacenar el resultado en un objeto CString, ya que CSimpleString es la clase base de CString.

`CWindow::GetWindowTextLength`

Recupera la longitud del texto de la ventana.

int GetWindowTextLength() const throw();

Comentarios

Consulte el método GetWindowTextLength de Windows SDK.

`CWindow::GetWindowThreadID`

Recupera el identificador del subproceso que creó la ventana especificada.

DWORD GetWindowThreadID() throw();

Comentarios

Consulte el método GetWindowThreadProcessID de Windows SDK.

Ejemplo

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

Recupera un valor de 16 bits en un desplazamiento especificado en la memoria de ventana adicional.

WORD GetWindowWord(int nIndex) const throw();

Comentarios

Consulte el método GetWindowLong de Windows SDK.

`CWindow::GotoDlgCtrl`

Establece el foco del teclado en un control del cuadro de diálogo.

void GotoDlgCtrl(HWND hWndCtrl) const throw();

Comentarios

Consulte el método WM_NEXTDLGCTL de Windows SDK.

`CWindow::HideCaret`

Oculta el símbolo de inserción.

BOOL HideCaret() throw();

Comentarios

Consulte el método HideCaret de Windows SDK.

Ejemplo

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

Resalta o quita el resaltado de un elemento de menú de nivel superior.

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

Comentarios

Consulte el método HiliteMenuItem de Windows SDK.

`CWindow::Invalidate`

Invalida toda el área cliente.

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

Comentarios

Consulte el método InvalidateRect de Windows SDK.

Pasa NULL para el parámetro RECT a la función de Win32 InvalidateRect.

Ejemplo

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

Invalida el área cliente dentro del rectángulo especificado.

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

Comentarios

Consulte el método InvalidateRect de Windows SDK.

`CWindow::InvalidateRgn`

Invalida el área cliente dentro de la región especificada.

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

Comentarios

Para más información, consulte InvalidateRgn en Windows SDK.

Especifica un tipo de valor devuelto void, mientras que la función de Win32 InvalidateRgn siempre devuelve TRUE.

`CWindow::IsChild`

Determina si la ventana especificada es una ventana secundaria.

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

Comentarios

Consulte el método IsChild de Windows SDK.

`CWindow::IsDialogMessage`

Determina si un mensaje está pensado para el cuadro de diálogo especificado.

BOOL IsDialogMessage(LPMSG lpMsg) throw();

Comentarios

Consulte el método IsDialogMessage de Windows SDK.

`CWindow::IsDlgButtonChecked`

Determina el estado de comprobación del botón.

UINT IsDlgButtonChecked(int nIDButton) const throw();

Comentarios

Consulte el método IsDlgButtonChecked de Windows SDK.

`CWindow::IsIconic`

Determina si la ventana está minimizada.

BOOL IsIconic() const throw();

Comentarios

Consulte el método IsIconic de Windows SDK.

Ejemplo

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

Determina si la ventana principal del control es una ventana de diálogo.

BOOL IsParentDialog() throw();

Valor devuelto

Devuelve TRUE si la ventana principal es un cuadro de diálogo; de lo contrario, FALSE.

`CWindow::IsWindow`

Determina si el identificador de ventana especificado identifica una ventana existente.

BOOL IsWindow() throw();

Comentarios

Consulte el método IsWindow de Windows SDK.

Ejemplo

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

Determina si la ventana está habilitada para la entrada.

BOOL IsWindowEnabled() const throw();

Comentarios

Consulte el método IsWindowEnabled de Windows SDK.

Ejemplo

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

Determina el estado de visibilidad de la ventana.

BOOL IsWindowVisible() const throw();

Comentarios

Consulte el método IsWindowVisible de Windows SDK.

Ejemplo

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

Determina si la ventana especificada es una ventana Unicode nativa.

BOOL IsWindowUnicode() throw();

Comentarios

Consulte el método IsWindowUnicode de Windows SDK.

Ejemplo

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

Determina si la ventana está maximizada.

BOOL IsZoomed() const throw();

Comentarios

Consulte el método IsZoomed de Windows SDK.

`CWindow::KillTimer`

Destruye un evento de temporizador creado por CWindow::SetTimer.

BOOL KillTimer(UINT nIDEvent) throw();

Comentarios

Consulte el método KillTimer de Windows SDK.

`CWindow::LockWindowUpdate`

Deshabilita o habilita el dibujo en la ventana mediante una llamada a la función de Win32 LockWindowUpdate.

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

Parámetros

bLock
[in] Si es TRUE (el valor predeterminado), la ventana se bloqueará. De lo contrario, se desbloqueará.

Valor devuelto

TRUE si la ventana se bloquea correctamente; de lo contrario, FALSE.

Comentarios

Si bLock es TRUE, este método pasa m_hWnd a la función de Win32; de lo contrario, pasa NULL.

`CWindow::m_hWnd`

Contiene un identificador para la ventana asociada al objeto CWindow.

HWND m_hWnd throw() throw();

`CWindow::MapWindowPoints`

Convierte un conjunto de puntos del espacio de coordenadas de la ventana al espacio de coordenadas de otra ventana.

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

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

Comentarios

Consulte el método MapWindowPoints de Windows SDK.

La segunda versión de este método permite convertir las coordenadas de una estructura RECT.

`CWindow::MessageBox`

Muestra un cuadro de mensaje.

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

Comentarios

Consulte el método MessageBox de Windows SDK.

Ejemplo

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

Modifica los estilos de ventana del objeto CWindow.

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

Parámetros

dwRemove
[in] Especifica los estilos de ventana que se van a quitar durante la modificación del estilo.

dwAdd
[in] Especifica los estilos de ventana que se van a agregar durante la modificación del estilo.

nFlags
[in] Marcas de posicionamiento de ventanas. Para ver una lista de valores posibles, consulte la función SetWindowPos en Windows SDK.

Valor devuelto

TRUE si se modifican los estilos de ventana; de lo contrario, FALSE.

Comentarios

Los estilos que se van a agregar o quitar se pueden combinar mediante el operador "or" bit a bit (|). Consulte la función CreateWindow en Windows SDK para información sobre los estilos de ventana disponibles.

Si nFlags es distinto de cero, ModifyStyle llama a la función de Win32 SetWindowPos y vuelve a dibujar la ventana combinando nFlags con las cuatro marcas siguientes:

SWP_NOSIZE Conserva el tamaño actual.
SWP_NOMOVE Conserva la posición actual.
SWP_NOZORDER Conserva el orden Z actual.
SWP_NOACTIVATE No activa la ventana.

Para modificar los estilos extendidos de una ventana, llame a ModifyStyleEx.

Ejemplo

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

Modifica los estilos de ventana extendidos del objeto CWindow.

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

Parámetros

dwRemove
[in] Especifica los estilos extendidos que se van a quitar durante la modificación del estilo.

dwAdd
[in] Especifica los estilos extendidos que se van a agregar durante la modificación del estilo.

nFlags
[in] Marcas de posicionamiento de ventanas. Para ver una lista de valores posibles, consulte la función SetWindowPos en Windows SDK.

Valor devuelto

TRUE si se modifican los estilos de ventana extendidos; de lo contrario, FALSE.

Comentarios

Los estilos que se van a agregar o quitar se pueden combinar mediante el operador "or" bit a bit (|). Consulte la función CreateWindowEx en Windows SDK para información sobre los estilos extendidos disponibles.

Si nFlags es distinto de cero, ModifyStyleEx llama a la función de Win32 SetWindowPos y vuelve a dibujar la ventana combinando nFlags con las cuatro marcas siguientes:

SWP_NOSIZE Conserva el tamaño actual.
SWP_NOMOVE Conserva la posición actual.
SWP_NOZORDER Conserva el orden Z actual.
SWP_NOACTIVATE No activa la ventana.

Para modificar ventanas mediante estilos de ventana normales, llame a ModifyStyle.

Ejemplo

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

Cambia el tamaño y la posición de la ventana.

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

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

Comentarios

Para un objeto de ventana de nivel superior, los parámetros x y y son relativos a la esquina superior izquierda de la pantalla. Para un objeto de ventana secundario, son relativos a la esquina superior izquierda del área cliente de la ventana principal.

La segunda versión de este método usa una estructura RECT para determinar la nueva posición, el ancho y el alto de la ventana.

`CWindow::NextDlgCtrl`

Establece el foco del teclado en el siguiente control del cuadro de diálogo.

void NextDlgCtrl() const throw();

Comentarios

Consulte el método WM_NEXTDLGCTL de Windows SDK.

`CWindow::OpenClipboard`

Abre el Portapapeles.

BOOL OpenClipboard() throw();

Comentarios

Consulte el método OpenClipboard de Windows SDK.

`CWindow::operator HWND`

Convierte un objeto CWindow en un objeto HWND.

operator HWND() const throw();

`CWindow::operator =`

Asigna un objeto HWND al objeto CWindow estableciendo el miembro m_hWnd en hWnd.

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

`CWindow::PostMessage`

Coloca un mensaje en la cola de mensajes asociada al subproceso que creó la ventana.

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

Comentarios

Consulte el método PostMessage de Windows SDK.

Devuelve resultados sin esperar a que el subproceso procese el mensaje.

Ejemplo

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

Establece el foco del teclado en el control anterior del cuadro de diálogo.

void PrevDlgCtrl() const throw();

Comentarios

Consulte el método WM_NEXTDLGCTL de Windows SDK.

`CWindow::Print`

Envía un mensaje WM_PRINT a la ventana para solicitar que se dibuje en el contexto de dispositivo especificado.

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

Parámetros

hDC
[in] Identificador de un contexto de dispositivo.

dwFlags
[in] Especifica las opciones de dibujo. Puede combinar una o varias de las marcas siguientes:

PRF_CHECKVISIBLE Dibuja la ventana solo si está visible.
PRF_CHILDREN Dibuja todas las ventanas secundarias visibles.
PRF_CLIENT Dibujar el área cliente de la ventana.
PRF_ERASEBKGND Borrar el fondo antes de dibujar la ventana.
PRF_NONCLIENT Dibuja el área no cliente de la ventana.
PRF_OWNED Dibuja todas las ventanas de propiedad.

`CWindow::PrintClient`

Envía un mensaje WM_PRINTCLIENT a la ventana para solicitar que dibuje su área cliente en el contexto de dispositivo especificado.

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

Parámetros

hDC
[in] Identificador de un contexto de dispositivo.

dwFlags
[in] Especifica las opciones de dibujo. Puede combinar una o varias de las marcas siguientes:

PRF_CHECKVISIBLE Dibuja la ventana solo si está visible.
PRF_CHILDREN Dibuja todas las ventanas secundarias visibles.
PRF_CLIENT Dibujar el área cliente de la ventana.
PRF_ERASEBKGND Borrar el fondo antes de dibujar la ventana.
PRF_NONCLIENT Dibuja el área no cliente de la ventana.
PRF_OWNED Dibuja todas las ventanas de propiedad.

`CWindow::rcDefault`

Contiene dimensiones de ventana predeterminadas.

static RECT rcDefault;

`CWindow::RedrawWindow`

Actualiza el rectángulo o la región especificados en el área cliente.

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

throw()

Comentarios

Consulte el método RedrawWindow de Windows SDK.

Ejemplo

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

Libera un contexto de dispositivo.

int ReleaseDC(HDC hDC);

Comentarios

Consulte el método ReleaseDC de Windows SDK.

Ejemplo

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

Cambia el tamaño de la ventana al tamaño del área cliente especificada.

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

Parámetros

nWidth
Nuevo ancho de la ventana, en píxeles.

nHeight
Nuevo alto de la ventana, en píxeles.

bRedraw
Marca que indica si se van a volver a dibujar los cambios. El valor predeterminado es FALSE, lo que indica que la ventana no vuelve a dibujar los cambios.

`CWindow::ScreenToClient`

Convierte las coordenadas de la pantalla en coordenadas de cliente.

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

Comentarios

Consulte el método ScreenToClient de Windows SDK.

La segunda versión de este método permite convertir las coordenadas de una estructura RECT.

`CWindow::ScrollWindow`

Desplaza el área cliente especificada.

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

Comentarios

Consulte el método ScrollWindow de Windows SDK.

`CWindow::ScrollWindowEx`

Desplaza el área cliente especificada con características adicionales.

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

Comentarios

Consulte el método ScrollWindowEx de Windows SDK.

`CWindow::SendDlgItemMessage`

Envía un mensaje a un control.

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

Comentarios

Consulte el método SendDlgItemMessage de Windows SDK.

`CWindow::SendMessage`

Envía un mensaje a la ventana y no devuelve resultados hasta que el procedimiento de ventana haya procesado el mensaje.

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

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

Comentarios

Consulte el método SendMessage de Windows SDK.

Ejemplo

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

Envía el mensaje especificado a todos los elementos secundarios inmediatos del objeto CWindow.

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

Parámetros

message
[in] El mensaje que se va a enviar.

wParam
[in] Información adicional específica del mensaje.

lParam
[in] Información adicional específica del mensaje.

bDeep
[in] Si es TRUE (el valor predeterminado), el mensaje se enviará a todas las ventanas descendientes; de lo contrario, se enviará solo a las ventanas secundarias inmediatas.

Comentarios

Si bDeep es TRUE, el mensaje se envía además a todas las demás ventanas descendientes.

`CWindow::SendNotifyMessage`

Envía un mensaje a la ventana.

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

Comentarios

Consulte el método SendNotifyMessage de Windows SDK.

Si el subproceso que realiza la llamada creó la ventana, SendNotifyMessage no devuelve resultados hasta que el procedimiento de ventana haya procesado el mensaje. De lo contrario, devuelve resultados inmediatamente.

`CWindow::SetActiveWindow`

Activa la ventana.

HWND SetActiveWindow() throw();

Comentarios

Consulte el método SetActiveWindow de Windows SDK.

Ejemplo

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

Envía todas las entradas posteriores del mouse a la ventana.

HWND SetCapture() throw();

Comentarios

Consulte el método SetCapture de Windows SDK.

`CWindow::SetClipboardViewer`

Agrega la ventana a la cadena de visores del Portapapeles.

HWND SetClipboardViewer() throw();

Comentarios

Consulte el método SetClipboardViewer de Windows SDK.

`CWindow::SetDlgCtrlID`

Establece el identificador de la ventana en el valor especificado.

int SetDlgCtrlID(int nID) throw();

Parámetros

nID
[in] Nuevo valor que se va a establecer para el identificador de la ventana.

Valor devuelto

Si se ejecuta correctamente, el identificador anterior de la ventana; de lo contrario, 0.

`CWindow::SetDlgItemInt`

Cambia el texto de un control a la representación de cadena de un valor entero.

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

Comentarios

Consulte el método SetDlgItemInt de Windows SDK.

`CWindow::SetDlgItemText`

Cambia el texto de un control.

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

Comentarios

Consulte el método SetDlgItemText de Windows SDK.

`CWindow::SetFocus`

Establece el foco de entrada en la ventana.

HWND SetFocus() throw();

Comentarios

Consulte el método SetFocus de Windows SDK.

Ejemplo

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

Cambia la fuente actual de la ventana mediante el envío de un mensaje WM_SETFONT a la ventana.

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

Parámetros

hFont
[in] Identificador de la nueva fuente.

bRedraw
[in] Si es TRUE (valor predeterminado), se vuelve a dibujar la ventana. De lo contrario, no.

`CWindow::SetHotKey`

Asocia una tecla de acceso rápido a la ventana mediante el envío de un mensaje WM_SETHOTKEY.

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

Parámetros

wVirtualKeyCode
[entrada] El código de tecla virtual de la tecla de acceso rápido. Para ver una lista de códigos de tecla virtual estándar, consulte Winuser.h.

wModifiers
[in] Modificadores de la tecla de acceso rápido. Para ver una lista de valores posibles, consulte WM_SETHOTKEY en Windows SDK.

Valor devuelto

Para ver una lista de valores devueltos posibles, consulte WM_SETHOTKEY en Windows SDK.

`CWindow::SetIcon`

Establece el icono grande o pequeño de la ventana en el icono identificado por hIcon.

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

Parámetros

hIcon
[in] Identificador de un nuevo icono.

bBigIcon
[in] Si es TRUE (el valor predeterminado), el método establece un icono grande. De lo contrario, establece un icono pequeño.

Valor devuelto

Identificador del icono anterior.

Comentarios

SetIcon envía un mensaje WM_SETICON a la ventana.

`CWindow::SetMenu`

Cambia el menú actual de la ventana.

BOOL SetMenu(HMENU hMenu) throw();

Comentarios

Consulte el método SetMenu de Windows SDK.

`CWindow::SetParent`

Cambia la ventana primaria.

HWND SetParent(HWND hWndNewParent) throw();

Comentarios

Consulte el método SetParent de Windows SDK.

Ejemplo

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

Establece o borra la marca de volver a dibujar mediante el envío de un mensaje WM_SETREDRAW a la ventana.

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

Parámetros

bRedraw
[in] Especifica el estado de la marca de volver a dibujar. Si es TRUE (el valor predeterminado), se establece la marca de volver a dibujar; si es FALSE, se borra la marca.

Comentarios

Llame a SetRedraw para permitir o impedir que los cambios se vuelvan a dibujar.

Ejemplo

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

Establece los parámetros de una barra de desplazamiento.

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

Comentarios

Consulte el método SetScrollInfo de Windows SDK.

`CWindow::SetScrollPos`

Cambia la posición del cuadro de desplazamiento.

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

Comentarios

Consulte el método SetScrollPos de Windows SDK.

`CWindow::SetScrollRange`

Cambia el intervalo de barras de desplazamiento.

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

Comentarios

Consulte el método SetScrollRange de Windows SDK.

`CWindow::SetTimer`

Crea un evento de temporizador.

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

Comentarios

Consulte el método SetTimer de Windows SDK.

`CWindow::SetWindowContextHelpId`

Establece el identificador de contexto de Ayuda de la ventana.

BOOL SetWindowContextHelpId(DWORD dwContextHelpId) throw();

Comentarios

Consulte el método SetWindowContextHelpId de Windows SDK.

`CWindow::SetWindowLong`

Establece un valor de 32 bits en un desplazamiento especificado en la memoria de ventana adicional.

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

Comentarios

Consulte el método SetWindowLong de Windows SDK.

Nota:

Para escribir código compatible con las versiones de Windows 32 y 64 bits, use CWindow::SetWindowLongPtr.

`CWindow::SetWindowLongPtr`

Cambia un atributo de la ventana especificada y también establece un valor en el desplazamiento especificado en la memoria de ventana adicional.

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

Comentarios

Consulte el método SetWindowLongPtr de Windows SDK.

Esta función reemplaza al método CWindow::SetWindowLong. Para escribir código compatible con las versiones de Windows 32 y 64 bits, use CWindow::SetWindowLongPtr.

`CWindow::SetWindowPlacement`

Establece el estado de presentación y las posiciones.

BOOL SetWindowPlacement(const WINDOWPLACEMENT FAR* lpwndpl);

Comentarios

Consulte el método SetWindowPlacement de Windows SDK.

`CWindow::SetWindowPos`

Establece el tamaño, la posición y el orden 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();

Comentarios

Consulte el método SetWindowPos de Windows SDK.

La segunda versión de este método usa una estructura RECT para establecer la nueva posición, el ancho y el alto de la ventana.

`CWindow::SetWindowRgn`

Establece la región de una ventana.

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

Comentarios

Consulte el método SetWindowRgn de Windows SDK.

`CWindow::SetWindowText`

Cambia el texto de la ventana.

BOOL SetWindowText(LPCTSTR lpszString) throw();

Comentarios

Consulte el método SetWindowText de Windows SDK.

Ejemplo

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

Establece un valor de 16 bits en un desplazamiento especificado en la memoria de ventana adicional.

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

Comentarios

Consulte el método SetWindowLong de Windows SDK.

`CWindow::ShowCaret`

Muestra el símbolo de inserción.

BOOL ShowCaret() throw();

Comentarios

Consulte el método ShowCaret de Windows SDK.

Ejemplo

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

Muestra u oculta las ventanas emergentes propiedad de la ventana.

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

Comentarios

Consulte el método ShowOwnedPopups de Windows SDK.

`CWindow::ShowScrollBar`

Muestra u oculta una barra de desplazamiento.

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

Comentarios

Consulte el método ShowScrollBar de Windows SDK.

`CWindow::ShowWindow`

Establece el estado de presentación de la ventana.

BOOL ShowWindow(int nCmdShow) throw();

Comentarios

Consulte el método ShowWindow de Windows SDK.

Ejemplo

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

Establece el estado de presentación de una ventana creada por un subproceso diferente.

BOOL ShowWindowAsync(int nCmdShow) throw();

Comentarios

Consulte el método ShowWindowAsync de Windows SDK.

`CWindow::UpdateWindow`

Actualiza el área de cliente.

BOOL UpdateWindow() throw();

Comentarios

Consulte el método UpdateWindow de Windows SDK.

Ejemplo

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

Valida el área cliente dentro del rectángulo especificado.

BOOL ValidateRect(LPCRECT lpRect) throw();

Comentarios

Consulte el método ValidateRect de Windows SDK.

`CWindow::ValidateRgn`

Valida el área cliente dentro de la región especificada.

BOOL ValidateRgn(HRGN hRgn) throw();

Comentarios

Consulte el método ValidateRgn de Windows SDK.

`CWindow::WinHelp`

Inicia la Ayuda de Windows.

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

Comentarios

Consulte el método WinHelp de Windows SDK.

Consulte también

Información general sobre la clase

Compartir a través de

Clase CWindow

Sintaxis

Miembros

Constructores públicos

Métodos públicos

Operadores públicos

Miembros de datos públicos

Comentarios

Requisitos

CWindow::ArrangeIconicWindows

Comentarios

CWindow::Attach

Parámetros

Ejemplo

CWindow::BeginPaint

Comentarios

Ejemplo

CWindow::BringWindowToTop

Comentarios

Ejemplo

CWindow::CenterWindow

Parámetros

Valor devuelto

Ejemplo

CWindow::ChangeClipboardChain

Comentarios

CWindow::CheckDlgButton

Comentarios

CWindow::CheckRadioButton

Comentarios

CWindow::ChildWindowFromPoint

Comentarios

CWindow::ChildWindowFromPointEx

Comentarios

CWindow::ClientToScreen

Comentarios

CWindow::Create

Parámetros

Valor devuelto

Comentarios

CWindow::CreateCaret

Comentarios

CWindow::CreateGrayCaret

Comentarios

CWindow::CreateSolidCaret

Comentarios

CWindow::CWindow

Parámetros

Comentarios

CWindow::DeferWindowPos

Comentarios

CWindow::DestroyWindow

Comentarios

Ejemplo

CWindow::Detach

Valor devuelto

Ejemplo

CWindow::DlgDirList

Comentarios

CWindow::DlgDirListComboBox

Comentarios

CWindow::DlgDirSelect

Comentarios

CWindow::DlgDirSelectComboBox

Comentarios

CWindow::DragAcceptFiles

Comentarios

CWindow::DrawMenuBar

Comentarios

CWindow::EnableScrollBar

Comentarios

CWindow::EnableWindow

Comentarios

Ejemplo

CWindow::EndPaint

Comentarios

Ejemplo

CWindow::FlashWindow

Comentarios

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