Clase CWindow

Esta clase proporciona métodos para manipular una ventana.

Sintaxis

class CWindow

Miembros

Constructores públicos

Métodos públicos

Operadores públicos

Miembros de datos públicos

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:

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.

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.

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.

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.

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.

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