ADC Home > Reference Library > Reference > Audio > Carbon > Disc Recording Framework Reference
|
DRFolder(VirtualFolders) |
Extends Class: | |
Declared In: |
This category on DRFolder defines methods that allow creation and manipulation of folders on the output disc that do not exist on the source media.
addChild: |
Adds an object reference (either a file or folder) as a child of a virtual folder object.
- (void) addChild:(DRFSObject*)child;
child
This method only applies to virtual folders. Real folders are considered leaf nodes and cannot have children.
children |
Returns an array containing the children of a virtual folder.
- (NSArray*) children;
An NSArray of DRFile and DRFolder objects.
The order of children in the array is arbitrary -- since the various filesystems being
generated may have different sorting requirements, there is no one true
way to sort the children. The ordering will change only when children
are added or removed. You should sort the children according to the needs
of your display, and in a consistent manner.
This function only applies to virtual folders. Real folders
are considered leaf nodes and should not be passed into this call.
count |
Returns the number of children of a virtual folder.
- (NSUInteger) count;
A count of the number of children.
This method returns a
shallow count of only those children that are immediately contained
within the virtual folder.
This method only applies to virtual folders. Real folders
are considered leaf nodes and should not be messaged with this call.
initWithName: |
Initializes a virtual file object
- (id) initWithName:(NSString*)name;
name
A DRFolder object.
Initializes a DRFolder object that will be populated with specified DRFile and DRFolder objects at runtime.
makeVirtual |
Changes the real DRFolder object into a virtual DRFolder object.
- (void) makeVirtual;
The virtual folder created in this way is a snapshot of the on-disk
folder at the moment of the call. The newly created virtual folder
will contain real folder and file objects corresponding to the
on-disk children of the original on-disk folder.
If the on-disk folder is modified (eg, if the folder attributes change,
or if children are added to or removed from the on-disk tree):
during this call, the virtual folder may or may not reflect the changes.
If modified after this call, the virtual folder will not reflect
the changes.
removeChild: |
Removes an object reference (either a file or folder) as a child of a virtual folder object.
- (void) removeChild:(DRFSObject*)child;
child
This method only applies to virtual folders. Real folders are considered leaf nodes and cannot have children.
virtualFolderWithName: |
Creates a virtual folder object
+ (DRFolder*) virtualFolderWithName:(NSString*)name;
name
An autoreleased DRFolder object.
Creates and initializes a DRFolder object that will be populated with specified DRFile and DRFolder objects at runtime.
|