appointmentmanager_showaddappointmentasync_253292089.md

-api-id	-api-type
M:Windows.ApplicationModel.Appointments.AppointmentManager.ShowAddAppointmentAsync(Windows.ApplicationModel.Appointments.Appointment,Windows.Foundation.Rect,Windows.UI.Popups.Placement)	winrt method

Windows.ApplicationModel.Appointments.AppointmentManager.ShowAddAppointmentAsync

-description

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

-parameters

-param appointment

The object representing the information for the appointment to add.

-param selection

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.

-param preferredPlacement

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

-returns

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.

-remarks

See the remarks in the following overload: ShowAddAppointmentAsync.

-examples

-see-also

ShowAddAppointmentAsync(Appointment, Rect)

-capabilities

appointmentsSystem