FMX.AddressBook.TCustomAddressBook.AllGroups

• Aller au parent : TCustomAddressBook

Delphi

procedure AllGroups(var AGroups: TAddressBookGroups); overload;
procedure AllGroups(const ASource: TAddressBookSource; var AGroups: TAddressBookGroups); overload;

C++

void __fastcall AllGroups(TAddressBookGroups* &AGroups)/* overload */;
void __fastcall AllGroups(TAddressBookSource* const ASource, TAddressBookGroups* &AGroups)/* 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 groupes de 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 éventuels groupes de contacts définis dans la source spécifiée dans le carnet d'adresses d'un périphérique.

Exemples

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

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

Delphi :

var 
NumberofGroups: Integer;
Groups : TAddressBookGroups;
ComboBox1: TComboBox;
Begin
// Define a combo box that contains a list of all groups from the specified source in a device Address Book.
procedure TForm1.FillComboboxGroups(Source: TAddressBookSource);
 var i: Integer;
 begin
  Groups := TAddressBookGroups.Create;
  try
    AddressBook1.AllGroups(Groups);
    ComboBox1.BeginUpdate;
    ComboBox1.Clear;
    for i := 0 to Groups.Count -1 do   
      ComboBox1.Items.Add(Groups.Items[i].Name);
  finally
    ComboBox1.EndUpdate;
    Groups.Free;
 end;
end.

C++Builder :

{
TAddressBookGroups *Groups;
TComboBox *ComboBox1;
// Define a combo box that contains a list of all groups from the specified source in a device Address Book.
void __fastcall TForm1::FillComboboxGroups(TAddressBookSource *Source)  {
int i;
Groups = new TAddressBookGroups();
__try{
ComboBox1->BeginUpdate();
ComboBox1->Clear();
AddressBook1->AllGroups(Source, Groups);
for (i = 0; i < Groups->Count; i++) {
   ComboBox1->Items->Add(Groups->Items[i]->Name);
}
}
__finally{
Groups->Free();
ComboBox1->EndUpdate();
}
}

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)