Folks.Individual – folks Reference Manual

Individual

Object Hierarchy:

Description:

public class Individual : Object, AliasDetails, AvatarDetails, BirthdayDetails, EmailDetails, ExtendedInfo, FavouriteDetails, GenderDetails, GroupDetails, ImDetails, InteractionDetails, LocalIdDetails, LocationDetails, NameDetails, NoteDetails, PresenceDetails, PhoneDetails, PostalAddressDetails, RoleDetails, UrlDetails, WebServiceDetails

A physical person, aggregated from the various Personas the person might have, such as their different IM addresses or vCard entries. An individual must always contain at least one Persona.

When choosing the values of single-valued properties (such as Individual.alias and Individual.avatar; but not multi-valued properties such as Individual.groups and Individual.im_addresses) from the Personas in the individual to present as the values of those properties of the individual, it is guaranteed that if the individual contains a persona from the primary persona store (see IndividualAggregator.primary_store), its property values will be chosen above all others. This means that any changes to property values made through folks (which are normally written to the primary store) will always be used by Folks.Individuals.

No further guarantees are made about the order of preference used for choosing which property values to use for the Folks.Individual, other than that the order may vary between properties, but is guaranteed to be stable for a given property.

Namespace: Folks

Package: folks

Content:

Properties:

public string display_name { get; }
The name of this Individual to display in the UI.
public string id { get; }
A unique identifier for the Individual.
public bool is_user { get; }
Whether the Individual is the user.
public Set<Persona> personas { get; set; }
The set of Persona s encapsulated by this Individual.
public TrustLevel trust_level { get; }
The trust level of the Individual.

Creation methods:

public Individual (Set<Persona>? personas)
Create a new Individual.

Methods:

public bool has_anti_link_with_individual (Individual i)
Anti-linked with an individual?
public bool has_anti_link_with_persona (Persona p)
Anti-linked with a persona?

Signals:

public signal void personas_changed (Set<Persona> added, Set<Persona> removed)
Emitted when one or more Personas are added to or removed from the Individual. As the parameters are (unordered) sets, the orders of their elements are undefined.
public signal void removed (Individual? replacement_individual)
Emitted when the last of the Individual's Personas has been removed.