Xojo Documentation Xojo Documentation

The Sharing Panel allows the app to share text, a URL, or a picture with any registered iOS system service or app.

This control does not have UI that displays on the layout so it appears in the Shelf when dragged to the layout.

iOS Sharing Panel Library Icon

Below is a list of commonly used events, properties and methods. Refer to iOSSharingPanel in the Language Reference for details on its events and methods.

Events

Cancelled

Called if the user cancels the sharing operation.

Completed

Called when the sharing operation is completed.

Methods

SharePicture

Shares a picture. You need to provide the picture, the parent view and parent control.

ShareText

Shares text. You need to provide the text, the parent view and parent control.

ShareURL

Share a URL. You need to provide the URL, the parent view and parent control.

Usage

This code on a button's Action event handler shares text:

SharingPanel1.ShareText("Hello world!", Self, Me)

iOS Generic Sharing Panel

Starting with iOS 11, if you use the SharePicture method your app's Info.plist will need to include an NSPhotoLibraryAddUsageDescription key with a string value explaining to the user how the app uses this data. For example:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>NSPhotoLibraryAddUsageDescription</key>
	<string>Allow photos to be added to the photo library.</string>
</dict>
</plist>

Using an iOS Sharing Panel

Example Projects

• Examples/iOS/Controls/SharingPanel

See Also

iOSSharingPanel class; UserGuide:iOS UI topic