CPropertySheet::Construct

Artículo
02/19/2013

Crea un objeto CPropertySheet.

void Construct(
   UINT nIDCaption,
   CWnd* pParentWnd = NULL,
   UINT iSelectPage = 0 
);
void Construct(
   LPCTSTR pszCaption,
   CWnd* pParentWnd = NULL,
   UINT iSelectPage = 0 
);
void Construct(
   UINT nIDCaption,
   CWnd* pParentWnd,
   UINT iSelectPage,
   HBITMAP hbmWatermark,
   HPALETTE hpalWatermark = NULL,
   HBITMAP hbmHeader = NULL 
);
void Construct(
   LPCTSTR pszCaption,
   CWnd* pParentWnd,
   UINT iSelectPage,
   HBITMAP hbmWatermark,
   HPALETTE hpalWatermark = NULL,
   HBITMAP hbmHeader = NULL 
);

Parámetros

nIDCaption
Identificador de la leyenda que se utilizará para la hoja de propiedades.
pParentWnd
puntero a la ventana primaria de la hoja de propiedades.Si NULL, la ventana principal es la ventana principal de la aplicación.
iSelectPage
el índice de la página que estará inicialmente en la parte superior.El valor predeterminado es la primera página agregada a la hoja.
pszCaption
Puntero a una cadena que contiene la leyenda que se utilizará para la hoja de propiedades.no puede ser NULL.
hbmWatermark
Identificador del mapa de bits de la marca de agua de la página de propiedades.
hpalWatermark
Identificador de la paleta de mapa de bits de la marca de agua ni del mapa de bits de encabezado.
hbmHeader
Identificador del mapa de bits del encabezado de la página de propiedades.

Comentarios

Llame a esta función miembro si no han llamado a uno de los constructores de clase ya.Por ejemplo, llame a Construct cuando se declara o asigna las matrices de objetos de CPropertySheet .En el caso de las matrices, debe llamar a Construct para cada miembro de la matriz.

Para mostrar la hoja de propiedades, la llamada DoModal o Crear.La cadena contenida en el primer parámetro se escribirá en la barra de título de la hoja de propiedades.

Puede mostrar imágenes de marca de agua ni del encabezado automáticamente si utiliza los terceros o cuartos prototipos de Construct, enumerado anteriormente, y pase los valores válidos para hbmWatermark, hpalWatermark, o los parámetros de hbmHeader .

Ejemplo

El ejemplo siguiente muestra en qué circunstancias se llamaría Construct.

const int c_cSheets = 3;
CPropertySheet   grpropsheet[c_cSheets];
// no need to call Construct for this next one
CPropertySheet   someSheet(_T("Some sheet"));

LPTSTR rgszSheets[c_cSheets] = {
   _T("Sheet 1"),
   _T("Sheet 2"),
   _T("Sheet 3")
};

for (int i = 0; i < c_cSheets; i++)
    grpropsheet[i].Construct(rgszSheets[i]);