Übergeordnete und untergeordnete Elemente in einem Struktursteuerelement
Jedes Element in einem der Strukturansicht (CTreeCtrl) kann eine Liste mit Unterelementen, die über untergeordnete Elemente bezeichnet werden, zugeordnet. Ein Element, das ein oder mehrere untergeordnete Elemente hat, wird ein übergeordnetes Element aufgerufen. Ein untergeordnetes Element wird unterhalb des übergeordneten Elements angezeigt und wird eingezogen, um zu kennzeichnen ist untergeordnet übergeordnete Element. Ein Element, das kein übergeordnetes Element hat, ist in der Hierarchie und wird als Stammelement bezeichnet.
Zu jedem Zeitpunkt kann der Zustand der Liste eines übergeordneten Elements der untergeordneter Elemente entweder erweitert oder reduziert werden. Wenn der Zustand erweitert wird, werden die untergeordneten Elemente unterhalb des übergeordneten Elements angezeigt. Wenn sie reduziert sind, werden die untergeordneten Elemente nicht angezeigt. In der Liste der automatisch zwischen den erweiterten und reduzierten Zustände, wenn Benutzer auf das übergeordnete Element öffnen oder, wenn das übergeordnete Element das TVS_HASBUTTONS Format hat, wenn der Benutzer auf die Schaltfläche klickt, die dem übergeordneten Element zugeordnet ist. Eine Anwendung kann die untergeordnete Elemente erweitern oder reduzieren, indem Sie die Memberfunktion Erweitern verwendet.
Sie ein Element einem Strukturansicht hinzu, indem Sie die Memberfunktion InsertItem aufrufen. Diese Funktion gibt ein Handle des Typs HTREEITEM zurück, der das Element eindeutig identifiziert. Wenn Sie ein Element hinzufügen, müssen Sie das Handle des übergeordneten Elements des neuen Elements angeben. Wenn Sie NULL oder das TVI_ROOT-Wert anstelle eines Handles des übergeordneten Elements in der Struktur unter TVINSERTSTRUCT oder im hParent-Parameter angeben, wird das Element als Stammelement hinzugefügt.
Eine Strukturansicht sendet eine Benachrichtigung TVN_ITEMEXPANDING, wenn die Liste eines übergeordneten Elements von untergeordneten Elementen im Begriff ist erweitert werden oder reduziert werden. Die Benachrichtigung erhalten Sie die Möglichkeit, die Änderungen zu unterbinden oder alle Attribute des übergeordneten Elements festlegen, die vom Zustand der Liste untergeordneter Elemente abhängen. Nachdem Sie den Zustand der Liste geändert hat, sendet das Tree-Steuerelement eine Benachrichtigung. TVN_ITEMEXPANDED
Wenn eine Liste untergeordneter Elemente erweitert wird, wird sie relativ zum übergeordneten Element eingezogen. Sie können die Größe des Einzugs, indem Sie die SetIndent festlegen oder Memberfunktion, verwenden die aktuelle Menge abrufen, indem Sie die Memberfunktion GetIndent verwenden.