FMX.AddressBook.TCustomAddressBook.AllGroups

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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

Eigenschaften

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


Beschreibung

Gibt eine Liste aller Kontaktgruppen aus der angegebenen Quelle in einem Geräte-Adressbuch zurück.

Mit dieser Methode rufen Sie eine Liste aller Kontaktgruppen ab, die in der angegebenen Quelle in einem Geräte-Adressbuch definiert sind, sofern vorhanden.

Beispiele

Sehen Sie sich zur Klärung die folgenden Beispiele an. Diese Codefragmente illustrieren, wie alle Gruppen aus der angegebenen Quelle in einem Geräte-Adressbuch abgerufen werden.

Hinweis: Bevor Sie die Methode AllGroups aufrufen, müssen Sie eine Instanz des AGroups-Objekts mit der Methode TAdressBookGroups.Create (für Delphi) oder new (für C++Builder) explizit initialisieren.

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

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

Siehe auch