連絡先の検索

find 関数を使用して、特定の条件により連絡先リストを検索できます。

メソッドの概要

用途

メソッドの概要

フィルターオプションに基づいて連絡先を検索します。

 

find(String filter, Array fields)

  • 戻り値 – Contact オブジェクトの配列。fields を指定した場合、戻り値の Contact オブジェクトには、指定したフィールドの値のみが含まれます。
  • パラメーター
    • filter – 検索用フィルターを指定するための文字列。
    • fields - 戻り値の Contact オブジェクトに含まれるフィールドの配列。検索は指定したフィールドに対してのみ実行されます。有効な値として、name、displayName、phoneNumbers、* などがあります。

name および displayName と一致する連絡先「Rob」を検索するには:

<cfset cntlst=cfclient.contacts.find("Rob",["name","displayName"])>
<cfscript>
for (i = 1; i <= #arrayLen(cntlst)#; i = i + 1) {
/*Populating the content of the <div> with the ID divId*/
document.getElementById('divId').innerHTML=cntlst[i]. displayName;

}
</cfscript>

すべての連絡先情報の取得

すべての連絡先の一覧をすばやく取得するには、次の例に示すように getAllContacts 関数を使用します。

メソッドの概要

連絡先の一致検索フィルターの削除

メソッドの概要

保存されているすべての連絡先を取得します。

getAllContacts

  • 戻り値 – Contact オブジェクトの配列。fields を指定した場合、戻り値の Contact オブジェクトには、指定したフィールドの値のみが含まれます。
  • パラメーター
    • fields – 戻り値の Contact オブジェクトに含まれるフィールドの配列。有効な値として、name、displayName、phoneNumbers、*(すべてのフィールドを示す表記)などがあります。

すべての連絡先を一覧表示するには:

<cfset cntlst=cfclient.contacts.getAllContacts(["name"])>
<cfscript>
for (i = 1; i <= #ArrayLen(cntlst)#; i = i + 1) {
/*Populating the content of the <div> with the ID divId*/
document.getElementById('divId').innerHTML=
cntlst[i].name.givenName;

}
</cfscript>

Contact オブジェクト

Contact オブジェクトに使用できるプロパティの一覧を次に示します。

  • id
  • displayName
  • name(ContactName
  • nickName
  • phoneNumbers(ContactField [])
  • emails(ContactField [])
  • ims(ContactField [])
  • organizations
  • birthday
  • note
  • photos(ContactField [])
  • categories(ContactField [])
  • urls(ContactField [])


次の API は Android デバイスでのみサポートされます。一部の API は iOS デバイスで機能しない可能性があります。

Contact オブジェクトに使用できる関数の一覧を次に示します。

  • getMobileNumber()
  • getHomeNumber()
  • getWorkNumber()
  • getPreferredNumber
  • addPhoneNumber(value,type,pref)
  • addEmail(value,type,pref)
  • addAddress(ContactAddress )
  • addOrganization(ContactOrganization )
  • addIm(value,type,pref)
  • addPhoto(value,type,pref)
  • addCategory(value,type,pref)
  • addURL(value,type,pref)

 

Contact オブジェクトには、これらの他にもサポートされるメソッドがいくつかあります。サポートされるメソッドについて詳しくは、このドキュメントを参照してください。

本作品は Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License によってライセンス許可を受けています。  Twitter™ および Facebook の投稿には、Creative Commons の規約内容は適用されません。

法律上の注意   |   プライバシーポリシー