1、创建示例

2、API说明

@interface NSTreeNode : NSObject

/**
 * @brief 创建一个包含指定modelObject对象的新树节点
 *
 * @param modelObject    表示该节点的modelObject对象，可为nil
 * @return               新创建的树节点
 *
 * @discussion           该方法创建了一个新的NSTreeNode对象，该对象的representedObject属性被设置为指定的modelObject对象。
 *                       使用该方法可以快速创建一个用于作为树节点的对象，并将其关联到指定的modelObject上。
 *                       例如，当需要将一个modelObject插入到树中时，可以使用该方法来创建一个树节点对象，并将相应的modelObject关联到该节点上。
 */
+ (instancetype)treeNodeWithRepresentedObject:(nullable id)modelObject;

/**
 * @brief 创建一个包含指定modelObject对象的新树节点
 *
 * @param modelObject    表示该节点的modelObject对象，可为nil
 * @return               新创建的树节点
 *
 * @discussion           该方法创建了一个新的NSTreeNode对象，该对象的representedObject属性被设置为指定的modelObject对象。
 *                       使用该方法可以快速创建一个用于作为树节点的对象，并将其关联到指定的modelObject上。
 *                       例如，当需要将一个modelObject插入到树中时，可以使用该方法来创建一个树节点对象，并将相应的modelObject关联到该节点上。
 */
- (instancetype)initWithRepresentedObject:(nullable id)modelObject;

/**
 * @brief 查找指定位置下的节点，并返回该节点
 *
 * @param indexPath    指定位置所代表的NSIndexPath对象
 * @return             该位置下的节点，如果指定位置不存在，则返回nil。
 *
 * @discussion         该方法会在NSTreeNode及其子节点中查找指定位置下的节点，并返回该节点。
 *                     例如，当需要表示一个文件系统的树结构时，可以使用该方法来查找指定的文件夹节点，并在其下创建子节点。
 */
- (nullable NSTreeNode *)descendantNodeAtIndexPath:(NSIndexPath *)indexPath;

/**
 * @brief 使用指定的排序描述符对节点进行排序，可选择是否扩展到子节点
 *
 * @param sortDescriptors    指定的排序描述符的数组
 * @param recursively        是否扩展到子节点；YES表示扩展到子节点，NO表示仅对当前节点进行排序
 *
 * @discussion              该方法会对节点进行排序，使用指定的排序描述符进行比较。如果设置了recursively参数，也会对子节点进行排序。
 *                          例如，当需要按名称对文件系统的树结构进行排序时，可以使用该方法并提供适当的排序描述符来实现。
 */
- (void)sortWithSortDescriptors:(NSArray<NSSortDescriptor *> *)sortDescriptors recursively:(BOOL)recursively;

/** 该节点所表示的对象 */
@property(nullable, readonly, strong) id representedObject;
/** 该节点在树中的路径 */
@property(readonly, strong) NSIndexPath *indexPath;
/** 该节点是否为叶节点 */
@property(getter=isLeaf, readonly) BOOL leaf;
/** 该节点的子节点数组 */
@property(nullable, readonly, copy) NSArray<NSTreeNode *> *childNodes;
/** 可变的子节点数组 */
@property(readonly, strong) NSMutableArray<NSTreeNode *> *mutableChildNodes;
/** 该节点的父节点 */
@property(nullable, readonly, weak) NSTreeNode *parentNode;

@end