Class # iOSPicturePicker ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Warning
This item was deprecated in version 2020r2. Please use `MobileImagePicker` as a replacement.
## Description The iOSPicturePicker allows selection of an image stored on the device (or taken with the camera) for use in the app. ## Properties
table-centered_columns_3_and_4
| Name | Type | Read-Only | Shared | |-------------------------------------------|---------------------------------------------|-----------|--------| | `Handle` | `Ptr` | ✓ | | | `IsEditable` | `Boolean` | | | | `Source` | `Sources` | | | ## Methods
table-centered_column_4
| Name | Parameters | Returns | Shared | |-------------------------------|-----------------------------------------------------------------------|---------|--------| | `Show` | parentView As `MobileScreen` | | | ## Events
table-centered_column_4
| Name | Parameters | Returns | |-----------------------------------------|-----------------------------------------|---------| | `Cancelled` | | | | `Selected` | pic As `Picture` | | ## Enumerations
forsearch
iOSPicturePicker.Sources ### Sources These are the source locations from which the user can select a picture. | Enum | Description | |--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Camera | The user is prompted to take a picture with the camera. When running in the iOS Simulator an `UnsupportedOperationException` is raised if you try to use Camera. | | CameraRoll | Lets the user choose from the pictures saved in the camera roll. | | PhotoLibrary | Lets the user choose a picture from anywhere on the device (albums, camera roll, etc). | ## Property descriptions
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
forsearch
iOSPicturePicker.Handle **Handle** As `Ptr` Used for creating Declares to the underlying UIImagePickerController. This property is read-only.
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
forsearch
iOSPicturePicker.IsEditable **IsEditable** As `Boolean` Indicates if the user can edit the picture in the picker. Display a picture picker that lets the user edit the picture they select: ``` xojo MyPicPicker.IsEditable = True MyPicPicker.Source = iOSPicturePicker.Sources.CameraRoll MyPicPicker.Show ```
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
forsearch
iOSPicturePicker.Source **Source** As `Sources` Uses the Sources enumeration to specify the source for the pictures to select from. Prompt the user to take a picture: ``` xojo MyPicPicker.Source = iOSPicturePicker.Sources.Camera MyPicPicker.Show ``` ## Method descriptions
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
forsearch
iOSPicturePicker.Show **Show**(parentView As `MobileScreen`) Displays the picture picker. This is not modal so your code continues running after calling Show. The Cancelled and Selected events are called based on the user's action. Display the picture picker: ``` xojo MyPicPicker.Show(Self) ``` ## Event descriptions
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
forsearch
iOSPicturePicker.Cancelled **Cancelled** The user cancelled the picking operation.
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
forsearch
iOSPicturePicker.Selected **Selected**(pic As `Picture`) Called when a picture is selected. pic is an iOSBitmap that can then be used by the app. Display the selected picture: ``` xojo MyImageView.Image = pic ``` ## Notes 2018r3 and later automatically add the NSCameraUsageDescription key to the plist. If your source is set to Sources.Camera and you're using an earlier version of Xojo, then you will also need to add a plist entry to tell iOS to allow camera access. ``` xml NSCameraUsageDescription Allow user to access the camera. ``` ## Compatibility iOS projects on the iOS operating system. ## See also `Object` parent class; `Picture`, `Picture` classes