FMX.AddressBook.Types.TContactDates.AddDate
Delphi
function AddDate(const AKind: TContactDate.TLabelKind; const ADate: TDate): TContactDate; overload;
function AddDate(const ALabel: string; const ADate: TDate): TContactDate; overload;
C++
TContactDate* __fastcall AddDate(const TContactDate::TLabelKind AKind, const System::TDate ADate)/* overload */;
TContactDate* __fastcall AddDate(const System::UnicodeString ALabel, const System::TDate ADate)/* overload */;
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | FMX.AddressBook.Types.pas FMX.AddressBook.Types.hpp |
FMX.AddressBook.Types | TContactDates |
Description
Ajoute une nouvelle date à une liste de dates associées à la personne de contact.
Utilisez cette méthode pour ajouter une nouvelle date à une liste de dates associées à la personne de contact. Les paramètres d'entrée de cette méthode vous permettent de spécifier les caractéristiques suivantes :
ADate
: spécifie une valeur du type TDate qui représente la date associée à la personne de contact, telle que l'anniversaire de la personne de contact.AKind
: dans la première méthode surchargée, ce paramètre spécifie le type de date de contact.Alabel
: dans la seconde méthode, ce paramètre spécifie un libellé optionnel, tel que "Birthday," "Anniversary," et ainsi de suite.
Exemples
A titre explicatif, prenons les exemples suivants. Ces extraits de code illustrent comment spécifier la date d'anniversaire de la personne de contact et enregistrer ce contact dans le carnet d'adresses.
Delphi :
var
Contact: TAddressBookContact;
Locale: TFormatSettings;
Dates : TContactDates;
begin
Contact := AddressBook1.CreateContact(AddressBook1.DefaultSource);
try
// Specify the locale to use
Locale := TFormatSettings.Create('en-US');
Dates := TContactDates.Create;
try
// Add the birthday of the contact person
Dates.AddDate(TContactDate.TLabelKind.Birthday,StrToDate('12/17/1990',Locale));
Contact.Dates := Dates;
finally
Dates.Free;
end;
// Save the newly created contact
AddressBook1.SaveContact(Contact);
finally
Contact.Free;
end;
end;
C++Builder :
TAddressBookContact *Contact;
TContactDates *dates;
// Create a new contact
Contact = AddressBook1->CreateContact(AddressBook1->DefaultSource());
__try {
// Specify the locale to use
TFormatSettings locale = TFormatSettings::Create("en-US");
dates = new TContactDates();
__try {
// Add the birthday date of the contact person
dates->AddDate(TContactDate::TLabelKind::Birthday,
StrToDate("12/17/1990", locale));
Contact->Dates = dates;
}
__finally {
dates->Free();
}
// Save contact to Address Book
AddressBook1->SaveContact(Contact);
}
__finally {
Contact->Free();
}
Pour plus d'informations et des exemples, voir Tutoriel mobile : Utilisation du composant Carnet d'adresses (iOS et Android).