FMX.AddressBook.TCustomAddressBook.CreateGroup

• Übergeordnet: TCustomAddressBook

Delphi

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

C++

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

Eigenschaften

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

Beschreibung

Erstellt eine neue Gruppe in der angegebenen Quelle in einem Geräte-Adressbuch.

Mit dieser Methode erstellen Sie eine neue Gruppe und fügen sie in die angegebene Quelle in ein Geräte-Adressbuch (Android oder iOS) ein.

Hinweis: Wenn Sie diese Methode ohne das Eingabeargument ASource aufrufen, wird die Quelle als nil betrachtet. In diesem Szenario kann für bestimmte Typen mobiler Geräte nicht sichergestellt werden, dass die neu erstellte Gruppe synchron mit den Cloud-basierten Speicherungen ist.

Beispiele

Sehen Sie sich zur Klärung das folgende Beispiel an. Diese Codefragmente illustrieren, wie eine neue Gruppe in der angegebenen Quelle erstellt und dann der Gruppenname festgelegt wird.

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

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

Siehe auch

• TAddressBook
• TAddressBookGroup
• TAddressBookContacts
• Mobile-Tutorial: Verwenden einer Adressbuch-Komponente (iOS und Android)