CWnd::CreateEx

Articolo
02/19/2013

Crea la finestra specificata e allegarlo all'oggetto CWnd.

virtual BOOL CreateEx(
   DWORD dwExStyle,
   LPCTSTR lpszClassName,
   LPCTSTR lpszWindowName,
   DWORD dwStyle,
   int x,
   int y,
   int nWidth,
   int nHeight,
   HWND hWndParent,
   HMENU nIDorHMenu,
   LPVOID lpParam = NULL 
);
virtual BOOL CreateEx(
   DWORD dwExStyle,
   LPCTSTR lpszClassName,
   LPCTSTR lpszWindowName,
   DWORD dwStyle,
   const RECT& rect,
   CWnd* pParentWnd,
   UINT nID,
   LPVOID lpParam = NULL
);

Parametri

dwExStyle
Combinazione bit per bit (OR) stili estesi della finestra; in caso contrario NULL per lo stile esteso di finestre predefinito.
lpszClassName
Puntatore a una stringa con terminazione null che contiene il nome di una classe finestra registrata di sistema; o il nome della classe della finestra predefinita del sistema.
lpszWindowName
Puntatore a una stringa con terminazione null che contiene il nome visualizzato della finestra; in caso contrario NULL ad alcun nome visualizzato della finestra.
dwStyle
Combinazione bit per bit (OR) stili della finestra; in caso contrario NULL per lo stile predefinito della finestra.
x
La distanza orizzontale iniziale della finestra sul lato sinistro dello schermo o della finestra padre.
y
La distanza verticale iniziale della finestra dalla parte superiore dello schermo o della finestra padre.
nWidth
La larghezza, in pixel, della finestra.
nHeight
L'altezza, in pixel, della finestra.
hwndParent
Per una finestra figlio, un handle di finestra padre; in caso contrario, l'handle della finestra proprietaria se la finestra è presente un proprietario.
nIDorHMenu
Per una finestra figlio, la finestra ID, in caso contrario, l'id di un menu nella finestra.
lpParam
Puntatore a dati utente che viene passato al metodo CWnd::OnCreate nel campo lpCreateParams.
rect
La dimensione e la posizione della finestra rispetto allo schermo o la finestra padre.
pParentWnd
Per una finestra figlio, puntatore alla finestra padre; in caso contrario, puntatore alla finestra proprietaria se la finestra è presente un proprietario.
nID
Per una finestra figlio, la finestra ID, in caso contrario, l'id di un menu nella finestra.

Valore restituito

TRUE se il metodo è riuscita, in caso contrario FALSE.

Note

Attenzione
CWnd::PreCreateWindow ora che segue il membro di hMenu del parametro CREATESTRUCT al puntatore this se il menu è NULL e lo stile contiene WS_CHILD.Per garantire una corretta funzionalità, assicurarsi che il controllo finestra di dialogo con un ID che non è NULL. Questa modifica corregge un arresto anomalo scenari di interoperabilità gestiti o nativi.Un'istruzione TRACE in CWnd::Create segnala lo sviluppatore del problema.

CWnd::PreCreateWindow ora che segue il membro di hMenu del parametro CREATESTRUCT al puntatore this se il menu è NULL e lo stile contiene WS_CHILD.Per garantire una corretta funzionalità, assicurarsi che il controllo finestra di dialogo con un ID che non è NULL.

Questa modifica corregge un arresto anomalo scenari di interoperabilità gestiti o nativi.Un'istruzione TRACE in CWnd::Create segnala lo sviluppatore del problema.

Lo stile esteso di finestre predefinito è WS_EX_LEFT.Lo stile predefinito della finestra è WS_OVERLAPPED.

Utilizzare la funzione AfxRegisterWndClass per registrare le classi della finestra.Le classi di finestre definite dall'utente siano disponibili nel modulo in cui vengono registrate.

Le dimensioni delle finestre figlio sono relativi all'angolo superiore sinistro dell'area client della finestra padre.Le dimensioni delle finestre di primo livello sono relativi all'angolo superiore sinistro dello schermo.

Il metodo CWnd::OnCreate viene chiamato prima che il metodo CreateEx e prima della finestra diventa visibile.

Esempio

void CMyDlg::OnCreateExtendedControl() 
{
   // m_pWndStaticEx is a CWnd* member of CMyDlg
   m_pWndStaticEx = new CStatic;
   m_pWndStaticEx->CreateEx(WS_EX_CLIENTEDGE, // Make a client edge label.
      _T("STATIC"), _T("Hi"),
      WS_CHILD | WS_TABSTOP | WS_VISIBLE,
      5, 5, 30, 30, m_hWnd, (HMENU)2345);
}