JamDriveList object Plugin Help File

JamDriveList object Plugin Help File

Plugin Name:

JamDriveList object Plugin

Current Version:

1.5.0.0

Description:

An object that displays a list of drives of the system, where we can interact with them with various functions

Licence:

free

Author:

rafaxplayer

Requirements:

Require Memory plugin and ShellBrowserX.ocx

Install Notes:

Copy the plugin folder and the directory of AMS / Plugins / Objects, also requires copying the contents of "Dependencies" in our AMS project, path: CD_Root / AutoPlay / Plugins, that's all.


Table of Contents

DriveList.CreateObject(ObjectName)
DriveList.SetCheckBoxes
DriveList.SetShellContextMenu
DriveList.AddEditableItem
DriveList.CheckAllItems
DriveList.SetMutiSelect
DriveList.SmartRefresh
DriveList.FullRefresh
DriveList.Clear
DriveList.SelectAll
DriveList.SetColor
DriveList.ShowColumnHeaders
DriveList.DeleteSelected
DriveList.ShowGridLines
DriveList.GetItemIndexSelected
DriveList.InvokeCommandOnselect
DriveList.GetSelectedPath
DriveList.AutomaticRefresh
DriveList.SetSelectItemIndex
DriveList.GetSelecetdCount
DriveList.ShowDetails
DriveList.ShowShellObjectNames
DriveList.SetStatusBarColor
DriveList.SetFontColor
DriveList.IsItemInList
DriveList.GetInfoDrive
DriveList.StartEvents

DriveList.CreateObject(ObjectName)


DriveList.CreateObject(ObjectName) ( 

(string) Object Name = "Plugin1" )

Description

Create to DriveList object

Parameters

Object Name

(string) Name of the Drive List Object

Returns

This action dose not return any value.


Example

DriveList.CreateObject("Plugin1")



DriveList.SetCheckBoxes


DriveList.SetCheckBoxes ( 

(string) Object Name = "Plugin1",

(boolean) Show = true )

Description

Displays or hides Checkboxes

Parameters

Object Name

(string) Name of the Drive List Object

Show

(boolean) Show or not CheckBoxes

Value

Description

true

(Default) show

false

Hide

Returns

This action dose not return any value.


Example

DriveList.SetCheckBoxes("Plugin1",true)



DriveList.SetShellContextMenu


DriveList.SetShellContextMenu ( 

(string) Object Name = "Plugin1",

(boolean) Value = false )

Description

Activate or not Contex menu on Right Click

Parameters

Object Name

(string) Name of the driveList Object

Value

(boolean) Activate or not

Note: Deaful true

Value

Description

true

Activate

false

(Default) disable

Returns

This action dose not return any value.


Example

check = CheckBox.GetChecked(this)
    if check then
        DriveList.SetShellContextMenu("Plugin1",true)
    else
        DriveList.SetShellContextMenu("Plugin1",false)
    end    



DriveList.AddEditableItem


DriveList.AddEditableItem ( 

(string) Object Name = "Plugin1",

(string) Path = "_SourceFolder",

(boolean) Editable = true )

Description

Add folder editable from a path in the system

Parameters

Object Name

(string) Name of the DriveList object

Path

(string) Folder Path

Editable

(boolean) Bolean value , editable Item or not

Note: Default true

Value

Description

true

(Default) Editable

false

not editable

Returns

This action dose not return any value.


Example

xFolder = Dialog.FolderBrowse("Please select a folder:", "AutoPlay\\Docs");
    if xFolder ~= "CANCEL" then
        DriveList.AddEditableItem("Plugin1",xFolder,true)
        CheckBox.SetChecked("CheckBox1", true);
    end    



DriveList.CheckAllItems


DriveList.CheckAllItems ( 

(string) Object Name = "Plugin1",

(boolean) Check = true )

Description

Checking will all checkbox object

Note: If there are also hidden the checking will

Parameters

Object Name

(string) Name of the DriveList object

Check

(boolean) Check/Uncheck all items

Note: defaul false

Value

Description

true

(Default) Check all

false

UnCheck all

Returns

This action dose not return any value.


Example

DriveList.CheckAllItems("Plugin1")



DriveList.SetMutiSelect


DriveList.SetMutiSelect ( 

(string) Object Name = "Plugin1",

(boolean) MultiSelect = true )

Description

Enable or not the multi selection of items

Note: default false

Parameters

Object Name

(string) Name of the Drive List Object

MultiSelect

(boolean) Enable or disable

Value

Description

true

(Default) Enable

false

Disable

Returns

This action dose not return any value.


Example

check = CheckBox.GetChecked(this)
    if check then
        DriveList.SetMutiSelect("Plugin1",true)
    else
        DriveList.SetMutiSelect("Plugin1",false)
    end    



DriveList.SmartRefresh


DriveList.SmartRefresh ( 

(string) Object Name = "Plugin1" )

Description

Smart Refresh

Parameters

Object Name

(string) Name of the Drive List Object

Returns

This action dose not return any value.


Example

DriveList.SmartRefresh("Plugin1")



DriveList.FullRefresh


DriveList.FullRefresh ( 

(string) Object Name = "Plugin1" )

Description

Full Refersh object

Parameters

Object Name

(string) Name of the DriveList Object

Returns

This action dose not return any value.


Example

DriveList.FullRefresh("Plugin1")



DriveList.Clear


DriveList.Clear ( 

(string) Object Name = "Plugin1" )

Description

Clear Object

Parameters

Object Name

(string) Name of the DriveList object

Returns

This action dose not return any value.


Example

DriveList.Clear("Plugin1")



DriveList.SelectAll


DriveList.SelectAll ( 

(string) Object Name = "Plugin1" )

Description

Select All items of the object

Parameters

Object Name

(string) Name of the Drive List Object

Returns

This action dose not return any value.


Example

DriveList.SelectAll("Plugin1")



DriveList.SetColor


DriveList.SetColor ( 

(string) Object Name = "Plugin1",

(number) Color = 0000 )

Description

Set background color

Parameters

Object Name

(string) Name of the DriveList object

Color

(number) Number of Color (Decimal value)

Returns

This action dose not return any value.


Example

local nColor = SysDialog.Color(65280);
if nColor~=nil then
    DriveList.SetColor("Plugin1",nColor.Decimal)
end



DriveList.ShowColumnHeaders


DriveList.ShowColumnHeaders ( 

(string) Object Name = "Plugin1",

(boolean) Show = false )

Description

Show or hide Column headers

Parameters

Object Name

(string) Name of the driveList Object

Show

(boolean) Show or Hide

Note: Default true

Value

Description

true

Show

false

(Default) Hide

Returns

This action dose not return any value.


Example

check = CheckBox.GetChecked(this)
    if check then
        DriveList.ShowColumnHeaders("Plugin1",true)
    else
        DriveList.ShowColumnHeaders("Plugin1",false)
    end    



DriveList.DeleteSelected


DriveList.DeleteSelected ( 

(string) Object Name = "Plugin1" )

Description

Delete Item selected

Note: No delete Files of system

Parameters

Object Name

(string) Name of the DriveList Object

Returns

This action dose not return any value.


Example

DriveList.DeleteSelected("Plugin1")



DriveList.ShowGridLines


DriveList.ShowGridLines ( 

(string) Object Name = "Plugin1",

(boolean) Show = true )

Description

Show or Hide grid lines

Note: deaful Hide

Parameters

Object Name

(string) Name of the DriveList Object

Show

(boolean) Show or Hide lines

Value

Description

true

(Default) Show lines

false

Hide lines

Returns

This action dose not return any value.


Example

DriveList.ShowGridLines("Plugin1",true)



DriveList.GetItemIndexSelected


(number) DriveList.GetItemIndexSelected ( 

(string) Object Name = "Plugin1" )

Description

Get a number index of the selected item

Parameters

Object Name

(string) Name of the DriveList Object

Returns

(number) if an error occurs, -1 is returned


Example

index = DriveList.GetItemIndexSelected("Plugin1")
if index ~= -1 then
Dialog.Message("Item","Index : "..index)
end



DriveList.InvokeCommandOnselect


(boolean) DriveList.InvokeCommandOnselect ( 

(string) Object Name = "Plugin1" )

Description

Run command on select drive

Parameters

Object Name

(string) Name of the Drive List object

Returns

(boolean) if command run then true is returned , if error ,false


DriveList.GetSelectedPath


(string) DriveList.GetSelectedPath ( 

(string) Object Name = "Plugin1" )

Description

Gea a selected item path

Parameters

Object Name

(string) Name of the DriveList Object

Returns

(string)


Example

path = DriveList.GetSelectedPath("Plugin1")
Dialog.Message("Path",path)



DriveList.AutomaticRefresh


DriveList.AutomaticRefresh ( 

(string) Object Name = "Plugin1",

(boolean) Aut. = true )

Description

Is automatically updated with changes

Parameters

Object Name

(string) Name of the driveList Object

Aut.

(boolean) refresh autmatic or not

Note: default false

Value

Description

true

(Default) Automatic refresh

false

not

Returns

This action dose not return any value.


Example

DriveList.AutomaticRefresh("Plugin1",true)



DriveList.SetSelectItemIndex


DriveList.SetSelectItemIndex ( 

(string) Object Name = "Plugin1",

(number) Index = 0 )

Description

Set selected item index

Note: The program applies the indices from 0, the first index = 0

Parameters

Object Name

(string) Name of the DriverList Object

Index

(number) index of the item to select

Returns

This action dose not return any value.


Example

DriveList.SelectItemIndex("Plugin1",3)



DriveList.GetSelecetdCount


(number) DriveList.GetSelecetdCount ( 

(string) Object Name = "Plugin1" )

Description

counts the number of selected items

Parameters

Object Name

(string) Name of the DriveList Object

Returns

(number)


Example

nCount = DriveList.GetSelecetdCount("Plugin1")
if nCoun ~= 0 then
Dialgog.Mesage("Items","Total Items : "..nCount)
end



DriveList.ShowDetails


DriveList.ShowDetails ( 

(string) Object Name = "Plugin1",

(boolean) Show = false )

Description

Show details or not

Parameters

Object Name

(string) Name of the DriveList Object

Show

(boolean) Show details or hide

Note: Default true

Value

Description

true

Show deatils

false

(Default) Hide

Returns

This action dose not return any value.


Example

check = CheckBox.GetChecked(this)
    if check then
        DriveList.ShowDetails("Plugin1",true)
    else
        DriveList.ShowDetails("Plugin1",false)
    end    



DriveList.ShowShellObjectNames


DriveList.ShowShellObjectNames ( 

(string) Object Name = "Plugin1",

(boolean) Show = false )

Description

Show or not Shell object names

Parameters

Object Name

(string) Name of the object

Show

(boolean) Show or Hide Shell names

Note: Default true

Value

Description

true

Show Names

false

(Default) Hide

Returns

This action dose not return any value.


Example

check = CheckBox.GetChecked(this)
    if check then
        DriveList.ShowShellObjectNames("Plugin1",true)
    else
        DriveList.ShowShellObjectNames("Plugin1",false)
    end    



DriveList.SetStatusBarColor


DriveList.SetStatusBarColor ( 

(string) Object Name = "Plugin1",

(number) Color = 0000 )

Description

Status Bar Color

Note: Changes apply to all bars

Parameters

Object Name

(string) Name of the DriveList Object

Color

(number) Number of Color (Decimal)

Returns

This action dose not return any value.


Example

local nColor = SysDialog.Color(65280);
if nColor~=nil then

    DriveList.SetStatusBarColor("Plugin1",nColor.Decimal)
end



DriveList.SetFontColor


DriveList.SetFontColor ( 

(string) Object Name = "Plugin1",

(number) Color = 0000 )

Description

Set font color

Parameters

Object Name

(string) Name of the Drive List Object

Color

(number) Number of color (Decimal)

Returns

This action dose not return any value.


Example

local nColor = SysDialog.Color(65280);
if nColor~=nil then

    DriveList.SetFontColor("Plugin1",nColor.Decimal)
end



DriveList.IsItemInList


(boolean) DriveList.IsItemInList ( 

(string) Object Name = "Plugin1",

(string) Text = "C:\" )

Description

Find an item with the name

Parameters

Object Name

(string) Nmae of the DriveList Object

Text

(string) Text of search item

Note: Case sensitive

Returns

(boolean) if item is in list return true , else false
Case sensitive and not Shell names


Example

Text = Dialog.Input("Enter Data", "Your Drive:", "C\:", MB_ICONQUESTION);
if Text ~= "CANCEL" then
result = DriveList.IsItemInList("Plugin1",Text)
Dialog.Message("Searching",tostring(result))
end



DriveList.GetInfoDrive


(table) DriveList.GetInfoDrive ( 

(string) Object Name = "Plugin1" )

Description

Info of Drive selected

Parameters

Object Name

(string) Name of the Drive List Object

Returns

(table) Index of table:
.DisplayName -- name display
.Type -- Type Hdd ( Fixed,Remobable,CD-Rom...)
.TotalSize -- The full Size of the HDD
.Usedpercent -- Percent space used in HDD
.Freepercet -- Percent Free Space in HDD
.Label -- label info
.FileSystem -- File system to HDD (NTFS,Fat..)
.Serial -- Serial number


Example

tbl_Drive = DriveList.GetInfoDrive("Plugin1")
text = "FullSize : "..tbl_Drive.TotalSize.."\r\n"
text = text .."Drive type : "..tbl_Drive.Type.."\r\n"
text = text .."Space used : "..tbl_Drive.Usedpercent.."\r\n"
text = text .."Free space : "..tbl_Drive.Freepercent.."\r\n"
text = text .."Label Info : "..tbl_Drive.Label.."\r\n"
text = text .."FileSystem Info : "..tbl_Drive.FileSystem.."\r\n"
text = text .."Serial Number : "..tbl_Drive.Serial.."\r\n"
text = text .."Info Dysplay name : "..tbl_Drive.DisplayName.."\r\n"

Dialog.Message("Info Drive",text)     



DriveList.StartEvents


DriveList.StartEvents ( 

(string) Object Name = "Plugin1" )

Description

On the events in the objects we use ( Max 3 Objects)

Note: This function is necessary to run the plugin

Parameters

Object Name

(string) Name of the drive List Object

Returns

This action dose not return any value.


Example

-- Eixample 1 object:
DriveList.StartEvents("Plugin1")
-- 2 objects..
DriveList.StartEvents("Plugin1","Plugin2")
-- 3 objects
DriveList.StartEvents("Plugin1","Plugin2","Plugin3")





This File Was Generated With AMS ActionFile Editor