Method

VteTerminalref_termprop_variant

since: 0.78

Declaration [src]

GVariant*
vte_terminal_ref_termprop_variant (
  VteTerminal* terminal,
  const char* prop
)

Description [src]

Returns the value of prop as a GVariant, or NULL if prop unset, or prop is not a registered property.

The GVariantType of the returned GVariant depends on the termprop type: * A VTE_PROPERTY_VALUELESS termprop returns a G_VARIANT_TYPE_UNIT variant. * A VTE_PROPERTY_BOOL termprop returns a G_VARIANT_TYPE_BOOLEAN variant. * A VTE_PROPERTY_INT termprop returns a G_VARIANT_TYPE_INT64 variant. * A VTE_PROPERTY_UINT termprop returns a G_VARIANT_TYPE_UINT64 variant. * A VTE_PROPERTY_DOUBLE termprop returns a G_VARIANT_TYPE_DOUBLE variant. * A VTE_PROPERTY_RGB or VTE_PROPERTY_RGBA termprop returns a “(ddddv)” tuple containing the red, green, blue, and alpha (1.0 for VTE_PROPERTY_RGB) components of the color and a variant of unspecified contents * A VTE_PROPERTY_STRING termprop returns a G_VARIANT_TYPE_STRING variant. * A VTE_PROPERTY_DATA termprop returns a “ay” variant (which is not a bytestring!). * A VTE_PROPERTY_UUID termprop returns a G_VARIANT_TYPE_STRING variant containing a string representation of the UUID in simple form. * A VTE_PROPERTY_URI termprop returns a G_VARIANT_TYPE_STRING variant containing a string representation of the URI * A VTE_PROPERTY_IMAGE termprop returns NULL since an image has no variant representation.

Available since: 0.78

Parameters

prop

Type: const char*

A termprop name.

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

Return value

Type: GVariant

A floating GVariant, or NULL.

The caller of the method takes ownership of the returned data, and is responsible for freeing it.
The return value can be NULL.