AppointmentManagerForUser.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:
 virtual IAsyncOperation<Platform::String ^> ^ ShowAddAppointmentAsync(Appointment ^ appointment, Rect selection) = ShowAddAppointmentAsync;

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

[Windows.Foundation.Metadata.Overload("ShowAddAppointmentAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
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 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.

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:
 virtual IAsyncOperation<Platform::String ^> ^ ShowAddAppointmentAsync(Appointment ^ appointment, Rect selection, Placement preferredPlacement) = ShowAddAppointmentAsync;

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

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

function showAddAppointmentAsync(appointment, selection, preferredPlacement)

Public 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

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.

See also

• ShowAddAppointmentAsync(Appointment, Rect)