# Transfer List

## Simple Transfer List

Create a simple transfer list.

```powershell
New-UDTransferList -Item {
    New-UDTransferListItem -Name 'test1' -Value 1
    New-UDTransferListItem -Name 'test2' -Value 2
    New-UDTransferListItem -Name 'test3' -Value 3
    New-UDTransferListItem -Name 'test4' -Value 4
    New-UDTransferListItem -Name 'test5' -Value 5
} 
```

![](https://620394196-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M6jY7sXTmhiAIMGYw_m%2F-Mj0MkkKJWyR9_pB7ip6%2F-Mj0NVmBk8BK4tNxqx6U%2Fimage.png?alt=media\&token=9b81eb5a-d3e5-4a52-a30a-f49663781c6b)

## Transfer List Value on Change

Use the `OnChange` event handler to get the value of the selected items. 

```powershell
New-UDTransferList -Item {
    New-UDTransferListItem -Name 'test1' -Value 1
    New-UDTransferListItem -Name 'test2' -Value 2
    New-UDTransferListItem -Name 'test3' -Value 3
    New-UDTransferListItem -Name 'test4' -Value 4
    New-UDTransferListItem -Name 'test5' -Value 5
} -OnChange {
    Show-UDToast ($EventData | ConvertTo-Json)
}
```

## Transfer List in a Form

Transfer lists can be used within forms and steppers. 

```powershell
New-UDForm -Content {
    New-UDTransferList -Item {
        New-UDTransferListItem -Name 'test1' -Value 1
        New-UDTransferListItem -Name 'test2' -Value 2
        New-UDTransferListItem -Name 'test3' -Value 3
        New-UDTransferListItem -Name 'test4' -Value 4
        New-UDTransferListItem -Name 'test5' -Value 5
    }
} -OnSubmit {
    Show-UDToast ($EventData | ConvertTo-Json)
}
```

## API 

* [New-UDTransferList](https://github.com/ironmansoftware/universal-docs/blob/master/cmdlets/New-UDTransferList.txt)
* [New-UDTransferListItem](https://github.com/ironmansoftware/universal-docs/blob/master/cmdlets/New-UDTransferListItem.txt)