CMFCPropertySheet::AddTreeCategory
Aggiunge un nuovo nodo al controllo di struttura ad albero.
CMFCPropertySheetCategoryInfo* AddTreeCategory(
LPCTSTR lpszLabel,
int nIconNum=-1,
int nSelectedIconNum=-1,
const CMFCPropertySheetCategoryInfo* pParentCategory=NULL
);
Parametri
[in] lpszLabel
Nome del nodo.[in] nIconNum
Indice in base zero di un'icona, oppure -1 se nessuna icona viene utilizzata. L'icona visualizzata accanto alla pagina delle proprietà del controllo struttura ad albero quando la pagina non è selezionata. Il valore predefinito è -1.[in] nSelectedIconNum
Indice in base zero di un'icona, oppure -1 se nessuna icona viene utilizzata. L'icona visualizzata accanto alla pagina delle proprietà del controllo struttura ad albero quando la pagina viene selezionata. Il valore predefinito è -1.[in] pParentCategory
Puntatore a un nodo della struttura ad albero padre, o NULL per associare la pagina specificata con il nodo di primo livello. Impostare questo parametro al metodo CMFCPropertySheet::AddTreeCategory.
Valore restituito
Un puntatore al nuovo nodo nel controllo struttura ad albero.
Note
Utilizzare questo metodo per aggiungere un nuovo nodo, che è anche detto categoria, al controllo di struttura ad albero. Per aggiungere un nodo, creare un oggetto CMFCPropertySheet, chiamare il metodo CMFCPropertySheet::SetLook con il parametro look impostato su CMFCPropertySheet::PropSheetLook_Treequindi utilizzare questo metodo per aggiungere il nodo.
Utilizzare il valore restituito del metodo nelle chiamate successive a CMFCPropertySheet::AddPageToTree e a CMFCPropertySheet::AddTreeCategory.
Requisiti
intestazione: afxpropertysheet.h