From 1edeb4a7c699d11cd6071362c4357f7d86764381 Mon Sep 17 00:00:00 2001 From: Stefan Schmidt Date: Fri, 4 Nov 2016 09:47:27 +0100 Subject: [PATCH] docs: elm_code: add missing documentation for elm code widget --- src/lib/elementary/elm_code_widget.eo | 76 +++++++++++++++------------ 1 file changed, 43 insertions(+), 33 deletions(-) diff --git a/src/lib/elementary/elm_code_widget.eo b/src/lib/elementary/elm_code_widget.eo index 08d09bb44b..9589dc3ac1 100644 --- a/src/lib/elementary/elm_code_widget.eo +++ b/src/lib/elementary/elm_code_widget.eo @@ -8,6 +8,7 @@ struct @extern Elm_Code_Line; [[Elementary code line data structure]] /* Parts o class Elm.Code_Widget (Elm.Layout, Elm.Interface.Atspi.Text) { + [[Elementary code widget]] eo_prefix: elm_obj_code_widget; legacy_prefix: elm_code_widget; methods { @@ -156,7 +157,7 @@ class Elm.Code_Widget (Elm.Layout, Elm.Interface.Atspi.Text) [[Get whether or not space characters will be inserted instead of tabs.]] } values { - tab_inserts_spaces: bool; [[EINA_TRUE if we should insert space characters instead of a tab when the Tab key is pressed]] + tab_inserts_spaces: bool; [[$true if we should insert space characters instead of a tab when the Tab key is pressed]] } } @property cursor_position { @@ -172,74 +173,84 @@ class Elm.Code_Widget (Elm.Layout, Elm.Interface.Atspi.Text) } } line_refresh { + [[Refresh code line in widget]] params { line: Elm_Code_Line *; [[The line to refresh.]] } } line_visible_get { + [[Check if the code line is currently visible]] params { line: Elm_Code_Line *; [[The line to test for visibility.]] } - return: bool; [[true if the line specified is currently visible within the scroll region.]] + return: bool; [[$true if the line specified is currently visible within the scroll region.]] } lines_visible_get { + [[Get the number of code lines currently visible in the widget]] return: uint; [[the number of lines currently visible in the widget.]] } position_at_coordinates_get { - [[get the row, col position for a given coordinate on the widget.]] + [[Get the row, col position for a given coordinate on the widget.]] params { - x: Evas.Coord; [[the x coordinate in the widget]] - y: Evas.Coord; [[the y coordinate in the widget]] - row: uint *; [[the row for the coordinates]] - col: int *; [[the column for the coordinates]] + x: Evas.Coord; [[The x coordinate in the widget]] + y: Evas.Coord; [[The y coordinate in the widget]] + row: uint *; [[The row for the coordinates]] + col: int *; [[The column for the coordinates]] } - return: bool; [[true if a line exists at these coordinates]] + return: bool; [[$true if a line exists at these coordinates]] } - //text functions text_left_gutter_width_get { - return: int; [[the current column width of the gutter for the widget.]] + [[Get the column width of the gutter]] + return: int; [[The current column width of the gutter for the widget.]] } text_line_number_width_get { - return: int; [[the column width required to represent the number of lines in the widget.]] + [[Get the required column width]] + return: int; [[The column width required to represent the number of lines in the widget.]] } text_between_positions_get { + [[Get text between given positions]] params { - start_col: uint; [[the widget column of the first character to get]] - start_line: uint; [[the line of the first character to get]] - end_col: uint; [[the widget column of the last character to get]] - end_line: uint; [[the line of the last character to get]] + start_col: uint; [[The widget column of the first character to get]] + start_line: uint; [[The line of the first character to get]] + end_col: uint; [[The widget column of the last character to get]] + end_line: uint; [[The line of the last character to get]] } - return: char *; [[the text content between start and end positions]] + return: char *; [[The text content between start and end positions]] } line_text_column_width_to_position { + [[Get text column width at given position]] params { - line: Elm_Code_Line *; - position: uint; + line: Elm_Code_Line *; [[Code line]] + position: uint; [[Code position]] } - return: uint; + return: uint; [[Text column width]] } line_text_column_width_get { + [[Get text column width for code line]] params { - line: Elm_Code_Line *; + line: Elm_Code_Line *; [[Code line]] } - return: uint; + return: uint; [[Text column width]] } line_text_position_for_column_get { + [[Get position from column]] params { - line: Elm_Code_Line *; - column: uint; + line: Elm_Code_Line *; [[Code line]] + column: uint; [[Column]] } - return: uint; + return: uint; [[Position]] } text_tabwidth_at_column_get { + [[Get tabwidth for column]] params { - column: uint; + column: uint; [[Column]] } - return: uint; + return: uint; [[Tabwidth]] } undo { + [[Undo last action]] } } implements { @@ -255,12 +266,11 @@ class Elm.Code_Widget (Elm.Layout, Elm.Interface.Atspi.Text) .code; } events { - line,clicked; - line,gutter,clicked; - cursor,changed; - changed,user; - selection,changed; - selection,cleared; + line,clicked; [[Called when text line was clicked]] + line,gutter,clicked; [[Called when gutter was clicked]] + cursor,changed; [[Called when cursor changed]] + changed,user; [[Called when object changed due to user interaction]] + selection,changed; [[Called when selection changed]] + selection,cleared; [[Called when selection was cleared]] } - }