FMX.AddressBook.TCustomAddressBook.CreateGroup
Delphi
function CreateGroup(const ASource: TAddressBookSource = nil): TAddressBookGroup;
C++
TAddressBookGroup* __fastcall CreateGroup(TAddressBookSource* const ASource = (TAddressBookSource*)(0x0));
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
function | public | FMX.AddressBook.pas FMX.AddressBook.hpp |
FMX.AddressBook | TCustomAddressBook |
説明
デバイスのアドレス帳の指定された情報源にグループを新規作成します。
このメソッドを使用すると、グループを新規作成し、デバイスのアドレス帳(Android または iOS)の指定された 情報源に追加することができます。
メモ: 入力引数
ASource
を付けずにこのメソッドを呼び出した場合、情報源はnil
と見なされます。このシナリオの場合、一部の種類のモバイル デバイスについては、新規作成されたグループがクラウドベースのストレージと必ず同期しているとは限りません。
例
具体的に説明するために、以下の例を考えてみましょう。これらのサンプル コードでは、指定された情報源にグループを新規作成したあとグループ名を設定する方法を示しています。
Delphi の場合:
var
Group: TAddressBookGroup;
Source: TAddressBookSource;
begin
// Create a new group in the specified source
// For example, you can set the Source variable to AddressBook1.DefaultSource to create a group in the default source
Source := AddressBook1.DefaultSource;
Group := AddressBook1.CreateGroup(Source);
if (Group <> nil) then
try
// Set the group name.
Group.Name := 'MyFirstGroup';
AddressBook1.SaveGroup(Group);
finally
Group.Free;
end
else
ShowMessage('Cannot create a group');
end.
C++Builder の場合:
{
// Create new group in the specified source.
// For example, you can set the Source variable to AddressBook1->DefaultSource() to create a group in the default source
TAddressBookSource *Source = AddressBook1->DefaultSource();
TAddressBookGroup *Group = AddressBook1->CreateGroup(Source);
if (Group != NULL) {
__try {
Group->Name = "MyFirstGroup";
AddressBook1->SaveGroup(Group);
}
__finally {
Group->Free();
}
}
else {
ShowMessage("Cannot create a group");
}
}
詳細とサンプルについては、「モバイル チュートリアル:アドレス帳コンポーネントを使用する(iOS および Android)」を参照してください。