51.1 Overview

Volumelist generates a list of all available volumes. Since you shouldn't use your own file requester in every application, this class is probably not of much use.

Volumelist class creates a listview with the following five columns: Icon, name, fill state in percent, free space and used space. If you do not want to have all of these attributes displayed, you can use Listviewcolumn class to make adjustments.

Volumelist class is a subclass of listview class. Thus, you can use most attributes and methods of listview class on it too. For example, if you want to read the entries of your volumelist, just send the volumelist object a Listview.GetEntry method, or if you want to listen to changes in the active list entry, set up a notification on Listview.Active.

When creating a volumelist object in XML code, you always have to add at least one column to it. This is done by using the Listviewcolumn class. Here is an example of a minimal volumelist declaration with just a single column (the icon column, that is):

 
<volumelist>
   <column/>  <!-- Icon -->
</volumelist>

Here is a declaration that includes all five columns:

 
<volumelist>
   <column/>  <!-- Icon -->
   <column/>  <!-- Name -->
   <column/>  <!-- Percent -->
   <column/>  <!-- Free -->
   <column/>  <!-- Used -->
</volumelist>

If you only want to have the name column and the percent column displayed, you can use the Listviewcolumn.Col attribute to achieve this:

 
<volumelist>
   <column col="1"/>  <!-- Name -->
   <column col="2"/>  <!-- Percent -->
</volumelist>

See Listview class for details.

See Listviewcolumn class for details.

Show TOC