FMX.AddressBook.Types.TContactAddresses.AddAddress

• Übergeordnet: TContactAddresses

Delphi

function AddAddress(const ALabel, ACountry, AState, ACity, AZIP, AStreet: string): TContactAddress; overload;
function AddAddress(const AKind: TContactAddress.TLabelKind; const ACountry, AState, ACity, AZIP, AStreet: string): TContactAddress; overload;

C++

TContactAddress* __fastcall AddAddress(const System::UnicodeString ALabel, const System::UnicodeString ACountry, const System::UnicodeString AState, const System::UnicodeString ACity, const System::UnicodeString AZIP, const System::UnicodeString AStreet)/* overload */;
TContactAddress* __fastcall AddAddress(const TContactAddress::TLabelKind AKind, const System::UnicodeString ACountry, const System::UnicodeString AState, const System::UnicodeString ACity, const System::UnicodeString AZIP, const System::UnicodeString AStreet)/* overload */;

Eigenschaften

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

Beschreibung

Fügt der Liste der Kontaktadressen eine neue Adresse hinzu.

Mit dieser Methode fügen Sie der Liste der Kontaktadressen eine neue Adresse hinzu. Mit den Eingabeparametern können Sie die folgenden Adressen-bezogenen Charakteristika angeben:

• Alabel: mit diesem Parameter geben Sie in der ersten überladenen Methode eine optionale Beschriftung, wie "Home," " Büro," usw. an.
• AKind: mit diesem Parameter geben Sie in der zweiten überladenen Methode die Kontakt-Art an.
• ACountry: gibt den Ländernamen an.
• AState: gibt den Kontakt-Staat an, sofern vorhanden, wie z. B. Kalifornien.
• ACity: gibt den Städtenamen an.
• AZip: gibt die Postleitzahl an.
• AStreet: gibt die Straße, Hausnummer, Büronummer oder ähnliche Informationen an.

Beispiele

Sehen Sie sich zur Klärung die folgenden Beispiele an. Diese Codefragmente zeigen, wie die Kontakt-Heim-Adresse angegeben wird, und speichert diesen Kontakt im Adressbuch.

Delphi:

var
  Contact: TAddressBookContact;
  Addresses : TContactAddresses;
begin
  // Create an empty new contact in the default source
  Contact := AddressBook1.CreateContact(AddressBook1.DefaultSource);
  try
    // Create an empty list of addresses
    Addresses := TContactAddresses.Create;
    try
      // Add a home address to the list
      Addresses.AddAddress(TContactAddress.TLabelKind.Home,'France',
			'', 'Sceaux', '92330', '102-bis, rue Houdan');
      // Add the address list to the contact
      Contact.Addresses := Addresses;
    finally
       Addresses.Free;
    end;
    // Save the contact to Address Book
    AddressBook1.SaveContact(Contact);
  finally
    Contact.Free;
  end;
end;

C++Builder:

TAddressBookContact *contact;
TContactAddresses *addresses;
// Create a new contact in the default source
contact = AddressBook1->CreateContact(AddressBook1->DefaultSource());
__try{
// Create an empty list of addresses
addresses = new TContactAddresses();
	__try {
                // Add a home address to the list of addresses
		addresses->AddAddress(TContactAddress::TLabelKind::Home, "France",
			"", "Sceaux", "92330", "102-bis, rue Houdan");
		contact->Addresses = addresses;
	}
	__finally {
		addresses->Free();
	}
	AddressBook1->SaveContact(contact);
}
__finally {
     contact->Free();
}

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

Siehe auch

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