forked from AuroraMiddleware/gtk
docs: use markdown instead of <note>
This commit is contained in:
parent
8dcda824d2
commit
6abe7a7094
@ -45,12 +45,8 @@ G_BEGIN_DECLS
|
||||
*
|
||||
* The event structures contain data specific to each type of event in GDK.
|
||||
*
|
||||
* <note>
|
||||
* <para>
|
||||
* A common mistake is to forget to set the event mask of a widget so that
|
||||
* the required events are received. See gtk_widget_set_events().
|
||||
* </para>
|
||||
* </note>
|
||||
* > A common mistake is to forget to set the event mask of a widget so that
|
||||
* > the required events are received. See gtk_widget_set_events().
|
||||
*/
|
||||
|
||||
|
||||
|
@ -124,13 +124,11 @@ gdk_x11_device_manager_lookup (GdkDeviceManager *device_manager,
|
||||
*
|
||||
* Returns the device ID as seen by XInput2.
|
||||
*
|
||||
* <note>
|
||||
* If gdk_disable_multidevice() has been called, this function
|
||||
* will respectively return 2/3 for the core pointer and keyboard,
|
||||
* (matching the IDs for the Virtual Core Pointer and Keyboard in
|
||||
* XInput 2), but calling this function on any slave devices (i.e.
|
||||
* those managed via XInput 1.x), will return 0.
|
||||
* </note>
|
||||
* > If gdk_disable_multidevice() has been called, this function
|
||||
* > will respectively return 2/3 for the core pointer and keyboard,
|
||||
* > (matching the IDs for the Virtual Core Pointer and Keyboard in
|
||||
* > XInput 2), but calling this function on any slave devices (i.e.
|
||||
* > those managed via XInput 1.x), will return 0.
|
||||
*
|
||||
* Returns: the XInput2 device ID.
|
||||
*
|
||||
|
@ -274,12 +274,12 @@ gtk_activatable_default_init (GtkActivatableInterface *iface)
|
||||
{
|
||||
/**
|
||||
* GtkActivatable:related-action:
|
||||
*
|
||||
*
|
||||
* The action that this activatable will activate and receive
|
||||
* updates from for various states and possibly appearance.
|
||||
*
|
||||
* <note><para>#GtkActivatable implementors need to handle the this property and
|
||||
* call gtk_activatable_do_set_related_action() when it changes.</para></note>
|
||||
* > #GtkActivatable implementors need to handle the this property and
|
||||
* > call gtk_activatable_do_set_related_action() when it changes.
|
||||
*
|
||||
* Since: 2.16
|
||||
*
|
||||
@ -294,7 +294,7 @@ gtk_activatable_default_init (GtkActivatableInterface *iface)
|
||||
|
||||
/**
|
||||
* GtkActivatable:use-action-appearance:
|
||||
*
|
||||
*
|
||||
* Whether this activatable should reset its layout
|
||||
* and appearance when setting the related action or when
|
||||
* the action changes appearance.
|
||||
@ -302,9 +302,9 @@ gtk_activatable_default_init (GtkActivatableInterface *iface)
|
||||
* See the #GtkAction documentation directly to find which properties
|
||||
* should be ignored by the #GtkActivatable when this property is %FALSE.
|
||||
*
|
||||
* <note><para>#GtkActivatable implementors need to handle this property
|
||||
* and call gtk_activatable_sync_action_properties() on the activatable
|
||||
* widget when it changes.</para></note>
|
||||
* > #GtkActivatable implementors need to handle this property
|
||||
* > and call gtk_activatable_sync_action_properties() on the activatable
|
||||
* > widget when it changes.
|
||||
*
|
||||
* Since: 2.16
|
||||
*
|
||||
@ -375,8 +375,8 @@ gtk_activatable_sync_action_properties (GtkActivatable *activatable,
|
||||
*
|
||||
* Sets the related action on the @activatable object.
|
||||
*
|
||||
* <note><para>#GtkActivatable implementors need to handle the #GtkActivatable:related-action
|
||||
* property and call gtk_activatable_do_set_related_action() when it changes.</para></note>
|
||||
* > #GtkActivatable implementors need to handle the #GtkActivatable:related-action
|
||||
* > property and call gtk_activatable_do_set_related_action() when it changes.
|
||||
*
|
||||
* Since: 2.16
|
||||
*
|
||||
@ -416,10 +416,10 @@ gtk_activatable_action_notify (GtkAction *action,
|
||||
* method is called when the related #GtkAction properties change
|
||||
* and registers to the action's proxy list.
|
||||
*
|
||||
* <note><para>Be careful to call this before setting the local
|
||||
* copy of the #GtkAction property, since this function uses
|
||||
* gtk_activatable_get_related_action() to retrieve the
|
||||
* previous action</para></note>
|
||||
* > Be careful to call this before setting the local
|
||||
* > copy of the #GtkAction property, since this function uses
|
||||
* > gtk_activatable_get_related_action() to retrieve the
|
||||
* > previous action.
|
||||
*
|
||||
* Since: 2.16
|
||||
*
|
||||
@ -517,10 +517,10 @@ gtk_activatable_get_related_action (GtkActivatable *activatable)
|
||||
* Sets whether this activatable should reset its layout and appearance
|
||||
* when setting the related action or when the action changes appearance
|
||||
*
|
||||
* <note><para>#GtkActivatable implementors need to handle the
|
||||
* #GtkActivatable:use-action-appearance property and call
|
||||
* gtk_activatable_sync_action_properties() to update @activatable
|
||||
* if needed.</para></note>
|
||||
* > #GtkActivatable implementors need to handle the
|
||||
* > #GtkActivatable:use-action-appearance property and call
|
||||
* > gtk_activatable_sync_action_properties() to update @activatable
|
||||
* > if needed.
|
||||
*
|
||||
* Since: 2.16
|
||||
*
|
||||
|
@ -44,8 +44,9 @@ typedef struct _GtkActivatableIface GtkActivatableIface;
|
||||
* properties that are meant to effect the appearance accordingly.
|
||||
* @sync_action_properties: Called to update the activatable completely, this is called internally when
|
||||
* #GtkActivatable:related-action property is set or unset and by the implementor when
|
||||
* #GtkActivatable:use-action-appearance changes.<note><para>This method can be called
|
||||
* with a %NULL action at times</para></note>
|
||||
* #GtkActivatable:use-action-appearance changes.
|
||||
*
|
||||
* > This method can be called with a %NULL action at times.
|
||||
*
|
||||
* Since: 2.16
|
||||
*
|
||||
|
@ -66,11 +66,9 @@
|
||||
* allocation will remain fixed as the height of the handlebox shrinks,
|
||||
* so the snap edge should be set to %GTK_POS_BOTTOM.
|
||||
*
|
||||
* <note>
|
||||
* #GtkHandleBox has been deprecated. It is very specialized, lacks features
|
||||
* to make it useful and most importantly does not fit well into modern
|
||||
* application design. Do not use it. There is no replacement.
|
||||
* </note>
|
||||
* > #GtkHandleBox has been deprecated. It is very specialized, lacks features
|
||||
* > to make it useful and most importantly does not fit well into modern
|
||||
* > application design. Do not use it. There is no replacement.
|
||||
*/
|
||||
|
||||
|
||||
|
@ -39,12 +39,10 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
|
||||
* widgets within a window. It displays a horizontal line with a shadow to
|
||||
* make it appear sunken into the interface.
|
||||
*
|
||||
* <note>
|
||||
* The #GtkHSeparator widget is not used as a separator within menus.
|
||||
* To create a separator in a menu create an empty #GtkSeparatorMenuItem
|
||||
* widget using gtk_separator_menu_item_new() and add it to the menu with
|
||||
* gtk_menu_shell_append().
|
||||
* </note>
|
||||
* > The #GtkHSeparator widget is not used as a separator within menus.
|
||||
* > To create a separator in a menu create an empty #GtkSeparatorMenuItem
|
||||
* > widget using gtk_separator_menu_item_new() and add it to the menu with
|
||||
* > gtk_menu_shell_append().
|
||||
*
|
||||
* GtkHSeparator has been deprecated, use #GtkSeparator instead.
|
||||
*/
|
||||
|
@ -4375,17 +4375,15 @@ gtk_widget_modify_fg (GtkWidget *widget,
|
||||
* All other style values are left untouched.
|
||||
* See also gtk_widget_modify_style().
|
||||
*
|
||||
* <note><para>
|
||||
* Note that “no window” widgets (which have the %GTK_NO_WINDOW
|
||||
* flag set) draw on their parent container's window and thus may
|
||||
* not draw any background themselves. This is the case for e.g.
|
||||
* #GtkLabel.
|
||||
* </para><para>
|
||||
* To modify the background of such widgets, you have to set the
|
||||
* background color on their parent; if you want to set the background
|
||||
* of a rectangular area around a label, try placing the label in
|
||||
* a #GtkEventBox widget and setting the background color on that.
|
||||
* </para></note>
|
||||
* > Note that “no window” widgets (which have the %GTK_NO_WINDOW
|
||||
* > flag set) draw on their parent container's window and thus may
|
||||
* > not draw any background themselves. This is the case for e.g.
|
||||
* > #GtkLabel.
|
||||
* >
|
||||
* > To modify the background of such widgets, you have to set the
|
||||
* > background color on their parent; if you want to set the background
|
||||
* > of a rectangular area around a label, try placing the label in
|
||||
* > a #GtkEventBox widget and setting the background color on that.
|
||||
*
|
||||
* Deprecated:3.0: Use gtk_widget_override_background_color() instead
|
||||
*/
|
||||
@ -4475,17 +4473,15 @@ gtk_widget_modify_text (GtkWidget *widget,
|
||||
* (see gtk_widget_modify_text()) for widgets such as #GtkEntry
|
||||
* and #GtkTextView. See also gtk_widget_modify_style().
|
||||
*
|
||||
* <note><para>
|
||||
* Note that “no window” widgets (which have the %GTK_NO_WINDOW
|
||||
* flag set) draw on their parent container's window and thus may
|
||||
* not draw any background themselves. This is the case for e.g.
|
||||
* #GtkLabel.
|
||||
* </para><para>
|
||||
* To modify the background of such widgets, you have to set the
|
||||
* base color on their parent; if you want to set the background
|
||||
* of a rectangular area around a label, try placing the label in
|
||||
* a #GtkEventBox widget and setting the base color on that.
|
||||
* </para></note>
|
||||
* > Note that “no window” widgets (which have the %GTK_NO_WINDOW
|
||||
* > flag set) draw on their parent container's window and thus may
|
||||
* > not draw any background themselves. This is the case for e.g.
|
||||
* > #GtkLabel.
|
||||
* >
|
||||
* > To modify the background of such widgets, you have to set the
|
||||
* > base color on their parent; if you want to set the background
|
||||
* > of a rectangular area around a label, try placing the label in
|
||||
* > a #GtkEventBox widget and setting the base color on that.
|
||||
*
|
||||
* Deprecated:3.0: Use gtk_widget_override_background_color() instead
|
||||
*/
|
||||
|
@ -60,11 +60,9 @@
|
||||
* gtk_table_set_homogeneous(), can be used to set whether all cells in the
|
||||
* table will resize themselves to the size of the largest widget in the table.
|
||||
*
|
||||
* <note>
|
||||
* #GtkTable has been deprecated. Use #GtkGrid instead. It provides the same
|
||||
* capabilities as GtkTable for arranging widgets in a rectangular grid, but
|
||||
* does support height-for-width geometry management.
|
||||
* </note>
|
||||
* > #GtkTable has been deprecated. Use #GtkGrid instead. It provides the same
|
||||
* > capabilities as GtkTable for arranging widgets in a rectangular grid, but
|
||||
* > does support height-for-width geometry management.
|
||||
*/
|
||||
|
||||
|
||||
|
@ -51,8 +51,8 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
|
||||
* the tearoff menu can be reattached. Activating it will erase the tearoff
|
||||
* menu window.
|
||||
*
|
||||
* <note>#GtkTearoffMenuItem is deprecated and should not be used in newly
|
||||
* written code. Menus are not meant to be torn around.</note>
|
||||
* > #GtkTearoffMenuItem is deprecated and should not be used in newly
|
||||
* > written code. Menus are not meant to be torn around.
|
||||
*/
|
||||
|
||||
|
||||
|
@ -65,11 +65,9 @@
|
||||
* The UI definitions are specified in an XML format which can be
|
||||
* roughly described by the following DTD.
|
||||
*
|
||||
* <note><para>
|
||||
* Do not confuse the GtkUIManager UI Definitions described here with
|
||||
* the similarly named <link linkend="BUILDER-UI">GtkBuilder UI
|
||||
* Definitions</link>.
|
||||
* </para></note>
|
||||
* > Do not confuse the GtkUIManager UI Definitions described here with
|
||||
* > the similarly named <link linkend="BUILDER-UI">GtkBuilder UI
|
||||
* > Definitions</link>.
|
||||
*
|
||||
* |[
|
||||
* <!ELEMENT ui (menubar|toolbar|popup|accelerator)* >
|
||||
|
@ -77,11 +77,10 @@ struct _GtkMessageDialogClass
|
||||
* Prebuilt sets of buttons for the dialog. If
|
||||
* none of these choices are appropriate, simply use %GTK_BUTTONS_NONE
|
||||
* then call gtk_dialog_add_buttons().
|
||||
* <note>
|
||||
* Please note that %GTK_BUTTONS_OK, %GTK_BUTTONS_YES_NO
|
||||
* and %GTK_BUTTONS_OK_CANCEL are discouraged by the
|
||||
* [GNOME Human Interface Guidelines](http://library.gnome.org/devel/hig-book/stable/).
|
||||
* </note>
|
||||
*
|
||||
* > Please note that %GTK_BUTTONS_OK, %GTK_BUTTONS_YES_NO
|
||||
* > and %GTK_BUTTONS_OK_CANCEL are discouraged by the
|
||||
* > [GNOME Human Interface Guidelines](http://library.gnome.org/devel/hig-book/stable/).
|
||||
*/
|
||||
typedef enum
|
||||
{
|
||||
|
Loading…
Reference in New Issue
Block a user