FMX.AddressBook.TCustomAddressBook.AllContacts

• Aller au parent : TCustomAddressBook

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 */;

Propriétés

Type	Visibilité	Source	Unité	Parent
procedure function	public	FMX.AddressBook.pas FMX.AddressBook.hpp	FMX.AddressBook	TCustomAddressBook

Description

Renvoie la liste de tous les contacts appartenant à la source spécifiée dans le carnet d'adresses d'un périphérique.

Utilisez cette méthode pour obtenir la liste de tous les contacts appartenant à la source spécifiée dans le carnet d'adresses du périphérique.

Remarque : Cette méthode est surchargée. Si vous appelez cette méthode sans le paramètre ASource (première méthode surchargée), AllContacts obtient tous les contacts appartenant à la source par défaut.

Exemples

A titre explicatif, prenons les exemples suivants : ces extraits de code illustrent comment extraire tous les contacts appartenant à la source par défaut dans le carnet d'adresses d'un périphérique.

Remarque : Avant d'appeler la méthode AllContacts, vous devez initialiser explicitement une instance de l'objet AContacts en utilisant la méthode TAdressBookContacts.Create (pour Delphi) ou new (pour C++Builder).

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();
	}
}

Pour plus d'informations et d'exemples, voir Tutoriel mobile : Utilisation d'un composant Carnet d'adresses (iOS et Android).

Voir aussi

• TAddressBook
• TAddressBookGroup
• TAddressBookContacts
• Tutoriel mobile : Utilisation d'un composant Carnet d'adresses (iOS et Android)