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

display_id
iid
individual
is_user

linkable_properties
store
uid
writeable_properties

LinkablePropertyCallback
build_uid
split_uid
linkable_property_to_links

All known members inherited from class GLib.Object

@new
newv
new_valist
get_type
get_class
@ref
unref
ref_sink
weak_ref
weak_unref
add_weak_pointer
remove_weak_pointer

@get
@set
get_property
set_property
get_data
set_data
set_data_full
steal_data
get_qdata
set_qdata
set_qdata_full
steal_qdata

freeze_notify
thaw_notify
dispose
constructed
notify_property
connect
disconnect
add_toggle_ref
remove_toggle_ref
bind_property
notify
ref_count

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

email_addresses

change_email_addresses

All known members inherited from interface Folks.FavouriteDetails

is_favourite

change_is_favourite

All known members inherited from interface Folks.GroupDetails

groups
change_group

change_groups

group_changed

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

im_addresses

normalise_im_address

change_im_addresses

All known members inherited from interface Folks.NameDetails

full_name
nickname

structured_name
change_full_name

change_nickname
change_structured_name

All known members inherited from interface Folks.PhoneDetails

phone_numbers

change_phone_numbers

All known members inherited from interface Folks.PresenceDetails

client_types
presence_message
presence_status

presence_type
get_default_message_from_type

typecmp
is_online

All known members inherited from interface Folks.UrlDetails

urls

change_urls

Generated by Valadoc