FMX.AddressBook.TCustomAddressBook.CreateGroup
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 valeurnil
. 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.
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.
{
// 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).