AppointmentManager.ShowAddAppointmentAsync Method

Definition

Namespace:

Windows.ApplicationModel.Appointments

Overloads

ShowAddAppointmentAsync(Appointment, Rect)	Shows the Appointments provider Add Appointment UI, to enable the user to add an appointment.
ShowAddAppointmentAsync(Appointment, Rect, Placement)	Shows the Appointments provider Add Appointment UI, to enable the user to add an appointment.

ShowAddAppointmentAsync(Appointment, Rect)

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

public:
 static IAsyncOperation<Platform::String ^> ^ ShowAddAppointmentAsync(Appointment ^ appointment, Rect selection);

/// [Windows.Foundation.Metadata.Overload("ShowAddAppointmentAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<winrt::hstring> ShowAddAppointmentAsync(Appointment const& appointment, Rect const& selection);

[Windows.Foundation.Metadata.Overload("ShowAddAppointmentAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<string> ShowAddAppointmentAsync(Appointment appointment, Rect selection);

function showAddAppointmentAsync(appointment, selection)

Public Shared 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 appointment. This serves as an appointment identifier for future reference when updating or removing. If the appointment identifier returned is an empty string, the appointment was not added to the Appointments provider app.

Attributes

OverloadAttribute RemoteAsyncAttribute

Windows requirements

App capabilities

appointmentsSystem

Remarks

When you call this method, the Appointment provider app displays in a light-dismiss pane that is hosted by your app.

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

For info about how to manage appointments, see Manage appointments.

See also

• ShowAddAppointmentAsync(Appointment, Rect, Placement)

ShowAddAppointmentAsync(Appointment, Rect, Placement)

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

public:
 static IAsyncOperation<Platform::String ^> ^ ShowAddAppointmentAsync(Appointment ^ appointment, Rect selection, Placement preferredPlacement);

/// [Windows.Foundation.Metadata.Overload("ShowAddAppointmentWithPlacementAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<winrt::hstring> ShowAddAppointmentAsync(Appointment const& appointment, Rect const& selection, Placement const& preferredPlacement);

[Windows.Foundation.Metadata.Overload("ShowAddAppointmentWithPlacementAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<string> ShowAddAppointmentAsync(Appointment appointment, Rect selection, Placement preferredPlacement);

function showAddAppointmentAsync(appointment, selection, preferredPlacement)

Public Shared Function ShowAddAppointmentAsync (appointment As Appointment, selection As Rect, preferredPlacement As Placement) 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.

preferredPlacement

Placement

The Placement that describes the preferred placement of the Add Appointment UI.

Returns

IAsyncOperation<String>

IAsyncOperation<Platform::String>

IAsyncOperation<winrt::hstring>

When this method completes, it returns a String object that represents the appointment. This serves as an appointment identifier for future reference when updating or removing. If the appointment identifier returned is an empty string, the appointment was not added to the Appointments provider app.

Attributes

OverloadAttribute RemoteAsyncAttribute

Windows requirements

App capabilities

appointmentsSystem

Remarks

See the remarks in the following overload: ShowAddAppointmentAsync.

See also

• ShowAddAppointmentAsync(Appointment, Rect)