Christian: Text replace - "S_TOOLS-STx" to "{{STX}}"

2011-04-05T15:57:28Z

Text replace - "S_TOOLS-STx" to "{{STX}}"

← Older revision		Revision as of 17:57, 5 April 2011
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, ..).

Admin: 1 revision: Initial import

2010-11-18T16:31:27Z

1 revision: Initial import

← Older revision	Revision as of 18:31, 18 November 2010
(No difference)

Unknown user: initial import

1970-01-01T00:00:00Z

initial import

New page

{{DISPLAYTITLE:{{SUBPAGENAME}}}}

==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, ..).

==INITDIALOGITEM CHANNELS default [waveitem|asetiref]==

=====usage:=====

{|
|-
|default
|default channel index
|-
|waveitem
|name of wave<nowiki>-</nowiki>item
|-
|asetiref
|DataSet audio<nowiki>-</nowiki>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:=====

<code>INITDIALOGITEM COLORS [ <var>colorScheme</var> ]</code>

=====Parameters:=====

;<var>colorScheme</var>

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

=====Result:=====

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

<code>table index</code>

=====Description:=====

Returns a (simple) table containing all defined colors.

=====Examples:=====

Retrieve a list of the available colors into a table.

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

==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

Programmer Guide/Macro Library/INITDIALOGITEM - Revision history

Christian: Text replace - "S_TOOLS-STx" to "{{STX}}"

Admin: 1 revision: Initial import

Unknown user: initial import