FMX.AddressBook.TCustomAddressBook.CreateGroup

• Aller au parent : TCustomAddressBook

Delphi

function CreateGroup(const ASource: TAddressBookSource = nil): TAddressBookGroup;

C++

TAddressBookGroup* __fastcall CreateGroup(TAddressBookSource* const ASource = (TAddressBookSource*)(0x0));

Propriétés

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

Description

Crée un nouveau groupe dans la source spécifiée dans le carnet d'adresses d'un périphérique.

Utilisez cette méthode pour créer et ajouter un nouveau groupe à la source spécifiée dans le carnet d'adresses d'un périphérique (Android ou iOS).

Remarque Si vous appelez cette méthode sans l'argument d'entrée ASource, la source est considérée comme ayant la valeur nil. Dans ce scénario, pour certains types de périphériques mobiles, nous ne pouvons pas garantir que le nouveau groupe créé sera synchronisé avec les stockages dans le cloud.

Exemples

A titre explicatif, prenons l'exemple suivant. Ces extraits de code illustrent comment créer un nouveau groupe dans la source spécifiée, puis comment définir le nom du groupe.

Delphi :

var
  Group: TAddressBookGroup;
  Source: TAddressBookSource;
begin
  // Create a new group in the specified source
  // For example, you can set the Source variable to AddressBook1.DefaultSource to create a group in the default source
  Source := AddressBook1.DefaultSource;
  Group := AddressBook1.CreateGroup(Source);
  if (Group <> nil) then
    try
      // Set the group name.
      Group.Name := 'MyFirstGroup';
      AddressBook1.SaveGroup(Group);      
    finally
      Group.Free;
    end
  else
    ShowMessage('Cannot create a group');
end.

C++Builder :

{
	// Create new group in the specified source.
       // For example, you can set the Source variable to AddressBook1->DefaultSource() to create a group in the default source
        TAddressBookSource *Source = AddressBook1->DefaultSource();
	TAddressBookGroup *Group = AddressBook1->CreateGroup(Source);
	if (Group != NULL) {
		__try {
			Group->Name = "MyFirstGroup";
			AddressBook1->SaveGroup(Group);			
		}
		__finally {
			Group->Free();
		}
	}
	else {
		ShowMessage("Cannot create a group");
	}	
}

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)