FMX.AddressBook.Types.TContactDates.AddDate

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

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

プロパティ

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


説明

連絡先関連の日付のリストに、新しい日付を追加します。

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

  • ADateTDate 型の値を示し、これは、連絡先関連の日付(個人の誕生日など)を表します。
  • AKind: 第 1 オーバーロード メソッドで、このパラメータは連絡先の日付の種類を示します。
  • Alabel: 第 2 オーバーロード メソッドで、このパラメータはテキスト ラベル("Birthday"、"Anniversary"、など)を示します。

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

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

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

関連項目