FMX.AddressBook.TCustomAddressBook.AllContacts

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure AllContacts(var AContacts: TAddressBookContacts); overload;
procedure AllContacts(const ASource: TAddressBookSource; var AContacts: TAddressBookContacts); overload;

C++

void __fastcall AllContacts(TAddressBookContacts* &AContacts)/* overload */;
void __fastcall AllContacts(TAddressBookSource* const ASource, TAddressBookContacts* &AContacts)/* overload */;

Eigenschaften

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


Beschreibung

Ruft eine Liste aller Kontakte aus der angegebenen Quelle in einem Geräte-Adressbuch ab.

Mit dieser Methode rufen Sie eine Liste aller Kontakte aus der angegebenen Quelle im Geräte-Adressbuch ab.

Hinweis: Diese Methode ist überladen. Wenn Sie diese Methode ohne den Parameter ASource (die erste überladene Methode) aufrufen, ruft AllContacts alle Kontakte aus der Standardquelle ab.

Beispiele

Sehen Sie sich zur Klärung die folgenden Beispiele an. Diese Codefragmente illustrieren, wie alle Kontakte aus der Standardquelle in einem Geräte-Adressbuch abgerufen werden.

Hinweis: Bevor Sie die Methode AllContacts aufrufen, müssen Sie eine Instanz des AContacts-Objekts mit der Methode TAdressBookContacts.Create (für Delphi) oder new (für C++Builder) explizit initialisieren.

Delphi:
var
  Contacts: TAddressBookContacts;
begin
  Contacts := TAddressBookContacts.Create;
  try
    // Get all contacts from the default source
    AddressBook1.AllContacts(AddressBook1.DefaultSource, Contacts);
    // do something with contacts
  finally
    Contacts.Free;
  end;
end;
C++Builder:
{
TAddressBookContacts *Contacts;
	Contacts = new TAddressBookContacts();
	__try {
                // Get all contacts from the default source
		AddressBook1->AllContacts(AddressBook1->DefaultSource(), Contacts);
		// do something with contacts
	}
	__finally {
		Contacts->Free();
	}
}


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

Siehe auch