FMX.AddressBook.Types.TContactPhones.AddPhone

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function AddPhone(const AKind: TContactPhone.TLabelKind; const ANumber: string): TContactPhone; overload;
function AddPhone(const ALabel: string; const ANumber: string): TContactPhone; overload;

C++

TContactPhone* __fastcall AddPhone(const TContactPhone::TLabelKind AKind, const System::UnicodeString ANumber)/* overload */;
TContactPhone* __fastcall AddPhone(const System::UnicodeString ALabel, const System::UnicodeString ANumber)/* overload */;

Propriétés

Type Visibilité  Source Unité  Parent
function public
FMX.AddressBook.Types.pas
FMX.AddressBook.Types.hpp
FMX.AddressBook.Types TContactPhones


Description

Ajoute un nouveau numéros de téléphone à une liste de numéros de téléphone de contact.

Utilisez cette méthode pour ajouter un nouveau numéro de téléphone à une liste de numéros de téléphone de contact. Les paramètres d'entrée de cette méthode vous permettent de spécifier les caractéristiques suivantes :

  • ANumber : spécifie le numéro de téléphone de contact, tel que +1-185-100-1650'.
  • AKind : dans la première méthode surchargée, ce paramètre spécifie le type de numéro de téléphone de contact.
  • Alabel : dans la deuxième méthode surchargée, ce paramètre spécifie un libellé optionnel, tel que "Home," "FaxWork,", et ainsi de suite.

Exemples

A titre explicatif, prenons les exemples suivants. Ces extraits de code illustrent comment spécifier le numéro de téléphone mobile de contact et enregistrer ce contact dans le carnet d'adresses.

Delphi :
var
  Contact: TAddressBookContact;
  Phones: TContactPhones;
 begin
  Contact := AddressBook1.CreateContact(AddressBook1.DefaultSource);
  try
   // Add a mobile phone number
    Phones := TContactPhones.Create;
    try
      Phones.AddPhone(TContactPhone.TLabelKind.Mobile, '+33-6-46-51-3531');
      Contact.Phones := Phones;
    finally
      Phones.Free;
    end;
  // Save the newly created contact
  AddressBook1.SaveContact(Contact);  
  finally
    Contact.Free;
  end;
end;
C++Builder :
        TAddressBookContact *Contact;
	TContactAddresses *addresses;
        // Create a new contact
	Contact = AddressBook1->CreateContact(AddressBook1->DefaultSource());
	__try {
		// Add the mobile phone number to the newly created contact
		phones = new TContactPhones();
		__try {
			phones->AddPhone(TContactPhone::TLabelKind::Mobile,
				"+33-6-46-51-3531");
			Contact->Phones = phones;
		}
		__finally {
			phones->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).

Voir aussi