FMX.AddressBook.TCustomAddressBook.AllContacts

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

Delphi

procedure AllContacts(var AContacts: TAddressBookContacts); overload;
procedure AllContacts(const ASource: TAddressBookSource; var AContacts: TAddressBookContacts); overload;

C++

void __fastcall AllContacts(TAddressBookContacts* &AContacts)/* overload */;
void __fastcall AllContacts(TAddressBookSource* const ASource, TAddressBookContacts* &AContacts)/* overload */;

プロパティ

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


説明

デバイスのアドレス帳内の指定された情報源から、すべての連絡先のリストを取得します。

このメソッドを使用して、デバイスのアドレス帳内の指定された情報源から、すべての連絡先のリストを取得することができます。

メモ: このメソッドはオーバーロードされています。ASource パラメータを指定せずにこのメソッドを呼び出すと(1 番目のオーバーロード メソッド)、AllContactsデフォルトの情報源からすべての連絡先を取得します。

明確になるよう以下に例を挙げます。これらのコードでは、デバイスのアドレス帳内のデフォルトの情報源から、すべての連絡先を取得する方法を示しています。

メモ: AllContacts メソッドを呼び出す前に、TAdressBookContacts.Create メソッド(Delphi の場合)または new(C++Builder の場合)を使用して、AContacts オブジェクトのインスタンスを明示的に初期化する必要があります。

Delphi の場合:
var
  Contacts: TAddressBookContacts;
begin
  Contacts := TAddressBookContacts.Create;
  try
    // Get all contacts from the default source
    AddressBook1.AllContacts(AddressBook1.DefaultSource, Contacts);
    // do something with contacts
  finally
    Contacts.Free;
  end;
end;
C++Builder の場合:
{
TAddressBookContacts *Contacts;
	Contacts = new TAddressBookContacts();
	__try {
                // Get all contacts from the default source
		AddressBook1->AllContacts(AddressBook1->DefaultSource(), Contacts);
		// do something with contacts
	}
	__finally {
		Contacts->Free();
	}
}


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

関連項目