FMX.AddressBook.Types.TContactAddresses.AddAddress

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

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

プロパティ

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


説明

連絡先の住所のリストに、新しい住所を追加します。

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

  • Alabel: 第 1 オーバーロード メソッドで、このパラメータはテキスト ラベル("Home"、"Office"、など)を示します。
  • AKind: 第 2 オーバーロード メソッドで、このパラメータは連絡先の種類を示します。
  • ACountry: 国名を指定します。
  • AState: 連絡先の州名を指定します(California など。もしあれば)。
  • ACity: 市名を指定します。
  • AZip: 郵便番号を指定します
  • AStreet: 番地、建物番号、オフィス番号、その他同様の情報を指定します。

明確にするために、次の例を考えてみましょう。 これらのコード スニペットでは、どのように連絡先の家の住所を指定し、その連絡先をアドレス帳に保存するかを説明しています。

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

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

関連項目