CPropertyPage::Construct

Articolo
06/10/2015

Chiamare la funzione membro per creare un oggetto CPropertyPage.

void Construct( 
   UINT nIDTemplate, 
   UINT nIDCaption = 0  
); 
void Construct( 
   LPCTSTR lpszTemplateName, 
   UINT nIDCaption = 0  
); 
void Construct( 
   UINT nIDTemplate, 
   UINT nIDCaption, 
   UINT nIDHeaderTitle, 
   UINT nIDHeaderSubTitle = 0  
); 
void Construct( 
   LPCTSTR lpszTemplateName, 
   UINT nIDCaption, 
   UINT nIDHeaderTitle, 
   UINT nIDHeaderSubTitle = 0  
);

Parametri

nIDTemplate
ID del modello utilizzato per questa pagina.
nIDCaption
ID del nome da inserire nella scheda della pagina. Se 0, il nome sarà creato dal modello di finestra di dialogo per questa pagina.
lpszTemplateName
Contiene una stringa con terminazione null che è il nome di una risorsa modello.
nIDHeaderTitle
ID del nome da inserire nel percorso del titolo dell'intestazione di pagina delle proprietà. Per impostazione predefinita, 0.
nIDHeaderSubTitle
ID del nome da inserire nel percorso del sottotitolo dell'intestazione di pagina delle proprietà. Per impostazione predefinita, 0.

Note

L'oggetto visualizzato dopo che sono soddisfatte tutte le seguenti condizioni:

La pagina è stata aggiunta a una finestra delle proprietà mediante CPropertySheet::AddPage.
La funzione DoModal o Crea la finestra proprietà è stata chiamata.
L'utente ha selezionato (catalogato) questa pagina.

Chiamare Construct se uno degli altri costruttori di classe non è stato chiamato. La funzione membro Construct è flessibile perché è possibile lasciare vuoto dell'istruzione di parametro e quindi specificare più parametri e la costruzione in qualsiasi punto del codice.

È necessario utilizzare Construct quando si utilizzano le matrici ed è necessario chiamare Construct per ogni membro della matrice in modo da assegnare membri dati i valori appropriati.

Esempio

// Declare a CPropertySheet object.
CPropertySheet sheet(_T("Simple PropertySheet"));

// Create three CPropertyPage objects whose template IDs are specified 
// in rgID array, and add each page to the CPropertySheet object.  
const int c_cPages = 3;
CPropertyPage   pages[c_cPages];
UINT rgID[c_cPages] = {IDD_STYLE, IDD_COLOR, IDD_SHAPE};
for (int i = 0; i < c_cPages; i++)    
{
   pages[i].Construct(rgID[i]);
   sheet.AddPage(&pages[i]);
}

// Display a modal CPropertySheet dialog.
sheet.DoModal();