Programmer Guide/Macro Library/INITDIALOGITEM



INITDIALOGITEM

This macro is used to initialize the content of dialog controls of type combobox, listbox and listview. It implements a large set of initializations for STx constants (like colors, fonts, ..) and for system devices (like drives, wave devices, files, ..).



INITDIALOGITEM CHANNELS default [waveitem|asetiref]

usage:

default	default channel index
waveitem	name of wave-item
asetiref	DataSet audio-set reference

result:

channel table and default channel index ('table index')

description:

Returns a channel table for the current soundfile or the specified wave-item or audio-set. The table contains an entry for all-channels and one for each channel of the signal.



INITDIALOGITEM COLORS

Usage:

INITDIALOGITEM COLORS [ colorScheme ]

Parameters:

colorScheme

The name of an existing color scheme in the current workspace file (e.g. stxini.xml). If colorScheme is not specified, the default color scheme is used.

Result:

A color table and the default color index in the following format:

table index

Description:

Returns a (simple) table containing all defined colors.

Examples:

Retrieve a list of the available colors into a table.

readstr '$(initdialogitem color)' #tColorList #defaultColorId
showitem $#tColorList
um Default color is $#tColorList[$#defaultColorId]



INITDIALOGITEM DIRECTORIES table [name1 ; name2 ; ...]

usage:

table	name of target table or * for new table
nameX	directory names, wildcards are allowed (def.=*)

result:

directory name table ('table')

description:

Scans the current directory for specified (or all) subdirectories and returns a table containing the names of found directories (rel. path, no directory or drive).



INITDIALOGITEM DRIVES

result:

drive name table and list of drive letters ('table drive1 ... driveN')

description:

Scans for available (mounted) disk drives and stores the drive letter and the drive name in a table ('driveXletter:\ driveXname').



INITDIALOGITEM FIELDNAMES table [default]

usage:

table	name of extended table
default	default field index

result:

field name table and default field index ('table index')

description:

Returns a (simple) table containing all field names of the specified extended table.



INITDIALOGITEM FILES table [name1 ; name2 ; ...]

usage:

table	name of target table or * for new table
nameX	filenames, wildcards are allowed (def.=*)

result:

file name table ('table')

description:

Scans the current directory for specified (or all) files and returns a table containing the names of found files (name.extension, no directory or drive).



INITDIALOGITEM FONTS [default]

usage:

default

default font name

result:

font name table and default font index ('table index')

description:

Returns a (simple) table containing all defined font names.



INITDIALOGITEM TABLE default line1 ; line2 ; ... ; lineN

usage:

default	default line index
lineX	lines to be stored in table

result:

line table and default line index ('table index')

description:

Stores the specified lines in a simple table.



INITDIALOGITEM WAVEIN|WAVEOUT

result:

table with wave-in/out device names ('table')

description:

Stores the installed wave-in|out wave device names in a table.

Array