CMFCPropertySheet::AddTreeCategory
Fügt einen neuen Knoten dem Strukturansicht-Steuerelement hinzu.
CMFCPropertySheetCategoryInfo* AddTreeCategory(
LPCTSTR lpszLabel,
int nIconNum=-1,
int nSelectedIconNum=-1,
const CMFCPropertySheetCategoryInfo* pParentCategory=NULL
);
Parameter
[in] lpszLabel
Der Name des Knotens.[in] nIconNum
Der nullbasierte Index eines Symbols oder -1, wenn kein Symbol verwendet wird.Das Symbol wird neben der Strukturansicht-Steuerelement-Eigenschaftenseite angezeigt, wenn die Seite nicht aktiviert ist.Der Standardwert ist -1.[in] nSelectedIconNum
Der nullbasierte Index eines Symbols oder -1, wenn kein Symbol verwendet wird.Das Symbol wird neben der Strukturansicht-Steuerelement-Eigenschaftenseite angezeigt, wenn die Seite ausgewählt wird.Der Standardwert ist -1.[in] pParentCategory
Zeiger auf einem übergeordneten Strukturknoten oder NULL, um der angegebenen Seite mit dem Knoten der obersten Ebene zuzuordnen.Legen Sie diesen Parameter mit der CMFCPropertySheet::AddTreeCategory-Methode fest.
Rückgabewert
Ein Zeiger auf den neuen Knoten in der Strukturansicht.
Hinweise
Verwenden Sie diese Methode, um einen neuen Knoten, der als auch eine Kategorie bezeichnet, dem Strukturansicht-Steuerelement hinzuzufügen.Um einen Knoten hinzuzufügen, erstellen Sie ein CMFCPropertySheet-Objekt, rufen Sie die CMFCPropertySheet::SetLook-Methode mit dem look-Parameter auf, der zu CMFCPropertySheet::PropSheetLook_Tree festgelegt wird, und verwenden Sie anschließend diese Methode um den Knoten hinzuzufügen.
Verwenden Sie den Rückgabewert dieser Methode in nachfolgenden Aufrufe CMFCPropertySheet::AddPageToTree und zu CMFCPropertySheet::AddTreeCategory.
Anforderungen
Header: afxpropertysheet.h