Programmer Guide/Macro Library/INITDIALOGITEM: Difference between revisions

From STX Wiki
Jump to navigationJump to search
(initial import)
 
m (Text replace - "S_TOOLS-STx" to "{{STX}}")
 
(One intermediate revision by one other user not shown)
Line 4: Line 4:
==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 S_TOOLS-STx constants (like colors, fonts, ..) and for system devices (like drives, wave devices, files, ..).
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, ..).





Latest revision as of 16:57, 5 April 2011




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

Navigation menu

Personal tools