}
</pre>
<h3>View</h3>
+<p>The following figure illustrates the application views:</p>
+<p class="figure">Figure: Files Sharing Server Screens</p>
+<p align="center"><img alt="" src="../images/files_sharing_server-help_text.png" border="1"/> <img alt="" src="../images/files_sharing_server_accept_button_enable.png" border="1"/> <img alt="" src="../images/files_sharing_server_received_list.png" border="1"/>
+
+<p>The view of the sample application is initialized by the controller module. It calls the <span style="font-family: Courier New,Courier,monospace">view_init()</span> function to initialize all view objects and data.</p>
+<pre class="prettyprint">
+view_data_t *view_init(void)
+{
+ view_data_t *vd = NULL;
+ vd = (view_data_t *)malloc(sizeof(view_data_t));
+ if (!vd)
+ /*Error handling.*/
+
+ /*Create window, conformant and layout. Code for that objects are generated by the SDK.*/
+ /*...*/
+
+ if (!__view_create_files_list(vd))
+ /*Error handling.*/
+
+ if (!__view_init_buttons(vd))
+ /*Error handling.*/
+
+ /*Show help text and disable buttons.*/
+ view_show_help(vd);
+ view_disable_accept_button(vd);
+ view_disable_reject_button(vd);
+ evas_object_show(vd->win);
+ return vd;
+}
+</pre>
+<p>The most important part of the view is the received files list. It shows all files obtained by the Bluetooth OPP protocol as well as the current status of the files transfer. To add a new file to the list, <span style="font-family: Courier New,Courier,monospace">view_append_new_file()</span> function is used.</p>
+
+<pre class="prettyprint">
+Elm_Object_Item *view_append_new_file(view_data_t *vd, const char *file_name, int *progress)
+{
+ struct _list_data_s *list_data_s = NULL;
+ Elm_Object_Item *new_item = NULL;
+
+ if (!vd || !file_name || !progress)
+ /*Error handling.*/
+
+ list_data_s = (struct _list_data_s *)malloc(sizeof(struct _list_data_s));
+ if (!list_data_s)
+ /*Error handling.*/
+
+ /*List_data_s structure is used to pass one more parameter to the genlist item creation callback.*/
+ list_data_s->file_name = file_name;
+ list_data_s->progress = progress;
+
+ /*Use elm_gengrid API to add a new file.*/
+ new_item = elm_genlist_item_append(vd->files_list, vd->gic,
+ (void *)list_data_s, NULL, ELM_GENLIST_ITEM_NONE, NULL, NULL);
+
+ if (!new_item)
+ /*Error handling.*/
+ return new_item;
+}
+</pre>
+
+<p>The function described above calls <span style="font-family: Courier New,Courier,monospace">elm_genlist_item_append()</span> function, which uses a callback from the genlist constructor to create the item's <span style="font-family: Courier New,Courier,monospace">Evas_Object</span>. Callback presented below creates the item's content.</p>
+
+<pre class="prettyprint">
+static Evas_Object *__view_set_file_item_content_cb(void *data, Evas_Object *obj, const char *part)
+{
+ if (!strncmp(part, FILE_LIST_ITEM_CONTENT, strlen(part)) &&
+ strlen(part) == strlen(FILE_LIST_ITEM_CONTENT))
+ return __view_create_file_list_item(obj, data);
+
+ return NULL;
+}
+</pre>
+
+
+<pre class="prettyprint">
+static Evas_Object *__view_create_file_list_item(Evas_Object *parent, struct _list_data_s *list_data_s)
+{
+ Evas_Object *item_ly = NULL;
+ Evas_Object *progressbar = NULL;
+ char edj_path[PATH_MAX] = {0, };
+ char buf[64] = {0, };
+
+ if (!parent || !list_data_s || !list_data_s->file_name || !list_data_s->progress)
+ /*Error handling.*/
+
+ /*Create item layout*/
+ item_ly = elm_layout_add(parent);
+ if (!item_ly)
+ /*Error handling.*/
+
+ /*Get the path to the EDJE layout*/
+ app_utils_get_resource(EDJ_FILE, edj_path, (int)PATH_MAX);
+
+ /*Create progressbar widget*/
+ progressbar = elm_progressbar_add(parent);
+ if (!progressbar)
+ /*Error handling.*/
+
+ /*Set initial values.*/
+ elm_progressbar_value_set(progressbar, (double)(*(list_data_s->progress)) / 100.0);
+ evas_object_size_hint_weight_set(progressbar, EVAS_HINT_EXPAND, EVAS_HINT_EXPAND);
+
+ /*Show the file name and the sending progress*/
+ elm_object_part_text_set(item_ly, PART_ITEM_TITLE, list_data_s->file_name);
+ snprintf(buf, sizeof(buf), "%d %%", *(list_data_s->progress));
+ elm_object_part_text_set(item_ly, PART_ITEM_PROGRESS, buf);
+
+ elm_object_part_content_set(item_ly, PART_ITEM_CONTENT, progressbar);
+ evas_object_show(item_ly);
+ return item_ly;
+}
+</pre>
+
+<p>Each item consists of an <span style="font-family: Courier New,Courier,monospace">elm_progressbar</span> widget, file name and progress text. To update mentioned content, <span style="font-family: Courier New,Courier,monospace">view_update_progress()</span> function is used.</p>
+
+<pre class="prettyprint">
+void view_update_progress(Elm_Object_Item *it, double progress)
+{
+ Evas_Object *item_ly = NULL;
+ Evas_Object *progressbar = NULL;
+ char buf[64] = {0, };
+
+ if (!it)
+ /*Erorr handling.*/
+
+ item_ly = elm_object_item_part_content_get(it, FILE_LIST_ITEM_CONTENT);
+ if (!item_ly) /*It is not an error. If the item_ly == NULL it means that it is not visible in the genlist so it should not be updated.*/
+ return;
+
+ /*Get the reference to the elm_progressbar widget.*/
+ progressbar = elm_object_part_content_get(item_ly, PART_ITEM_CONTENT);
+ /*Save the progress in the buffer.*/
+ snprintf(buf, sizeof(buf), "%d %%", (int) (progress * 100));
+ /*Update progress text*/
+ elm_object_part_text_set(item_ly, PART_ITEM_PROGRESS, buf);
+ /*Update progressbar value*/
+ elm_progressbar_value_set(progressbar, progress);
+}
+</pre>
+<p>File list items are deleted automatically by the <span style="font-family: Courier New,Courier,monospace">elm_genlist</span> API when application is terminated. Delete function is also called during the list scroll when items are not longer visible. In both cases additional data must be released.</p>
+
+<pre class="prettyprint">
+static void __view_del_file_item_cb(void *data, Evas_Object *obj)
+{
+ struct _list_data_s *list_data_s = (struct _list_data_s *)data;
+ if (!list_data_s)
+ /*Error handling*/
+
+ free(list_data_s);
+}
+</pre>
+
<h3>Model</h3>
projects / sdk / online-doc.git / commitdiff
