add casts to zune macros to silence some warnings
[tangerine.git] / workbench / system / Wanderer / Tools / DiskInfo / diskinfo.doc
blobd7107b8d4a4e0b5a14e44ab9a1592d85473e83d3
1 TABLE OF CONTENTS
3 DiskInfo.mui/DiskInfo.mui
5     A DiskInfo object, for general using and particulary Wanderer use.
7     BACKGROUND
8     DiskInfo provides a sub-window for disk/volumes informations
9     like size, name, icon image, buffers, Format feature, etc.
10     User can set different aspects and skills levels.
11     DiskInfo requires one argument: The initial path to disk icon.
13     EXAMPLE
14     {
15     ...
16         if (DiskInfo_Initialize())
17         {
18         ...
19             application = DiskInfoObject,
20                 MUIA_DiskInfo_Initial, (IPTR) initial,
21             End;
23             if (application != NULL)
24             {
25                 DoMethod(application, MUIM_Application_Execute);
26                 MUI_DisposeObject(application);
27             }
28         ...
29             DiskInfo_Deinitialize();
30         }
31     ...
32     }
34     FUNCTIONS
35     DiskInfo.mui/DiskInfo_Initialize()
36     DiskInfo.mui/DiskInfo_Deinitialize()
38     ATTRIBUTES
39     DiskInfo.mui/MUIA_DiskInfo_Initial   [I..]
40     DiskInfo.mui/MUIA_DiskInfo_Volname   [..G]
41     DiskInfo.mui/MUIA_DiskInfo_Percent   [..G]
42     DiskInfo.mui/MUIA_DiskInfo_Aspect    [ISG]
43     DiskInfo.mui/MUIA_DiskInfo_UserLevel [..G]
45     METHODS
46     DiskInfo.mui/MUIM_Application_Execute
47     DiskInfo.mui/OM_NEW
48     DiskInfo.mui/OM_GET
49     DiskInfo.mui/OM_SET
50     DiskInfo.mui/OM_DISPOSE
52 DiskInfo.mui/DiskInfo_Initialize()
54     NAME
55     DiskInfo_Initialize()
58 DiskInfo.mui/MUIA_DiskInfo_Initial
60     NAME
61     MUIA_DiskInfo_Initial -- [I..], STRPTR
63     FUNCTION
64     Provide at initialization time a path to the disk.
66     EXAMPLE
67     Wanderer Info passes a "Volume:Disk" string.
68     (because of its icon oriented nature, given that a volume
69     icon is located at volume root in "Disk.info").
71     SEE ALSO
72     DiskInfo.mui/MUIA_DiskInfo_Volname
74 DiskInfo.mui/MUIA_DiskInfo_Volname
76     NAME
77     MUIA_DiskInfo_Volname -- [..G], STRPTR
79     FUNCTION
80     Compute the volume name from the path given through MUIA_DiskInfo_Initial.
82     SEE ALSO
83     DiskInfo.mui/MUIA_DiskInfo_Initial
85 DiskInfo.mui/MUIA_DiskInfo_Percent
87     NAME
88     MUIA_DiskInfo_Percent -- [..G], ULONG
90     FUNCTION
91     Compute the percent of disk full.
93     SEE ALSO
95 DiskInfo.mui/MUIA_DiskInfo_Aspect
97     NAME
98     MUIA_DiskInfo_Aspect -- [ISG], ULONG
100     FUNCTION
101     GUI Aspect, actually 2 aspects are available.
102     More in the future.
104     SEE ALSO
106 DiskInfo.mui/MUIA_DiskInfo_UserLevel
108     NAME
109     MUIA_DiskInfo_UserLevel -- [..G], ULONG
111     FUNCTION
112     UserLevel follows the Installer® MINUSER level:
113         NOVICE              -> Hidden "Format" button
114         AVERAGE/ADVANCED    -> Ghosted "Format" button, &checkmark
115         EXPERT              -> Active "Format" button.
116     By default AVERAGE, but ideally read from SYS:Utilities/Installer.info icon
117     "MINUSER" tooltype.
119     SEE ALSO