System.Permissions.TPermissionsService.RequestPermissions

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

procedure RequestPermissions(const APermissions: TArray<string>;
const AOnRequestPermissionsResult: TRequestPermissionsResultEvent; AOnDisplayRationale: TDisplayRationaleEvent = nil);
procedure RequestPermissions(const APermissions: TArray<string>;
const AOnRequestPermissionsResult: TRequestPermissionsResultProc; AOnDisplayRationale: TDisplayRationaleProc = nil);

C++

virtual void __fastcall RequestPermissions(const System::DynamicArray<System::UnicodeString> APermissions, const TRequestPermissionsResultEvent AOnRequestPermissionsResult, TDisplayRationaleEvent AOnDisplayRationale = 0x0)/* overload */;
virtual void __fastcall RequestPermissions(const System::DynamicArray<System::UnicodeString> APermissions, const _di_TRequestPermissionsResultProc AOnRequestPermissionsResult, _di_TDisplayRationaleProc AOnDisplayRationale = _di_TDisplayRationaleProc())/* overload */;

Properties

Type Visibility Source Unit Parent
procedure
function
public
System.Permissions.pas
System.Permissions.hpp
System.Permissions TPermissionsService

Description

Requests one or more permissions.

Any permissions that are not currently granted will be requested. Beforehand, a rationale may be displayed to the user if:

  1. if a rationale string is set for the permission in question.
  2. if the OS deems it appropriate (When a permission is requested after being previously denied).
  3. if a rationale is display routine is passed in.

The rationale handler must display the passed in rationale string asynchronously and not block the thread. This overload takes an event handler method.