FMX.AddressBook.Types.TContactPhones.AddPhone

提供: RAD Studio API Documentation
移動先: 案内検索

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

プロパティ

種類 可視性 ソース ユニット
function public
FMX.AddressBook.Types.pas
FMX.AddressBook.Types.hpp
FMX.AddressBook.Types TContactPhones


説明

連絡先の電話番号のリストに、新しい電話番号を追加します。

このメソッドを使用すると、新しい電話番号を、連絡先関連の電話番号のリストに追加することができます。 このメソッドの入力パラメータで、次の特性を指定することができます:

  • ANumber: 連絡先の電話番号を指定します(+1-185-100-1650 など)。
  • AKind: 第 1 オーバーロード メソッドで、このパラメータは連絡先の電話番号の種類を示します。
  • Alabel: 第 2 オーバーロード メソッドで、このパラメータはテキスト ラベル("Home"、"FaxWork"、など)を示します。

明確にするために、次の例を考えてみましょう。 これらのコード スニペットでは、どのように連絡先の個人の携帯電話の番号を指定し、その連絡先を連絡帳に保存するかを説明しています。

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

詳細やサンプルについては、「モバイル チュートリアル:Web ブラウザ コンポーネントを使用する(iOS および Android)」を参照してください。

関連項目