Function

PurpleStatusTypenew_full

since: 2.0

Declaration [src]

PurpleStatusType*
purple_status_type_new_full (
  PurpleStatusPrimitive primitive,
  const char* id,
  const char* name,
  gboolean saveable,
  gboolean user_settable,
  gboolean independent
)

Description [src]

Creates a new status type.

Available since: 2.0

Parameters

primitive

Type: PurpleStatusPrimitive

The primitive status type.

id

Type: const char*

The ID of the status type, or NULL to use the id of the primitive status type.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
name

Type: const char*

The name presented to the user, or NULL to use the name of the primitive status type.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
saveable

Type: gboolean

TRUE if the information set for this status by the user can be saved for future sessions.

user_settable

Type: gboolean

TRUE if this is a status the user can manually set.

independent

Type: gboolean

TRUE if this is an independent (non-exclusive) status type.

Return value

Type: PurpleStatusType

A new status type.

The caller of the function takes ownership of the data, and is responsible for freeing it.