FMX.AddressBook.Types.TContactAddresses.AddAddress
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 */;
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | FMX.AddressBook.Types.pas FMX.AddressBook.Types.hpp |
FMX.AddressBook.Types | TContactAddresses |
Description
Ajoute une nouvelle adresse à la liste des adresses du contact.
Utilisez cette méthode pour ajouter une nouvelle adresse à la liste des adresses du contact. Les paramètres d'entrée de cette méthode vous permettent de spécifier les caractéristiques suivantes, associées aux adresses :
Alabel
: dans la première méthode surchargée, ce paramètre spécifie un libellé de texte facultatif, tel que "Maison," " Bureau," etc.AKind
: dans la deuxième méthode surchargée, ce paramètre spécifie le type de contact.ACountry
: spécifie le nom du pays.AState
: spécifie l'Etat du contact, s'il en existe, comme Californie.ACity
: spécifie le nom de la ville.AZip
: spécifie le code postal.AStreet
: spécifie la rue, le numéro de bâtiment, le numéro de bureau et autres informations similaires.
Exemples
A titre explicatif, considérons les exemples suivants. Ces extraits de code illustrent comment spécifier le domicile du contact et sauvegarder ce contact dans le Carnet d'adresses.
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();
}
Pour davantage d'informations et d'autres exemples, voir Tutoriel mobile : Utilisation d'un composant Carnet d'adresses (iOS et Android).