AppointmentStore.ShowAddAppointmentAsync(Appointment, Rect) Method

Definition

Shows the Appointments provider Add Appointment UI, to enable the user to add an appointment.

public:
 virtual IAsyncOperation<Platform::String ^> ^ ShowAddAppointmentAsync(Appointment ^ appointment, Rect selection) = ShowAddAppointmentAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<winrt::hstring> ShowAddAppointmentAsync(Appointment const& appointment, Rect const& selection);
IAsyncOperation<winrt::hstring> ShowAddAppointmentAsync(Appointment const& appointment, Rect const& selection);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<string> ShowAddAppointmentAsync(Appointment appointment, Rect selection);
public IAsyncOperation<string> ShowAddAppointmentAsync(Appointment appointment, Rect selection);
function showAddAppointmentAsync(appointment, selection)
Public Function ShowAddAppointmentAsync (appointment As Appointment, selection As Rect) As IAsyncOperation(Of String)

Parameters

appointment
Appointment

The object representing the information for the appointment to add.

selection
Rect

The Rect is the rectangular area of user selection (for example, pressing a button), around which the operating system displays the Add Appointment UI, not within that rectangular area. For example, if an app uses a button to show the Rect, pass the Rect of the button so the Add Appointment UI displays around the button, not overlapping it.

Returns

IAsyncOperation<String>

IAsyncOperation<Platform::String>

IAsyncOperation<winrt::hstring>

When this method completes, it returns a String object that represents the RoamingId of the appointment. If the appointment identifier returned is an empty string, the appointment was not added to the Appointments provider app.

Attributes

Windows requirements

App capabilities
appointmentsSystem

Remarks

For Windows Phone 8.x apps, this method behaves the same as ShowEditNewAppointmentAsync, in that the fields in the Add Appointment UI are editable by the user.

Applies to