X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=cspi%2Fspi_editabletext.c;h=ff32c304a355b225e8bea15871f0871ddd19a9f5;hb=a90cc5cacb5efd233b714287297034c079def8aa;hp=fdf8f25795fab92fbf63132aad94b93478ac0f67;hpb=408978dd34f3338e49b6ace5f60b7606579ce7a9;p=platform%2Fcore%2Fuifw%2Fat-spi2-atk.git diff --git a/cspi/spi_editabletext.c b/cspi/spi_editabletext.c index fdf8f25..ff32c30 100644 --- a/cspi/spi_editabletext.c +++ b/cspi/spi_editabletext.c @@ -1,95 +1,248 @@ -int -SpiAccessibleEditableText_ref (SpiAccessibleEditableText *obj) +#include + +/** + * AccessibleEditableText_ref: + * @obj: a pointer to the #AccessibleEditableText object on which to operate. + * + * Increment the reference count for an #AccessibleEditableText object. + * Since AccessibleEditableText is derived from AccessibleText, + * this is the same as AccessibleText_ref(). + **/ +void +AccessibleEditableText_ref (AccessibleEditableText *obj) { - Accessibility_SpiEditableText_ref (*obj, &ev); - return 0; + cspi_object_ref (obj); } - - -int -SpiAccessibleEditableText_unref (SpiAccessibleEditableText *obj) +/** + * AccessibleEditableText_unref: + * @obj: a pointer to the #AccessibleEditableText object on which to operate. + * + * Decrement the reference count for an #AccessibleEdiitableText object. + * Since AccessibleEditableText is derived from AccessibleText, + * this is the same as AccessibleText_unref(). + **/ +void +AccessibleEditableText_unref (AccessibleEditableText *obj) { - Accessibility_SpiEditableText_unref (*obj, &ev); - return 0; + cspi_object_unref (obj); } +/** + * AccessibleEditableText_setAttributes: + * @obj: a pointer to the #AccessibleEditableText object to modify. + * @attributes: a character string indicating the attributes to apply to the range, + * delimited by ':'. + * @startOffset: a #long indicating the start of the desired text range. + * @endOffset: a #long indicating the first character past the desired range. + * + * Set the attributes applied to a range of text from an #AccessibleEditableText + * object, and the bounds of the range. + * + * Returns: #TRUE if the operation was successful, otherwise #FALSE. + **/ +SPIBoolean +AccessibleEditableText_setAttributes (AccessibleEditableText *obj, + const char *attributes, + long int startPos, + long int endPos) +{ + SPIBoolean retval; + cspi_return_val_if_fail (obj != NULL, FALSE); -boolean -SpiAccessibleEditableText_setAttributes (SpiAccessibleEditableText *obj, - const char *attributes, - long startPos, long endPos) -{ - return (boolean) - Accessibility_SpiEditableText_setAttributes (*obj, - (CORBA_char *) attributes, - (CORBA_long) startPos, (CORBA_long) endPos, &ev); -} + retval = + Accessibility_EditableText_setAttributes (CSPI_OBJREF (obj), + (CORBA_char *) attributes, + (CORBA_long) startPos, + (CORBA_long) endPos, cspi_ev ()); + cspi_return_val_if_ev ("setAttributes", FALSE); + return retval; +} -void -SpiAccessibleEditableText_setTextContents (SpiAccessibleEditableText *obj, +/** + * AccessibleEditableText_setTextContents: + * @obj: a pointer to the #AccessibleEditableText object to modify. + * @newContents: a character string, encoded in UTF-8, which is to + * become the new text contents of the #AccessibleEditableText object. + * + * Replace the entire text contents of an #AccessibleEditableText object. + * + * Returns: #TRUE if the operation was successful, otherwise #FALSE. + **/ +SPIBoolean +AccessibleEditableText_setTextContents (AccessibleEditableText *obj, const char *newContents) { - Accessibility_SpiEditableText_setTextContents (*obj, - (CORBA_char *) newContents, &ev); -} + SPIBoolean retval; + cspi_return_val_if_fail (obj != NULL, FALSE); + retval = Accessibility_EditableText_setTextContents (CSPI_OBJREF (obj), + (CORBA_char *) newContents, cspi_ev ()); -void -SpiAccessibleEditableText_insertText (SpiAccessibleEditableText *obj, - long position, - char *text, - long length) -{ - Accessibility_SpiEditableText_insertText (*obj, - (CORBA_long) position, (CORBA_char *) text, - (CORBA_long) length, &ev); + cspi_return_val_if_ev ("setTextContents", FALSE); + + return retval; } +/** + * AccessibleEditableText_insertText: + * @obj: a pointer to the #AccessibleEditableText object to modify. + * @position: an integer indicating the character offset at which to insert + * the new text. + * @text: a char* pointer to the text to insert, in UTF-8 encoding. + * @length: (frankly I'm not sure this parameter should be here) + * + * Insert text into an #AccessibleEditableText object. + * As with all character offsets, the specified @position may not be the + * same as the resulting byte offset, since the text is in a + * variable-width encoding. + * + * Returns: #TRUE if the operation was successful, otherwise #FALSE. + **/ +SPIBoolean +AccessibleEditableText_insertText (AccessibleEditableText *obj, + long int position, + const char *text, + long int length) +{ + SPIBoolean retval; + cspi_return_val_if_fail (obj != NULL, FALSE); -void -SpiAccessibleEditableText_copySpiText (SpiAccessibleText *obj, - long startPos, - long endPos) -{ - Accessibility_SpiEditableText_copySpiText (*obj, - (CORBA_long) startPos, (CORBA_long) endPos, &ev); -} + retval = Accessibility_EditableText_insertText (CSPI_OBJREF (obj), + (CORBA_long) position, (const CORBA_char *) text, + (CORBA_long) length, cspi_ev ()); + cspi_return_val_if_ev ("insertText", FALSE); + return retval; +} -void -SpiAccessibleEditableText_cutText (SpiAccessibleEditableText *obj, - long startPos, - long endPos) +/** + * AccessibleEditableText_copyText: + * @obj: a pointer to the #AccessibleEditableText object to modify. + * @startPos: an integer indicating the starting character offset + * of the text to copy. + * @endPos: an integer indicating the offset of the first character + * past the end of the text section to be copied. + * + * Copy text from an #AccessibleEditableText object into the clipboard. + * + * @see: AccessibleEditableText_pasteText + * + * Returns: #TRUE if the operation was successful, otherwise #FALSE. + **/ +SPIBoolean +AccessibleEditableText_copyText (AccessibleText *obj, + long int startPos, + long int endPos) { - Accessibility_SpiEditableText_cutText (*obj, - (CORBA_long) startPos, (CORBA_long) endPos, &ev); + cspi_return_val_if_fail (obj != NULL, FALSE); + + Accessibility_EditableText_copyText ( + CSPI_OBJREF (obj), (CORBA_long) startPos, + (CORBA_long) endPos, cspi_ev ()); + + cspi_return_val_if_ev ("copyText", FALSE); + + return TRUE; } +/** + * AccessibleEditableText_cutText: + * @obj: a pointer to the #AccessibleEditableText object to modify. + * @startPos: an integer indicating the starting character offset + * of the text to cut. + * @endPos: an integer indicating the offset of the first character + * past the end of the text section to be cut. + * + * Delete text from an #AccessibleEditableText object, copying the + * excised portion into the clipboard. + * + * @see: AccessibleEditableText_pasteText + * + * Returns: #TRUE if operation was successful, #FALSE otherwise. + **/ +SPIBoolean +AccessibleEditableText_cutText (AccessibleEditableText *obj, + long int startPos, + long int endPos) +{ + SPIBoolean retval; + cspi_return_val_if_fail (obj != NULL, FALSE); -void -SpiAccessibleEditableText_deleteText (SpiAccessibleEditableText *obj, + retval = Accessibility_EditableText_cutText ( + CSPI_OBJREF (obj), + (CORBA_long) startPos, (CORBA_long) endPos, cspi_ev ()); + + cspi_return_val_if_ev ("cutText", FALSE); + + return retval; +} + +/** + * AccessibleEditableText_deleteText: + * @obj: a pointer to the #AccessibleEditableText object to modify. + * @startPos: an integer indicating the starting character offset + * of the text to delete. + * @endPos: an integer indicating the offset of the first character + * past the end of the text section to be deleted. + * + * Delete text from an #AccessibleEditableText object, without copying the + * excised portion into the clipboard. + * + * @see: AccessibleEditableText_cutText + * + * Returns: #TRUE if the operation was successful, otherwise #FALSE. + **/ +SPIBoolean +AccessibleEditableText_deleteText (AccessibleEditableText *obj, long startPos, long endPos) { - Accessibility_SpiEditableText_deleteText (*obj, - (CORBA_long) startPos, (CORBA_long) endPos, &ev); -} + SPIBoolean retval; + cspi_return_val_if_fail (obj != NULL, FALSE); + retval = Accessibility_EditableText_deleteText ( + CSPI_OBJREF (obj), + (CORBA_long) startPos, (CORBA_long) endPos, cspi_ev ()); -void -SpiAccessibleEditableText_pasteText (SpiAccessibleEditableText *obj, - long position) -{ - Accessibility_SpiEditableText_pasteText (*obj, - (CORBA_long) position, &ev); + cspi_return_val_if_ev ("deleteText", FALSE); + + return retval; } +/** + * AccessibleEditableText_pasteText: + * @obj: a pointer to the #AccessibleEditableText object to modify. + * @position: an integer indicating the character offset at which to insert + * the new text. + * + * Insert text from the clipboard into an #AccessibleEditableText object. + * As with all character offsets, the specified @position may not be the + * same as the resulting byte offset, since the text is in a + * variable-width encoding. + * + * Returns: #TRUE if the operation was successful, otherwise #FALSE. + **/ +SPIBoolean +AccessibleEditableText_pasteText (AccessibleEditableText *obj, + long int position) +{ + SPIBoolean retval; + + cspi_return_val_if_fail (obj != NULL, FALSE); + + retval = Accessibility_EditableText_pasteText ( + CSPI_OBJREF (obj), (CORBA_long) position, cspi_ev ()); + + cspi_return_val_if_ev ("pasteText", FALSE); + + return retval; +}