Class

MobileSharingPanel

Description

A Sharing Panel allows the application to share a piece of text, a URL, or a picture with any registered system service or app.

Properties

Name	Type	Read-Only	Shared
Name	String	✓

Methods

Name	Parameters	Returns
Handle		Ptr
SharePicture	pic As Picture, parentScreen As MobileScreen = Nil, parentControl As MobileUIControl = Nil
ShareText	textToShare As String, parentScreen As MobileScreen = Nil, parentControl As MobileUIControl = Nil
ShareURL	url As String, parentScreen As MobileScreen = Nil, parentControl As MobileUIControl = Nil

Events

Name	Parameters	Returns
Cancelled
Closing
Completed
Opening

Property descriptions

MobileSharingPanel.Name

Name As String

The name of the control.

Method descriptions

MobileSharingPanel.Handle

Handle As Ptr

The handle to the underlying native OS control.

Important

This is supported for iOS only.

MobileSharingPanel.SharePicture

SharePicture(pic As Picture, parentScreen As MobileScreen = Nil, parentControl As MobileUIControl = Nil)

Displays the sharing panel to the user, allowing them to share the passed picture.

A NilObjectException is raised if pic is Nil.

Share a picture:

MySharingPanel.SharePicture(myPic, Self, Me)

MobileSharingPanel.ShareText

ShareText(textToShare As String, parentScreen As MobileScreen = Nil, parentControl As MobileUIControl = Nil)

Displays the sharing panel to the user, allowing them to share the passed text.

Share text from a Text Area:

MySharingPanel.ShareText(DescArea.Text, Self, Me)

MobileSharingPanel.ShareURL

ShareURL(url As String, parentScreen As MobileScreen = Nil, parentControl As MobileUIControl = Nil)

Displays the sharing panel to the user, allowing them to share the passed URL.

An InvalidArgumentException is raised if the url parameter is not a valid URL construct.

Share a URL:

MySharingPanel.ShareURL("http://www.wikipedia.org", Self, Me)

Event descriptions

MobileSharingPanel.Cancelled

Cancelled

Called when the sharing panel has been cancelled.

MobileSharingPanel.Closing

Closing

Called when the control's layout is closing.

MobileSharingPanel.Completed

Completed

Called when the the sharing panel closes because the user completed sharing something.

MobileSharingPanel.Opening

Opening

Called when the control's layout is opening.

This is where you typically put initialization code.

This example in the Opening event of a label sets its text to "Hello":

Me.Text = "Hello"

Notes

By default, Xojo provides a default message that will appear when the user is asked for permission to access their photo library. If you wish to customize this message, go to Build Settings in the Navigator, click on iOS then click on the Advanced tab in the Inspector. Enable Photo Access then click the Options button.

Compatibility

Mobile projects on all supported mobile operating systems.