net.rim.blackberry.api.pdap.contactlinking
Interface LinkedContactCallback


public interface LinkedContactCallback

An interface allowing access to linked contact information to be set.

Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 6.0.0

Method Summary
Category: Signed  void setAvailability(int availability)
          Set the current availability for this linked contact.
Category: Signed  void setContactList(LinkableContact[] contacts, boolean append, int totalLinkableContactCount)
          Set a list of LinkableContact objects that can be used to create or modify a link to a BlackBerryContact.
Category: Signed  void setStatusString(String statusString)
          Set the status description for this linked contact.
Category: Signed  void setUserName(String userName)
          Set the user name for this linked contact.
 



Method Detail

setUserName

void setUserName(String userName)
Set the user name for this linked contact.

Parameters:
userName - the linked contact's user name
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 6.0.0

setStatusString

void setStatusString(String statusString)
Set the status description for this linked contact.

Parameters:
statusString - the status description
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 6.0.0

setAvailability

void setAvailability(int availability)
Set the current availability for this linked contact.

Parameters:
availability - current availability for this contact
Throws:
IllegalArgumentException - if availability is not equal to one of the AVAILABILITY_ constants defined in LinkedContactInfoProvider
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 6.0.0

setContactList

void setContactList(LinkableContact[] contacts,
                    boolean append,
                    int totalLinkableContactCount)
Set a list of LinkableContact objects that can be used to create or modify a link to a BlackBerryContact. To progressively load contacts, this method should be called subsequent times with append set to true. If the total number of contacts to be set is known, this value should be specified by totalLinkableContactCount, so the current progress can be monitored.

Parameters:
contacts - An array of contacts that can be linked. If null, will be ignored, but totalLinkableContactCount can still be specified to indicate the number of expected contacts.
append - true to append new LinkableContact objects to the current list, false to replace the current list.
totalLinkableContactCount - the total number of expected contacts that will be set. If less than 0, the number of contacts is determined by the length of the current contacts array plus the number of contacts previously added if append is set to true.
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
Since:
BlackBerry API 6.0.0





Copyright 1999-2011 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Java is a trademark of Oracle America Inc. in the US and other countries.
Legal