Update documentation about link styling

The ::link-color and ::visited-link-color style properties
are ignored now. Document that.
This commit is contained in:
Matthias Clasen 2014-03-17 15:00:45 -04:00
parent b95ce71b89
commit ac96c35230
2 changed files with 11 additions and 8 deletions

View File

@ -265,12 +265,9 @@ struct _GtkLabelPrivate
* to ensure that pressing inside a link and releasing outside of it
* does not activate the link.
*
* Links are rendered with the link-color/visited-link-color colors
* that are determined by the style and with an underline. When the mouse
* pointer is over a link, the pointer is changed to indicate the link,
* and the background behind the link is rendered with the base[PRELIGHT]
* color. While a button is pressed over a link, the background is rendered
* with the base[ACTIVE] color.
* Links are rendered with the #GTK_STATE_FLAG_LINK/#GTK_STATE_FLAG_VISITED
* state flags. When the mouse pointer is over a link, the pointer is changed
* to indicate the link.
*
* Labels with links accept keyboard focus, and it is possible to move
* the focus between the embedded links using Tab/Shift-Tab. The focus
@ -930,8 +927,8 @@ gtk_label_class_init (GtkLabelClass *class)
* GtkLabel:track-visited-links:
*
* Set this property to %TRUE to make the label track which links
* have been clicked. It will then apply the ::visited-link-color
* color, instead of ::link-color.
* have been visited. It will then apply the #GTK_STATE_FLAG_VISITED
* when rendering this link, in addition to #GTK_STATE_FLAG_LINK.
*
* Since: 2.18
*/

View File

@ -3499,6 +3499,9 @@ G_GNUC_END_IGNORE_DEPRECATIONS
* The "link-color" style property defines the color of unvisited links.
*
* Since: 2.10
*
* Deprecated: 3.12: Links now use a separate state flags for selecting
* different theming, this style property is ignored
*/
gtk_widget_class_install_style_property (klass,
g_param_spec_boxed ("link-color",
@ -3513,6 +3516,9 @@ G_GNUC_END_IGNORE_DEPRECATIONS
* The "visited-link-color" style property defines the color of visited links.
*
* Since: 2.10
*
* Deprecated: 3.12: Links now use a separate state flags for selecting
* different theming, this style property is ignored
*/
gtk_widget_class_install_style_property (klass,
g_param_spec_boxed ("visited-link-color",