gtk3/docs/reference/gtk/html/gtk3-GtkStyleProperties.html
2021-04-15 09:52:10 +01:00

803 lines
44 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkStyleProperties: GTK+ 3 Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
<link rel="up" href="theming.html" title="Part IV. Theming in GTK+">
<link rel="prev" href="GtkStyleProvider.html" title="GtkStyleProvider">
<link rel="next" href="gtk3-GtkWidgetPath.html" title="GtkWidgetPath">
<meta name="generator" content="GTK-Doc V1.33.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
<a href="#gtk3-GtkStyleProperties.description" class="shortcut">Description</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="theming.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="GtkStyleProvider.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="gtk3-GtkWidgetPath.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="gtk3-GtkStyleProperties"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="gtk3-GtkStyleProperties.top_of_page"></a>GtkStyleProperties</span></h2>
<p>GtkStyleProperties — Store for style property information</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="gtk3-GtkStyleProperties.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_proto_type">
<col class="functions_proto_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gtk3-GtkStyleProperties.html#gtk-style-properties-clear" title="gtk_style_properties_clear ()">gtk_style_properties_clear</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gtk3-GtkStyleProperties.html#gtk-style-properties-get" title="gtk_style_properties_get ()">gtk_style_properties_get</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="gtk3-GtkStyleProperties.html#gtk-style-properties-get-property" title="gtk_style_properties_get_property ()">gtk_style_properties_get_property</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gtk3-GtkStyleProperties.html#gtk-style-properties-get-valist" title="gtk_style_properties_get_valist ()">gtk_style_properties_get_valist</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="returnvalue">GtkSymbolicColor</span></a> *
</td>
<td class="function_name">
<a class="link" href="gtk3-GtkStyleProperties.html#gtk-style-properties-lookup-color" title="gtk_style_properties_lookup_color ()">gtk_style_properties_lookup_color</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="gtk3-GtkStyleProperties.html#gtk-style-properties-lookup-property" title="gtk_style_properties_lookup_property ()">gtk_style_properties_lookup_property</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gtk3-GtkStyleProperties.html#gtk-style-properties-map-color" title="gtk_style_properties_map_color ()">gtk_style_properties_map_color</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gtk3-GtkStyleProperties.html#gtk-style-properties-merge" title="gtk_style_properties_merge ()">gtk_style_properties_merge</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="returnvalue">GtkStyleProperties</span></a> *
</td>
<td class="function_name">
<a class="link" href="gtk3-GtkStyleProperties.html#gtk-style-properties-new" title="gtk_style_properties_new ()">gtk_style_properties_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<span class="c_punctuation">(</span><a class="link" href="gtk3-GtkStyleProperties.html#GtkStylePropertyParser" title="GtkStylePropertyParser ()">*GtkStylePropertyParser</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gtk3-GtkStyleProperties.html#gtk-style-properties-register-property" title="gtk_style_properties_register_property ()">gtk_style_properties_register_property</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gtk3-GtkStyleProperties.html#gtk-style-properties-set" title="gtk_style_properties_set ()">gtk_style_properties_set</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gtk3-GtkStyleProperties.html#gtk-style-properties-set-property" title="gtk_style_properties_set_property ()">gtk_style_properties_set_property</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gtk3-GtkStyleProperties.html#gtk-style-properties-set-valist" title="gtk_style_properties_set_valist ()">gtk_style_properties_set_valist</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gtk3-GtkStyleProperties.html#gtk-style-properties-unset-property" title="gtk_style_properties_unset_property ()">gtk_style_properties_unset_property</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="gtk3-GtkStyleProperties.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="other_proto_type">
<col class="other_proto_name">
</colgroup>
<tbody><tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties">GtkStyleProperties</a></td>
</tr></tbody>
</table></div>
</div>
<div class="refsect1">
<a name="gtk3-GtkStyleProperties.includes"></a><h2>Includes</h2>
<pre class="synopsis">#include &lt;gtk/gtk.h&gt;
</pre>
</div>
<div class="refsect1">
<a name="gtk3-GtkStyleProperties.description"></a><h2>Description</h2>
<p>GtkStyleProperties provides the storage for style information
that is used by <a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> and other <a class="link" href="GtkStyleProvider.html" title="GtkStyleProvider"><span class="type">GtkStyleProvider</span></a>
implementations.</p>
<p>Before style properties can be stored in GtkStyleProperties, they
must be registered with <a class="link" href="gtk3-GtkStyleProperties.html#gtk-style-properties-register-property" title="gtk_style_properties_register_property ()"><code class="function">gtk_style_properties_register_property()</code></a>.</p>
<p>Unless you are writing a <a class="link" href="GtkStyleProvider.html" title="GtkStyleProvider"><span class="type">GtkStyleProvider</span></a> implementation, you
are unlikely to use this API directly, as <a class="link" href="GtkStyleContext.html#gtk-style-context-get" title="gtk_style_context_get ()"><code class="function">gtk_style_context_get()</code></a>
and its variants are the preferred way to access styling information
from widget implementations and theming engine implementations
should use the APIs provided by <a class="link" href="GtkThemingEngine.html" title="GtkThemingEngine"><span class="type">GtkThemingEngine</span></a> instead.</p>
<p><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> has been deprecated in GTK 3.16. The CSS
machinery does not use it anymore and all users of this object
have been deprecated.</p>
</div>
<div class="refsect1">
<a name="gtk3-GtkStyleProperties.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gtk-style-properties-clear"></a><h3>gtk_style_properties_clear ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_style_properties_clear (<em class="parameter"><code><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> *props</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_style_properties_clear</code> has been deprecated since version 3.16 and should not be used in newly-written code.</p>
<p><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> are deprecated.</p>
</div>
<p>Clears all style information from <em class="parameter"><code>props</code></em>
.</p>
<div class="refsect3">
<a name="gtk-style-properties-clear.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>props</p></td>
<td class="parameter_description"><p>a <a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-style-properties-get"></a><h3>gtk_style_properties_get ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_style_properties_get (<em class="parameter"><code><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> *props</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkStateFlags" title="enum GtkStateFlags"><span class="type">GtkStateFlags</span></a> state</code></em>,
<em class="parameter"><code>...</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_style_properties_get</code> has been deprecated since version 3.16 and should not be used in newly-written code.</p>
<p><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> are deprecated.</p>
</div>
<p>Retrieves several style property values from <em class="parameter"><code>props</code></em>
for a
given state.</p>
<div class="refsect3">
<a name="gtk-style-properties-get.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>props</p></td>
<td class="parameter_description"><p>a <a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>state</p></td>
<td class="parameter_description"><p>state to retrieve the property values for</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>...</p></td>
<td class="parameter_description"><p>property name /return value pairs, followed by <code class="literal">NULL</code></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-style-properties-get-property"></a><h3>gtk_style_properties_get_property ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_style_properties_get_property (<em class="parameter"><code><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> *props</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *property</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkStateFlags" title="enum GtkStateFlags"><span class="type">GtkStateFlags</span></a> state</code></em>,
<em class="parameter"><code><span class="type">GValue</span> *value</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_style_properties_get_property</code> has been deprecated since version 3.16 and should not be used in newly-written code.</p>
<p><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> are deprecated.</p>
</div>
<p>Gets a style property from <em class="parameter"><code>props</code></em>
for the given state. When done with <em class="parameter"><code>value</code></em>
,
<code class="function">g_value_unset()</code> needs to be called to free any allocated memory.</p>
<div class="refsect3">
<a name="gtk-style-properties-get-property.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>props</p></td>
<td class="parameter_description"><p>a <a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property</p></td>
<td class="parameter_description"><p>style property name</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>state</p></td>
<td class="parameter_description"><p>state to retrieve the property value for</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>return location for the style property value. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-style-properties-get-property.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the property exists in <em class="parameter"><code>props</code></em>
, <code class="literal">FALSE</code> otherwise</p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-style-properties-get-valist"></a><h3>gtk_style_properties_get_valist ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_style_properties_get_valist (<em class="parameter"><code><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> *props</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkStateFlags" title="enum GtkStateFlags"><span class="type">GtkStateFlags</span></a> state</code></em>,
<em class="parameter"><code><span class="type">va_list</span> args</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_style_properties_get_valist</code> has been deprecated since version 3.16 and should not be used in newly-written code.</p>
<p><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> are deprecated.</p>
</div>
<p>Retrieves several style property values from <em class="parameter"><code>props</code></em>
for a given state.</p>
<div class="refsect3">
<a name="gtk-style-properties-get-valist.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>props</p></td>
<td class="parameter_description"><p>a <a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>state</p></td>
<td class="parameter_description"><p>state to retrieve the property values for</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>args</p></td>
<td class="parameter_description"><p>va_list of property name/return location pairs, followed by <code class="literal">NULL</code></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-style-properties-lookup-color"></a><h3>gtk_style_properties_lookup_color ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="returnvalue">GtkSymbolicColor</span></a> *
gtk_style_properties_lookup_color (<em class="parameter"><code><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> *props</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_style_properties_lookup_color</code> has been deprecated since version 3.8 and should not be used in newly-written code.</p>
<p><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a> is deprecated.</p>
</div>
<p>Returns the symbolic color that is mapped
to <em class="parameter"><code>name</code></em>
.</p>
<div class="refsect3">
<a name="gtk-style-properties-lookup-color.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>props</p></td>
<td class="parameter_description"><p>a <a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>name</p></td>
<td class="parameter_description"><p>color name to lookup</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-style-properties-lookup-color.returns"></a><h4>Returns</h4>
<p>The mapped color. </p>
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-style-properties-lookup-property"></a><h3>gtk_style_properties_lookup_property ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_style_properties_lookup_property (<em class="parameter"><code>const <span class="type">gchar</span> *property_name</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-GtkStyleProperties.html#GtkStylePropertyParser" title="GtkStylePropertyParser ()"><span class="type">GtkStylePropertyParser</span></a> *parse_func</code></em>,
<em class="parameter"><code><span class="type">GParamSpec</span> **pspec</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_style_properties_lookup_property</code> has been deprecated since version 3.8 and should not be used in newly-written code.</p>
<p>This code could only look up custom properties and
those are deprecated.</p>
</div>
<p>Returns <code class="literal">TRUE</code> if a property has been registered, if <em class="parameter"><code>pspec</code></em>
or
<em class="parameter"><code>parse_func</code></em>
are not <code class="literal">NULL</code>, the <span class="type">GParamSpec</span> and parsing function
will be respectively returned.</p>
<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
<div class="refsect3">
<a name="gtk-style-properties-lookup-property.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>property_name</p></td>
<td class="parameter_description"><p>property name to look up</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>parse_func</p></td>
<td class="parameter_description"><p>return location for the parse function. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>pspec</p></td>
<td class="parameter_description"><p>return location for the <span class="type">GParamSpec</span>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-style-properties-lookup-property.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the property is registered, <code class="literal">FALSE</code> otherwise</p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-style-properties-map-color"></a><h3>gtk_style_properties_map_color ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_style_properties_map_color (<em class="parameter"><code><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> *props</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a> *color</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_style_properties_map_color</code> has been deprecated since version 3.8 and should not be used in newly-written code.</p>
<p><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a> is deprecated.</p>
</div>
<p>Maps <em class="parameter"><code>color</code></em>
so it can be referenced by <em class="parameter"><code>name</code></em>
. See
<a class="link" href="gtk3-GtkStyleProperties.html#gtk-style-properties-lookup-color" title="gtk_style_properties_lookup_color ()"><code class="function">gtk_style_properties_lookup_color()</code></a></p>
<div class="refsect3">
<a name="gtk-style-properties-map-color.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>props</p></td>
<td class="parameter_description"><p>a <a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>name</p></td>
<td class="parameter_description"><p>color name</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>color</p></td>
<td class="parameter_description"><p><a class="link" href="gtk3-GtkSymbolicColor.html#GtkSymbolicColor" title="GtkSymbolicColor"><span class="type">GtkSymbolicColor</span></a> to map <em class="parameter"><code>name</code></em>
to</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-style-properties-merge"></a><h3>gtk_style_properties_merge ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_style_properties_merge (<em class="parameter"><code><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> *props</code></em>,
<em class="parameter"><code>const <a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> *props_to_merge</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> replace</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_style_properties_merge</code> has been deprecated since version 3.16 and should not be used in newly-written code.</p>
<p><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> are deprecated.</p>
</div>
<p>Merges into <em class="parameter"><code>props</code></em>
all the style information contained
in <em class="parameter"><code>props_to_merge</code></em>
. If <em class="parameter"><code>replace</code></em>
is <code class="literal">TRUE</code>, the values
will be overwritten, if it is <code class="literal">FALSE</code>, the older values
will prevail.</p>
<div class="refsect3">
<a name="gtk-style-properties-merge.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>props</p></td>
<td class="parameter_description"><p>a <a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>props_to_merge</p></td>
<td class="parameter_description"><p>a second <a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>replace</p></td>
<td class="parameter_description"><p>whether to replace values or not</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-style-properties-new"></a><h3>gtk_style_properties_new ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="returnvalue">GtkStyleProperties</span></a> *
gtk_style_properties_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_style_properties_new</code> has been deprecated since version 3.16 and should not be used in newly-written code.</p>
<p><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> are deprecated.</p>
</div>
<p>Returns a newly created <a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a></p>
<div class="refsect3">
<a name="gtk-style-properties-new.returns"></a><h4>Returns</h4>
<p> a new <a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="GtkStylePropertyParser"></a><h3>GtkStylePropertyParser ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
<span class="c_punctuation">(</span>*GtkStylePropertyParser<span class="c_punctuation">)</span> (<em class="parameter"><code>const <span class="type">gchar</span> *string</code></em>,
<em class="parameter"><code><span class="type">GValue</span> *value</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
</div>
<hr>
<div class="refsect2">
<a name="gtk-style-properties-register-property"></a><h3>gtk_style_properties_register_property ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_style_properties_register_property
(<em class="parameter"><code><a class="link" href="gtk3-GtkStyleProperties.html#GtkStylePropertyParser" title="GtkStylePropertyParser ()"><span class="type">GtkStylePropertyParser</span></a> parse_func</code></em>,
<em class="parameter"><code><span class="type">GParamSpec</span> *pspec</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_style_properties_register_property</code> has been deprecated since version 3.8 and should not be used in newly-written code.</p>
<p>Code should use the default properties provided by CSS.</p>
</div>
<p>Registers a property so it can be used in the CSS file format.
This function is the low-level equivalent of
<a class="link" href="GtkThemingEngine.html#gtk-theming-engine-register-property" title="gtk_theming_engine_register_property ()"><code class="function">gtk_theming_engine_register_property()</code></a>, if you are implementing
a theming engine, you want to use that function instead.</p>
<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
<div class="refsect3">
<a name="gtk-style-properties-register-property.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>parse_func</p></td>
<td class="parameter_description"><p>parsing function to use, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>pspec</p></td>
<td class="parameter_description"><p>the <span class="type">GParamSpec</span> for the new property</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-style-properties-set"></a><h3>gtk_style_properties_set ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_style_properties_set (<em class="parameter"><code><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> *props</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkStateFlags" title="enum GtkStateFlags"><span class="type">GtkStateFlags</span></a> state</code></em>,
<em class="parameter"><code>...</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_style_properties_set</code> has been deprecated since version 3.16 and should not be used in newly-written code.</p>
<p><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> are deprecated.</p>
</div>
<p>Sets several style properties on <em class="parameter"><code>props</code></em>
.</p>
<div class="refsect3">
<a name="gtk-style-properties-set.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>props</p></td>
<td class="parameter_description"><p>a <a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>state</p></td>
<td class="parameter_description"><p>state to set the values for</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>...</p></td>
<td class="parameter_description"><p>property name/value pairs, followed by <code class="literal">NULL</code></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-style-properties-set-property"></a><h3>gtk_style_properties_set_property ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_style_properties_set_property (<em class="parameter"><code><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> *props</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *property</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkStateFlags" title="enum GtkStateFlags"><span class="type">GtkStateFlags</span></a> state</code></em>,
<em class="parameter"><code>const <span class="type">GValue</span> *value</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_style_properties_set_property</code> has been deprecated since version 3.16 and should not be used in newly-written code.</p>
<p><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> are deprecated.</p>
</div>
<p>Sets a styling property in <em class="parameter"><code>props</code></em>
.</p>
<div class="refsect3">
<a name="gtk-style-properties-set-property.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>props</p></td>
<td class="parameter_description"><p>a <a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property</p></td>
<td class="parameter_description"><p>styling property to set</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>state</p></td>
<td class="parameter_description"><p>state to set the value for</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>new value for the property</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-style-properties-set-valist"></a><h3>gtk_style_properties_set_valist ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_style_properties_set_valist (<em class="parameter"><code><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> *props</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkStateFlags" title="enum GtkStateFlags"><span class="type">GtkStateFlags</span></a> state</code></em>,
<em class="parameter"><code><span class="type">va_list</span> args</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_style_properties_set_valist</code> has been deprecated since version 3.16 and should not be used in newly-written code.</p>
<p><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> are deprecated.</p>
</div>
<p>Sets several style properties on <em class="parameter"><code>props</code></em>
.</p>
<div class="refsect3">
<a name="gtk-style-properties-set-valist.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>props</p></td>
<td class="parameter_description"><p>a <a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>state</p></td>
<td class="parameter_description"><p>state to set the values for</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>args</p></td>
<td class="parameter_description"><p>va_list of property name/value pairs, followed by <code class="literal">NULL</code></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-style-properties-unset-property"></a><h3>gtk_style_properties_unset_property ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_style_properties_unset_property (<em class="parameter"><code><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> *props</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *property</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkStateFlags" title="enum GtkStateFlags"><span class="type">GtkStateFlags</span></a> state</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_style_properties_unset_property</code> has been deprecated since version 3.16 and should not be used in newly-written code.</p>
<p><a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a> are deprecated.</p>
</div>
<p>Unsets a style property in <em class="parameter"><code>props</code></em>
.</p>
<div class="refsect3">
<a name="gtk-style-properties-unset-property.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>props</p></td>
<td class="parameter_description"><p>a <a class="link" href="gtk3-GtkStyleProperties.html#GtkStyleProperties" title="struct GtkStyleProperties"><span class="type">GtkStyleProperties</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>property</p></td>
<td class="parameter_description"><p>property to unset</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>state</p></td>
<td class="parameter_description"><p>state to unset</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
</div>
<div class="refsect1">
<a name="gtk3-GtkStyleProperties.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="GtkStyleProperties"></a><h3>struct GtkStyleProperties</h3>
<pre class="programlisting">struct GtkStyleProperties {
};
</pre>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.33.1</div>
</body>
</html>