Tpf.Persona – folks-telepathy Reference Manual

# Persona

## Object Hierarchy:

## Description:

public class Persona : Persona, AliasDetails, AvatarDetails, BirthdayDetails, EmailDetails, FavouriteDetails, GroupDetails, InteractionDetails, ImDetails, NameDetails, PhoneDetails, PresenceDetails, UrlDetails

A persona subclass which represents a single instant messaging contact from Telepathy.

There is a one-to-one correspondence between Tpf.Personas and TelepathyGLib.Contact s, although at any time the Tpf.Persona.contact property of a persona may be `null` if the contact's Telepathy connection isn't available (e.g. due to being offline). In this case, the persona's properties persist from a local cache.

Namespace: Tpf
Package: folks-telepathy

## Content:

### Properties:

- public string alias { get; set; }
  An alias for the Persona.
- public LoadableIcon? avatar { get; set; }
  An avatar for the Persona.
- public DateTime? birthday { get; set; }
- public string? calendar_event_id { get; set; }
- public uint call_interaction_count { get; }
  A counter for call interactions (only successful calls) with the persona.
- public string[] client_types { get; set; }
  The Persona's client types.
- public Contact? contact { get; construct; }
  The Telepathy contact represented by this persona.
- public Set<EmailFieldDetails> email_addresses { get; set; }
- public string full_name { get; set; }
- public Set<string> groups { get; set; }
  A set group IDs for the groups the contact is a member of.
- public MultiMap<string,ImFieldDetails> im_addresses { get; set; }
  A mapping of IM protocol to an (unordered) set of IM addresses.
- public uint im_interaction_count { get; }
  A counter for IM interactions (send/receive message) with the persona.
- public bool is_favourite { get; set; }
  Whether this Persona is a user-defined favourite.
- public bool is_in_contact_list { get; set; }
  Whether the Persona is in the user's contact list.
- public DateTime? last_call_interaction_datetime { get; }
  The latest datetime for call interactions (only successful calls) with the persona.
- public DateTime? last_im_interaction_datetime { get; }
  The latest datetime for IM interactions (send/receive message) with the persona.
- public override string[] linkable_properties { get; }
  The names of the Persona's linkable properties.
- public string nickname { get; set; }
- public Set<PhoneFieldDetails> phone_numbers { get; set; }
- public string presence_message { get; set; }
  The Persona's presence message.
- public string presence_status { get; set; }
  The Persona's presence status.
- public PresenceType presence_type { get; set; }
  The Persona's presence type.
- public StructuredName? structured_name { get; set; }
- public Set<UrlFieldDetails> urls { get; set; }
- public override string[] writeable_properties { get; }

### Static methods:

- public static Persona? dup_for_contact (Contact contact)
  Look up a Tpf.Persona by its TelepathyGLib.Contact.

### Creation methods:

- public Persona (Contact contact, PersonaStore store)
  Create a new persona.

### Methods:

- public async void change_alias (string alias) throws PropertyError
- public async void change_birthday (DateTime? birthday) throws PropertyError
- public async void change_email_addresses (Set<EmailFieldDetails> email_addresses) throws PropertyError
- public async void change_full_name (string full_name) throws PropertyError
- public async void change_group (string group, bool is_member) throws Error
  Add or remove the Persona from the specified group.
- public async void change_groups (Set<string> groups) throws PropertyError
- public async void change_is_favourite (bool is_favourite) throws PropertyError
- public async void change_phone_numbers (Set<PhoneFieldDetails> phone_numbers) throws PropertyError
- public async void change_urls (Set<UrlFieldDetails> urls) throws PropertyError
- public override void constructed ()

### Inherited Members:

All known members inherited from class Folks.Persona

- LinkablePropertyCallback
- build_uid
- display_id
- iid

- individual
- is_user
- linkable_properties
- linkable_property_to_links

- split_uid
- store
- uid
- writeable_properties

All known members inherited from class GLib.Object

- @get
- @new
- @ref
- @set
- add_toggle_ref
- add_weak_pointer
- bind_property
- connect
- constructed
- disconnect
- dispose
- dup_data
- dup_qdata
- force_floating
- freeze_notify
- get_class
- get_data

- get_property
- get_qdata
- get_type
- getv
- interface_find_property
- interface_install_property
- interface_list_properties
- is_floating
- new_valist
- new_with_properties
- newv
- notify
- notify_property
- ref_count
- ref_sink
- remove_toggle_ref
- remove_weak_pointer

- replace_data
- replace_qdata
- set_data
- set_data_full
- set_property
- set_qdata
- set_qdata_full
- set_valist
- setv
- steal_data
- steal_qdata
- thaw_notify
- unref
- watch_closure
- weak_ref
- weak_unref

All known members inherited from interface Folks.AliasDetails

- alias

- change_alias

All known members inherited from interface Folks.AvatarDetails

- avatar

- change_avatar

All known members inherited from interface Folks.BirthdayDetails

- birthday
- calendar_event_id

- change_birthday

- change_calendar_event_id

All known members inherited from interface Folks.EmailDetails

- change_email_addresses

- email_addresses

All known members inherited from interface Folks.FavouriteDetails

- change_is_favourite

- is_favourite

All known members inherited from interface Folks.GroupDetails

- change_group
- change_groups

- group_changed

- groups

All known members inherited from interface Folks.InteractionDetails

- call_interaction_count
- im_interaction_count

- last_call_interaction_datetime

- last_im_interaction_datetime

All known members inherited from interface Folks.ImDetails

- change_im_addresses

- im_addresses

- normalise_im_address

All known members inherited from interface Folks.NameDetails

- change_full_name
- change_nickname

- change_structured_name
- full_name

- nickname
- structured_name

All known members inherited from interface Folks.PhoneDetails

- change_phone_numbers

- phone_numbers

All known members inherited from interface Folks.PresenceDetails

- client_types
- get_default_message_from_type
- is_online

- presence_message
- presence_status

- presence_type
- typecmp

All known members inherited from interface Folks.UrlDetails

- change_urls

- urls