FMX.AddressBook.TCustomAddressBook.CreateContact
Delphi
function CreateContact(const ASource: TAddressBookSource = nil): TAddressBookContact;
C++
TAddressBookContact* __fastcall CreateContact(TAddressBookSource* const ASource = (TAddressBookSource*)(0x0));
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
function | public | FMX.AddressBook.pas FMX.AddressBook.hpp |
FMX.AddressBook | TCustomAddressBook |
説明
デバイスのアドレス帳内の指定された情報源の中に、新しい連絡先を作成します。
このメソッドを使用して、デバイスのアドレス帳(Android または iOS)内の指定した情報源の中に、新しい連絡先を作成して追加することができます。
メモ: 入力引数
ASource
を指定せずにこのメソッドを呼び出すと、情報源はnil
であると見なされます。その場合、モバイル デバイスの種類によっては、新しく作成した連絡先がクラウド上のストレージと同期することを保証できません。
例
明確になるよう以下に例を挙げます。これらのコードでは、新しい連絡先を作成し、その人の姓、名、勤務先電子メール アドレスを指定する方法を示しています。同じアプリケーションで、その新規作成された連絡先を、デバイスのアドレス帳内の指定された情報源に追加しています。
メモ: 連絡先の電子メール アドレスを編集する前に、TContactEmails.Create メソッド(Delphi の場合)または new(C++Builder の場合)を使用して、TContactEmails オブジェクトのインスタンスを明示的に初期化する必要があります。
Delphi の場合:
var
Contact: TAddressBookContact;
EMails: TContactEmails;
Source: TAddressBookSource;
begin
// Create a new contact in the specified source.
Contact := AddressBook1.CreateContact(Source);
try
Contact.FirstName := 'James';
Contact.LastName := 'Stowner';
// Add the work mail
EMails := TContactEmails.Create;
try
eMails.AddEmail(TContactEmail.TLabelKind.Work, 'JStowner@mycompany.com');
Contact.eMails := EMails;
finally
eMails.Free;
end;
AddressBook1.SaveContact(Contact);
finally
Contact.Free;
end;
end.
C++Builder の場合:
{
TAddressBookContact *Contact;
TContactEmails *eMails;
TAddressBookSource *Source;
// Create a new contact in the specified source.
Contact = AddressBook1->CreateContact(Source);
__try {
// Add the contact first name and last name.
Contact->FirstName = "James";
Contact->LastName = "Stowner";
// Add the work mail
eMails = new TContactEmails();
__try {
eMails->AddEmail(TContactEmail::TLabelKind::Work,
"JStowner@mycompany.com");
Contact->EMails = eMails;
}
__finally {
eMails->Free();
}
// Save the newly created contact to Address Book.
AddressBook1->SaveContact(Contact);
}
__finally {
Contact->Free();
}
}
詳細とサンプルについては、「モバイル チュートリアル:アドレス帳コンポーネントを使用する(iOS および Android)」を参照してください。