1 /**************************************************************************/ 2 /* */ 3 /* Copyright (c) Microsoft Corporation. All rights reserved. */ 4 /* */ 5 /* This software is licensed under the Microsoft Software License */ 6 /* Terms for Microsoft Azure RTOS. Full text of the license can be */ 7 /* found in the LICENSE file at https://aka.ms/AzureRTOS_EULA */ 8 /* and in the root directory of this software. */ 9 /* */ 10 /**************************************************************************/ 11 12 13 /**************************************************************************/ 14 /**************************************************************************/ 15 /** */ 16 /** GUIX Component */ 17 /** */ 18 /** Horizontal List (List) */ 19 /** */ 20 /**************************************************************************/ 21 22 #define GX_SOURCE_CODE 23 24 25 /* Include necessary system files. */ 26 27 #include "gx_api.h" 28 #include "gx_widget.h" 29 #include "gx_window.h" 30 #include "gx_system.h" 31 #include "gx_scrollbar.h" 32 33 /**************************************************************************/ 34 /* */ 35 /* FUNCTION RELEASE */ 36 /* */ 37 /* _gx_horizontal_list_page_index_set PORTABLE C */ 38 /* 6.1 */ 39 /* AUTHOR */ 40 /* */ 41 /* Kenneth Maxwell, Microsoft Corporation */ 42 /* */ 43 /* DESCRIPTION */ 44 /* */ 45 /* This service sets the index of first list item */ 46 /* */ 47 /* INPUT */ 48 /* */ 49 /* horizontal_list Horizontal list widget */ 50 /* control block */ 51 /* list_entry Pointer to new list entry */ 52 /* */ 53 /* OUTPUT */ 54 /* */ 55 /* status Completion status */ 56 /* */ 57 /* CALLS */ 58 /* */ 59 /* _gx_widget_event_generate Creates a new GX_EVENT */ 60 /* _gx_system_dirty_mark Mark the widget dirty */ 61 /* */ 62 /* CALLED BY */ 63 /* */ 64 /* _gx_horizontal_list_event_process */ 65 /* */ 66 /* RELEASE HISTORY */ 67 /* */ 68 /* DATE NAME DESCRIPTION */ 69 /* */ 70 /* 05-19-2020 Kenneth Maxwell Initial Version 6.0 */ 71 /* 09-30-2020 Kenneth Maxwell Modified comment(s), */ 72 /* resulting in version 6.1 */ 73 /* */ 74 /**************************************************************************/ _gx_horizontal_list_page_index_set(GX_HORIZONTAL_LIST * list,INT index)75UINT _gx_horizontal_list_page_index_set(GX_HORIZONTAL_LIST *list, INT index) 76 { 77 GX_WIDGET *child; 78 GX_SCROLLBAR *pScroll; 79 INT scroll_value; 80 81 if ((list -> gx_horizontal_list_total_columns > 0) && 82 ((index <= list -> gx_horizontal_list_total_columns - list -> gx_horizontal_list_visible_columns) || (list -> gx_widget_style & GX_STYLE_WRAP))) 83 { 84 child = _gx_widget_first_client_child_get((GX_WIDGET *)list); 85 86 if (child) 87 { 88 /* Calculate scroll value. */ 89 scroll_value = child -> gx_widget_size.gx_rectangle_left; 90 scroll_value += (index - list -> gx_horizontal_list_top_index) * list -> gx_horizontal_list_child_width; 91 scroll_value = list -> gx_window_client.gx_rectangle_left - scroll_value; 92 93 /* Scroll to make index as the first visible entry. */ 94 _gx_horizontal_list_scroll(list, scroll_value); 95 96 _gx_window_scrollbar_find((GX_WINDOW *)list, GX_TYPE_HORIZONTAL_SCROLL, &pScroll); 97 98 if (pScroll) 99 { 100 _gx_scrollbar_reset(pScroll, GX_NULL); 101 } 102 } 103 } 104 105 return GX_SUCCESS; 106 } 107 108