2008-12-11 06:12:48 -05:00
|
|
|
/*
|
|
|
|
* Clutter.
|
|
|
|
*
|
|
|
|
* An OpenGL based 'interactive canvas' library.
|
|
|
|
*
|
2008-12-11 06:40:55 -05:00
|
|
|
* Copyright (C) 2008 Intel Corporation.
|
2008-12-11 06:12:48 -05:00
|
|
|
*
|
2008-12-11 06:40:55 -05:00
|
|
|
* Authored By: Øyvind Kolås <pippin@o-hand.com>
|
|
|
|
* Emmanuele Bassi <ebassi@linux.intel.com>
|
2008-12-11 06:12:48 -05:00
|
|
|
*
|
|
|
|
* This library is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
|
|
* License as published by the Free Software Foundation; either
|
|
|
|
* version 2 of the License, or (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This library is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
* Lesser General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Lesser General Public
|
2008-12-11 06:20:14 -05:00
|
|
|
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
|
2008-12-11 06:12:48 -05:00
|
|
|
*/
|
|
|
|
|
2008-12-11 06:20:14 -05:00
|
|
|
#if !defined(__CLUTTER_H_INSIDE__) && !defined(CLUTTER_COMPILATION)
|
|
|
|
#error "Only <clutter/clutter.h> can be included directly."
|
|
|
|
#endif
|
|
|
|
|
2008-12-11 06:12:48 -05:00
|
|
|
#ifndef __CLUTTER_TEXT_H__
|
|
|
|
#define __CLUTTER_TEXT_H__
|
|
|
|
|
2008-12-11 06:40:55 -05:00
|
|
|
#include <clutter/clutter-actor.h>
|
2011-06-15 05:06:31 -04:00
|
|
|
#include <clutter/clutter-text-buffer.h>
|
2008-12-11 06:40:55 -05:00
|
|
|
#include <pango/pango.h>
|
2008-12-11 06:12:48 -05:00
|
|
|
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
|
2008-12-11 06:20:14 -05:00
|
|
|
#define CLUTTER_TYPE_TEXT (clutter_text_get_type ())
|
|
|
|
#define CLUTTER_TEXT(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), CLUTTER_TYPE_TEXT, ClutterText))
|
|
|
|
#define CLUTTER_TEXT_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), CLUTTER_TYPE_TEXT, ClutterTextClass))
|
|
|
|
#define CLUTTER_IS_TEXT(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), CLUTTER_TYPE_TEXT))
|
|
|
|
#define CLUTTER_IS_TEXT_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), CLUTTER_TYPE_TEXT))
|
|
|
|
#define CLUTTER_TEXT_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), CLUTTER_TYPE_TEXT, ClutterTextClass))
|
2008-12-11 06:12:48 -05:00
|
|
|
|
|
|
|
typedef struct _ClutterText ClutterText;
|
|
|
|
typedef struct _ClutterTextPrivate ClutterTextPrivate;
|
|
|
|
typedef struct _ClutterTextClass ClutterTextClass;
|
|
|
|
|
2008-12-15 10:10:55 -05:00
|
|
|
/**
|
|
|
|
* ClutterText:
|
|
|
|
*
|
|
|
|
* The #ClutterText struct contains only private data.
|
|
|
|
*
|
|
|
|
* Since: 1.0
|
|
|
|
*/
|
2008-12-11 06:12:48 -05:00
|
|
|
struct _ClutterText
|
|
|
|
{
|
|
|
|
/*< private >*/
|
2008-12-11 06:21:39 -05:00
|
|
|
ClutterActor parent_instance;
|
|
|
|
|
2008-12-11 06:12:48 -05:00
|
|
|
ClutterTextPrivate *priv;
|
|
|
|
};
|
|
|
|
|
2008-12-15 10:10:55 -05:00
|
|
|
/**
|
|
|
|
* ClutterTextClass:
|
|
|
|
* @text_changed: class handler for the #ClutterText::text-changed signal
|
|
|
|
* @activate: class handler for the #ClutterText::activate signal
|
|
|
|
* @cursor_event: class handler for the #ClutterText::cursor_event signal
|
|
|
|
*
|
|
|
|
* The #ClutterTextClass struct contains only private data.
|
|
|
|
*
|
|
|
|
* Since: 1.0
|
|
|
|
*/
|
2008-12-11 06:12:48 -05:00
|
|
|
struct _ClutterTextClass
|
|
|
|
{
|
2008-12-11 06:40:55 -05:00
|
|
|
/*< private >*/
|
2008-12-11 06:21:39 -05:00
|
|
|
ClutterActorClass parent_class;
|
2008-12-11 06:12:48 -05:00
|
|
|
|
2008-12-11 06:40:55 -05:00
|
|
|
/*< public >*/
|
2008-12-15 13:23:25 -05:00
|
|
|
/* signals, not vfuncs */
|
|
|
|
void (* text_changed) (ClutterText *self);
|
|
|
|
void (* activate) (ClutterText *self);
|
|
|
|
void (* cursor_event) (ClutterText *self,
|
|
|
|
const ClutterGeometry *geometry);
|
2008-12-11 06:21:39 -05:00
|
|
|
|
2008-12-11 06:40:55 -05:00
|
|
|
/*< private >*/
|
|
|
|
/* padding for future expansion */
|
2008-12-11 06:21:39 -05:00
|
|
|
void (* _clutter_reserved1) (void);
|
|
|
|
void (* _clutter_reserved2) (void);
|
|
|
|
void (* _clutter_reserved3) (void);
|
|
|
|
void (* _clutter_reserved4) (void);
|
|
|
|
void (* _clutter_reserved5) (void);
|
|
|
|
void (* _clutter_reserved6) (void);
|
|
|
|
void (* _clutter_reserved7) (void);
|
|
|
|
void (* _clutter_reserved8) (void);
|
2008-12-11 06:12:48 -05:00
|
|
|
};
|
|
|
|
|
|
|
|
GType clutter_text_get_type (void) G_GNUC_CONST;
|
|
|
|
|
2009-01-07 06:46:22 -05:00
|
|
|
ClutterActor * clutter_text_new (void);
|
2010-02-03 09:35:45 -05:00
|
|
|
ClutterActor * clutter_text_new_full (const gchar *font_name,
|
|
|
|
const gchar *text,
|
|
|
|
const ClutterColor *color);
|
|
|
|
ClutterActor * clutter_text_new_with_text (const gchar *font_name,
|
|
|
|
const gchar *text);
|
2012-02-27 11:31:53 -05:00
|
|
|
CLUTTER_AVAILABLE_IN_1_10
|
2011-06-15 05:06:31 -04:00
|
|
|
ClutterActor * clutter_text_new_with_buffer (ClutterTextBuffer *buffer);
|
2012-02-27 11:31:53 -05:00
|
|
|
CLUTTER_AVAILABLE_IN_1_10
|
2011-06-15 05:06:31 -04:00
|
|
|
ClutterTextBuffer * clutter_text_get_buffer (ClutterText *self);
|
2012-02-27 11:31:53 -05:00
|
|
|
CLUTTER_AVAILABLE_IN_1_10
|
2011-06-15 05:06:31 -04:00
|
|
|
void clutter_text_set_buffer (ClutterText *self,
|
|
|
|
ClutterTextBuffer *buffer);
|
Eliminate G_CONST_RETURN
The G_CONST_RETURN define in GLib is, and has always been, a bit fuzzy.
We always used it to conform to the platform, at least for public-facing
API.
At first I assumed it has something to do with brain-damaged compilers
or with weird platforms where const was not really supported; sadly,
it's something much, much worse: it's a define that can be toggled at
compile-time to remove const from the signature of public API. This is a
truly terrifying feature that I assume was added in the past century,
and whose inception clearly had something to do with massive doses of
absynthe and opium — because any other explanation would make the
existence of such a feature even worse than assuming drugs had anything
to do with it.
Anyway, and pleasing the gods, this dubious feature is being
removed/deprecated in GLib; see bug:
https://bugzilla.gnome.org/show_bug.cgi?id=644611
Before deprecation, though, we should just remove its usage from the
whole API. We should especially remove its usage from Cally's internals,
since there it never made sense in the first place.
2011-06-07 10:49:20 -04:00
|
|
|
const gchar * clutter_text_get_text (ClutterText *self);
|
2010-02-03 09:35:45 -05:00
|
|
|
void clutter_text_set_text (ClutterText *self,
|
|
|
|
const gchar *text);
|
|
|
|
void clutter_text_set_markup (ClutterText *self,
|
|
|
|
const gchar *markup);
|
|
|
|
void clutter_text_set_color (ClutterText *self,
|
|
|
|
const ClutterColor *color);
|
|
|
|
void clutter_text_get_color (ClutterText *self,
|
|
|
|
ClutterColor *color);
|
|
|
|
void clutter_text_set_font_name (ClutterText *self,
|
|
|
|
const gchar *font_name);
|
Eliminate G_CONST_RETURN
The G_CONST_RETURN define in GLib is, and has always been, a bit fuzzy.
We always used it to conform to the platform, at least for public-facing
API.
At first I assumed it has something to do with brain-damaged compilers
or with weird platforms where const was not really supported; sadly,
it's something much, much worse: it's a define that can be toggled at
compile-time to remove const from the signature of public API. This is a
truly terrifying feature that I assume was added in the past century,
and whose inception clearly had something to do with massive doses of
absynthe and opium — because any other explanation would make the
existence of such a feature even worse than assuming drugs had anything
to do with it.
Anyway, and pleasing the gods, this dubious feature is being
removed/deprecated in GLib; see bug:
https://bugzilla.gnome.org/show_bug.cgi?id=644611
Before deprecation, though, we should just remove its usage from the
whole API. We should especially remove its usage from Cally's internals,
since there it never made sense in the first place.
2011-06-07 10:49:20 -04:00
|
|
|
const gchar * clutter_text_get_font_name (ClutterText *self);
|
2010-02-03 09:35:45 -05:00
|
|
|
void clutter_text_set_font_description (ClutterText *self,
|
|
|
|
PangoFontDescription *font_desc);
|
|
|
|
PangoFontDescription *clutter_text_get_font_description (ClutterText *self);
|
|
|
|
|
|
|
|
void clutter_text_set_ellipsize (ClutterText *self,
|
|
|
|
PangoEllipsizeMode mode);
|
|
|
|
PangoEllipsizeMode clutter_text_get_ellipsize (ClutterText *self);
|
|
|
|
void clutter_text_set_line_wrap (ClutterText *self,
|
|
|
|
gboolean line_wrap);
|
|
|
|
gboolean clutter_text_get_line_wrap (ClutterText *self);
|
|
|
|
void clutter_text_set_line_wrap_mode (ClutterText *self,
|
|
|
|
PangoWrapMode wrap_mode);
|
|
|
|
PangoWrapMode clutter_text_get_line_wrap_mode (ClutterText *self);
|
|
|
|
PangoLayout * clutter_text_get_layout (ClutterText *self);
|
|
|
|
void clutter_text_set_attributes (ClutterText *self,
|
|
|
|
PangoAttrList *attrs);
|
|
|
|
PangoAttrList * clutter_text_get_attributes (ClutterText *self);
|
|
|
|
void clutter_text_set_use_markup (ClutterText *self,
|
|
|
|
gboolean setting);
|
|
|
|
gboolean clutter_text_get_use_markup (ClutterText *self);
|
|
|
|
void clutter_text_set_line_alignment (ClutterText *self,
|
|
|
|
PangoAlignment alignment);
|
|
|
|
PangoAlignment clutter_text_get_line_alignment (ClutterText *self);
|
|
|
|
void clutter_text_set_justify (ClutterText *self,
|
|
|
|
gboolean justify);
|
|
|
|
gboolean clutter_text_get_justify (ClutterText *self);
|
|
|
|
|
|
|
|
void clutter_text_insert_unichar (ClutterText *self,
|
|
|
|
gunichar wc);
|
|
|
|
void clutter_text_delete_chars (ClutterText *self,
|
|
|
|
guint n_chars);
|
|
|
|
void clutter_text_insert_text (ClutterText *self,
|
|
|
|
const gchar *text,
|
|
|
|
gssize position);
|
|
|
|
void clutter_text_delete_text (ClutterText *self,
|
|
|
|
gssize start_pos,
|
|
|
|
gssize end_pos);
|
|
|
|
gchar * clutter_text_get_chars (ClutterText *self,
|
|
|
|
gssize start_pos,
|
|
|
|
gssize end_pos);
|
|
|
|
void clutter_text_set_editable (ClutterText *self,
|
|
|
|
gboolean editable);
|
|
|
|
gboolean clutter_text_get_editable (ClutterText *self);
|
|
|
|
void clutter_text_set_activatable (ClutterText *self,
|
|
|
|
gboolean activatable);
|
|
|
|
gboolean clutter_text_get_activatable (ClutterText *self);
|
|
|
|
|
|
|
|
gint clutter_text_get_cursor_position (ClutterText *self);
|
|
|
|
void clutter_text_set_cursor_position (ClutterText *self,
|
|
|
|
gint position);
|
|
|
|
void clutter_text_set_cursor_visible (ClutterText *self,
|
|
|
|
gboolean cursor_visible);
|
|
|
|
gboolean clutter_text_get_cursor_visible (ClutterText *self);
|
|
|
|
void clutter_text_set_cursor_color (ClutterText *self,
|
|
|
|
const ClutterColor *color);
|
|
|
|
void clutter_text_get_cursor_color (ClutterText *self,
|
|
|
|
ClutterColor *color);
|
|
|
|
void clutter_text_set_cursor_size (ClutterText *self,
|
|
|
|
gint size);
|
|
|
|
guint clutter_text_get_cursor_size (ClutterText *self);
|
|
|
|
void clutter_text_set_selectable (ClutterText *self,
|
|
|
|
gboolean selectable);
|
|
|
|
gboolean clutter_text_get_selectable (ClutterText *self);
|
|
|
|
void clutter_text_set_selection_bound (ClutterText *self,
|
|
|
|
gint selection_bound);
|
|
|
|
gint clutter_text_get_selection_bound (ClutterText *self);
|
|
|
|
void clutter_text_set_selection (ClutterText *self,
|
|
|
|
gssize start_pos,
|
|
|
|
gssize end_pos);
|
|
|
|
gchar * clutter_text_get_selection (ClutterText *self);
|
|
|
|
void clutter_text_set_selection_color (ClutterText *self,
|
|
|
|
const ClutterColor *color);
|
|
|
|
void clutter_text_get_selection_color (ClutterText *self,
|
|
|
|
ClutterColor *color);
|
|
|
|
gboolean clutter_text_delete_selection (ClutterText *self);
|
|
|
|
void clutter_text_set_password_char (ClutterText *self,
|
|
|
|
gunichar wc);
|
|
|
|
gunichar clutter_text_get_password_char (ClutterText *self);
|
|
|
|
void clutter_text_set_max_length (ClutterText *self,
|
|
|
|
gint max);
|
|
|
|
gint clutter_text_get_max_length (ClutterText *self);
|
|
|
|
void clutter_text_set_single_line_mode (ClutterText *self,
|
|
|
|
gboolean single_line);
|
|
|
|
gboolean clutter_text_get_single_line_mode (ClutterText *self);
|
|
|
|
|
2011-03-02 12:02:56 -05:00
|
|
|
void clutter_text_set_selected_text_color (ClutterText *self,
|
|
|
|
const ClutterColor *color);
|
|
|
|
void clutter_text_get_selected_text_color (ClutterText *self,
|
|
|
|
ClutterColor *color);
|
|
|
|
|
2010-02-03 09:35:45 -05:00
|
|
|
gboolean clutter_text_activate (ClutterText *self);
|
2012-02-27 11:31:53 -05:00
|
|
|
CLUTTER_AVAILABLE_IN_1_10
|
2012-02-06 13:23:21 -05:00
|
|
|
gint clutter_text_coords_to_position (ClutterText *self,
|
|
|
|
gfloat x,
|
|
|
|
gfloat y);
|
2010-02-03 09:35:45 -05:00
|
|
|
gboolean clutter_text_position_to_coords (ClutterText *self,
|
|
|
|
gint position,
|
|
|
|
gfloat *x,
|
|
|
|
gfloat *y,
|
|
|
|
gfloat *line_height);
|
|
|
|
|
|
|
|
void clutter_text_set_preedit_string (ClutterText *self,
|
|
|
|
const gchar *preedit_str,
|
|
|
|
PangoAttrList *preedit_attrs,
|
|
|
|
guint cursor_pos);
|
2009-09-09 07:15:23 -04:00
|
|
|
|
2011-02-04 06:33:53 -05:00
|
|
|
void clutter_text_get_layout_offsets (ClutterText *self,
|
|
|
|
gint *x,
|
|
|
|
gint *y);
|
|
|
|
|
2008-12-11 06:12:48 -05:00
|
|
|
G_END_DECLS
|
|
|
|
|
|
|
|
#endif /* __CLUTTER_TEXT_H__ */
|