FMX.AddressBook.Types.TContactPhones.AddPhone

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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

Eigenschaften

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


Beschreibung

Fügt einer Liste der Kontakt-Telefonnummern eine neue Telefonnummer hinzu.

Mit dieser Methode fügen Sie der Liste der Kontakt-Telefonnummern eine neue Telefonnummer hinzu. Mit den Eingabeparametern können Sie die folgenden Charakteristika angeben:

  • ANumber: gibt die Kontakt-Telefonnummer an, wie +1-185-100-1650'.
  • AKind: in der ersten überladenen Methode gibt dieser Parameter die Art der Kontakt-Telefonnummer an.
  • Alabel: in der zweiten überladenen Methode gibt dieser Parameter eine optionale Beschriftung an, wie z. B. "Heim," "FaxWork," usw.

Beispiele

Sehen Sie sich zur Klärung die folgenden Beispiele an. Die Codefragmente zeigen, wie die Mobiltelefonnummer des Kontakts angegeben wird, und speichert diesen Kontakt im Adressbuch.

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

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

Siehe auch