FMX.AddressBook.TCustomAddressBook.RequestPermission

• Übergeordnet: TCustomAddressBook

Delphi

procedure RequestPermission;

C++

void __fastcall RequestPermission(void);

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
procedure function	public	FMX.AddressBook.pas FMX.AddressBook.hpp	FMX.AddressBook	TCustomAddressBook

Beschreibung

Sendet eine Anforderung zum Zugreifen auf ein Geräte-Adressbuch.

Mit dieser Methode senden Sie eine Anforderung zum Zugreifen auf ein Geräte-Adressbuch. Verwenden Sie die Ereignisbehandlungsroutine OnPermissionRequest, um die Systemantwort zu verarbeiten.

Wichtig: Sie müssen die Methode RequestPermission vor dem Zugriff auf Funktionen eines Geräte-Adressbuchs aufrufen. Andernfalls kann Ihre Anwendung nicht mit einem Geräte-Adressbuch arbeiten und schlägt möglicherweise fehl. Beispielsweise können Sie die Methode RequestPermission in der Ereignisbehandlungsroutine TForm.OnShow aufrufen.

Hinweis: Auf iOS-Geräten ist RequestPermission eine asynchrone Methode.

Beispiele

Sehen Sie sich zur Klärung die folgenden Beispiele an. Diese Codefragmente illustrieren, wie die Ereignisbehandlungsroutinen OnShow und OnPermissionRequest implementiert werden müssen, um eine Berechtigung zum Zugreifen auf ein Geräte-Adressbuch anzufordern.

Delphi:

procedure TForm1.FormShow(Sender: TObject);
begin
  AddressBook1.RequestPermission;
end;

procedure TForm1.AddressBook1PermissionRequest(ASender: TObject;
  const AMessage: string; const AAccessGranted: Boolean);
begin
  if AAccessGranted then
  begin
   // Do something with Address Book
  end
  else
    ShowMessage('You cannot access Address Book. Reason: ' + sLineBreak + AMessage);
end;

C++Builder:

void __fastcall TForm1::FormShow(TObject *Sender) {
	AddressBook1->RequestPermission();	
}


void __fastcall TForm1::AddressBook1PermissionRequest(TObject *ASender,
	const UnicodeString AMessage, const bool AAccessGranted) {
	if (AAccessGranted) {

        // Do something with Address Book 		

	}
	else {
		ShowMessage("You cannot access Address Book. Reason: " + sLineBreak + AMessage);
	}
}

Weitere Informationen und Beispiele finden Sie unter Mobile-Tutorial: Verwenden einer Adressbuch-Komponente (iOS und Android).

Siehe auch

• TAddressBook
• TAddressBookGroup
• TAddressBookContacts
• Mobile-Tutorial: Verwenden einer Adressbuch-Komponente (iOS und Android)