afc_dirmaster_set_tag

Name

afc_dirmaster_set_tag  -- Set a tag

Synopsis

int afc_dirmaster_set_tags ( DirMaster * dm, int tag, void * value );

Description

This functions set a tag in the current instance.

Inputs

dm

Pointer to a valid DirMaster instance

tag

Tag to set. Valid values are:

AFC_DIRMASTER_TAG_DATE_FORMAT

The date format to use in rappresentation. Valid values are:

DATEFORMAT_DD_MM_YYYY

Standard European date format: day/month/year.

DATEFORMAT_MM_DD_YYYY

Standard American date format: month/day/year.

DATEFORMAT_HH_MM

Just hour and minutes are shown.

DATEFORMAT_HH_MM_SS

Just hour, minutes and seconds are shown.

DATEFORMAT_DD_MM_YYYY_HH_MM

Standard European date plus hour and minutes.

DATEFORMAT_MM_DD_YYYY_HH_MM

Standard American date plus hour and minutes.

AFC_DIRMASTER_TAG_SIZE_FORMAT

The format to be used to show file and dirs size. Valid values are:

SIZEFORMAT_BYTES

The file size is shown in bytes

SIZEFORMAT_HUMAN

The file size is shown in human readable way, with 1K corresponding to 1024 bytes

SIZEFORMAT_HUMAN_1000

The file size is shown in human readable way, with 1K corresponding to 1000 bytes.

AFC_DIRMASTER_TAG_SIZE_DECIMALS

The number of decimals to use in file size. This tag has effect only if the AFC_DIRMASTER_TAG_SIZE_FORMAT is set to something different from SIZEFORMAT_BYTES.

AFC_DIRMASTER_TAG_CONV_DATE_MODIFY

A boolean value. If it is set to TRUE, then the file modification date will be converted into the string specified by DATEFORMAT_* values.

AFC_DIRMASTER_TAG_CONV_DATE_ACCESS

A boolean value. If it is set to TRUE, then the file access date will be converted into the string specified by DATEFORMAT_* values.

AFC_DIRMASTER_TAG_CONV_DATE_CHANGE

A boolean value. If it is set to TRUE, then the file change date will be converted into the string specified by DATEFORMAT_* values.

AFC_DIRMASTER_TAG_CONV_USER

A boolean value. If it is set to TRUE, then the file user id will be converted to the string rappresenting the user in the system.

AFC_DIRMASTER_TAG_CONV_GROUP

A boolean value. If it is set to TRUE, then the file group id will be converted to the string rappresenting the group in the system.

AFC_DIRMASTER_TAG_CONV_MOVE

A boolean value. If it is set to TRUE, then the file access mode will be converted to the string rappresenting it (eg. '-rwxr-xr-x' )

AFC_DIRMASTER_TAG_SORT_FIELD

The field that will be used when sorting. Valid values are:

FINFO_NAME

Sort by file name

FINFO_MODE

Sort by file mode

FINFO_USER

Sort by user id

FINFO_GROUP

Sort by group id

FINFO_DATE_ACCESS

Sort by date access

FINFO_DATE_MODIFY

Sort by date modification

FINFO_DATE_CHANGE

Sort by date change

FINFO_SIZE

Sort by file size

AFC_DIRMASTER_TAG_SORT_CASE_INSENSITIVE

A boolean value. If TRUE, the next sort will not consider case sense while comparing strings.

AFC_DIRMASTER_TAG_SORT_INVERTED

A boolean value. If TRUE, the next sort will return an inverted list, eg. from Z to A and not A-Z.

value

Value to set

Result

should return AFC_ERR_NO_ERROR.

See Also