+ (MUIDirlist *) dirlist

Default constructor

- (OBString *) directory

Set a new directory for the dirlist object. Since reading a directory can take a long long time, MUI delegates this work to a sub task.

Setting this attribute causes the object to clear the current directory (if any) and start loading a new one. MUIA_Dirlist_Status will be set to MUIV_Dirlist_Status_Reading and the sub task will be launched.

By listening to MUIA_Dirlist_Status, you can learn if the directory reading is completed or if something went wrong.

A value of NULL just clears the current directory and sets MUIA_Dirlist_Status to MUIV_Dirlist_Status_Invalid.

- (ULONG) exAllType

Set an ExAll() type to use. If you need the ExAllData structure in a Dirlist hook, set the type you need here, then get the attribute again to make sure your type is supported by MUI. Note that you might get a higher type back.

- (void) noNotifySetAcceptPattern:(OBString *)acceptpattern

- (void) noNotifySetDirectory:(OBString *)directory

- (void) noNotifySetDrawersOnly:(BOOL)drawersonly

- (void) noNotifySetFilesOnly:(BOOL)filesonly

- (void) noNotifySetFilterDrawers:(BOOL)filterdrawers

- (void) noNotifySetFilterHook:(struct Hook *)filterhook

- (void) noNotifySetMultiSelDirs:(BOOL)multiseldirs

- (void) noNotifySetPattern:(OBString *)pattern

- (void) noNotifySetRejectIcons:(BOOL)rejecticons

- (void) noNotifySetRejectPattern:(OBString *)rejectpattern

- (void) noNotifySetSortDirs:(LONG)sortdirs

- (void) noNotifySetSortHighLow:(BOOL)sorthighlow

- (void) noNotifySetSortType:(LONG)sorttype

- (LONG) numBytes

When MUIA_Dirlist_Status is MUIV_Dirlist_Valid, you can obtain the number of bytes occupied by the directory from this tag.

- (QUAD *) numBytes64

- (LONG) numDrawers

When MUIA_Dirlist_Status is MUIV_Dirlist_Valid, you can obtain the number of drawers in the displayed directory from this tag.

- (LONG) numFiles

When MUIA_Dirlist_Status is MUIV_Dirlist_Valid, you can obtain the number of files in the displayed directory from this tag.

- (OBString *) path

When MUIA_Dirlist_Status is MUIV_Dirlist_Valid and you have an active entry in the list (MUIA_List_Active not equal MUIV_List_Active_Off), you will receive a pointer to the complete path specification of the selected file. Otherwise you get a NULL.

- (IPTR) reRead

- (IPTR) rename:(LONG)row newname:(OBString *)newname

- (void) setAcceptPattern:(OBString *)acceptpattern

- (IPTR) setComment:(LONG)row comment:(OBString *)comment

- (void) setDirectory:(OBString *)directory

- (void) setDrawersOnly:(BOOL)drawersonly

Indicate whether you only want drawers to be displayed.

- (void) setExAllType:(ULONG)exalltype

CAUTION: this is an initializer attribute, meaning it cannot be changed after the underlying MUI object is instantiated

- (void) setFilesOnly:(BOOL)filesonly

Indicate whether you only want files to be displayed.

- (void) setFilterDrawers:(BOOL)filterdrawers

Indicate whether you want drawers matched agains MUIA_Dirlist_RejectPattern and MUIA_Dirlist_AcceptPattern.

Defaults to FALSE.

- (void) setFilterHook:(struct Hook *)filterhook

- (void) setMultiSelDirs:(BOOL)multiseldirs

- (void) setPattern:(OBString *)pattern

- (IPTR) setProtection:(LONG)row flags:(ULONG)flags

- (void) setRejectIcons:(BOOL)rejecticons

Indicate whether you want icons (*.info files) to be rejected.

- (void) setRejectPattern:(OBString *)rejectpattern

- (void) setSortDirs:(LONG)sortdirs

Adjust the place where directories shall be displayed.

- (void) setSortHighLow:(BOOL)sorthighlow

Indicate if you want to sort your directory reversely.

- (void) setSortType:(LONG)sorttype

Indicate what fields should be used as sort criteria.

- (LONG) status

Read the status of the dirlist object. The result is one of

MUIV_Dirlist_Status_Invalid: object contains no valid directory.

MUIV_Dirlist_Status_Reading 1: object is currently reading a new directory.

MUIV_Dirlist_Status_Valid 2 object contains a valid directory.