MTK

开发平台：
C/C++

gui_tab_bars.h：源码内容
							/*****************************************************************************
*  Copyright Statement:
*  --------------------
*  This software is protected by Copyright and the information contained
*  herein is confidential. The software may not be copied and the information
*  contained herein may not be used or disclosed except with the written
*  permission of MediaTek Inc. (C) 2005
*
*  BY OPENING THIS FILE, BUYER HEREBY UNEQUIVOCALLY ACKNOWLEDGES AND AGREES
*  THAT THE SOFTWARE/FIRMWARE AND ITS DOCUMENTATIONS ("MEDIATEK SOFTWARE")
*  RECEIVED FROM MEDIATEK AND/OR ITS REPRESENTATIVES ARE PROVIDED TO BUYER ON
*  AN "AS-IS" BASIS ONLY. MEDIATEK EXPRESSLY DISCLAIMS ANY AND ALL WARRANTIES,
*  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF
*  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT.
*  NEITHER DOES MEDIATEK PROVIDE ANY WARRANTY WHATSOEVER WITH RESPECT TO THE
*  SOFTWARE OF ANY THIRD PARTY WHICH MAY BE USED BY, INCORPORATED IN, OR
*  SUPPLIED WITH THE MEDIATEK SOFTWARE, AND BUYER AGREES TO LOOK ONLY TO SUCH
*  THIRD PARTY FOR ANY WARRANTY CLAIM RELATING THERETO. MEDIATEK SHALL ALSO
*  NOT BE RESPONSIBLE FOR ANY MEDIATEK SOFTWARE RELEASES MADE TO BUYER'S
*  SPECIFICATION OR TO CONFORM TO A PARTICULAR STANDARD OR OPEN FORUM.
*
*  BUYER'S SOLE AND EXCLUSIVE REMEDY AND MEDIATEK'S ENTIRE AND CUMULATIVE
*  LIABILITY WITH RESPECT TO THE MEDIATEK SOFTWARE RELEASED HEREUNDER WILL BE,
*  AT MEDIATEK'S OPTION, TO REVISE OR REPLACE THE MEDIATEK SOFTWARE AT ISSUE,
*  OR REFUND ANY SOFTWARE LICENSE FEES OR SERVICE CHARGE PAID BY BUYER TO
*  MEDIATEK FOR SUCH MEDIATEK SOFTWARE AT ISSUE. 
*
*  THE TRANSACTION CONTEMPLATED HEREUNDER SHALL BE CONSTRUED IN ACCORDANCE
*  WITH THE LAWS OF THE STATE OF CALIFORNIA, USA, EXCLUDING ITS CONFLICT OF
*  LAWS PRINCIPLES.  ANY DISPUTES, CONTROVERSIES OR CLAIMS ARISING THEREOF AND
*  RELATED THERETO SHALL BE SETTLED BY ARBITRATION IN SAN FRANCISCO, CA, UNDER
*  THE RULES OF THE INTERNATIONAL CHAMBER OF COMMERCE (ICC).
*
*****************************************************************************/
/*******************************************************************************
 * Filename:
 * ---------
 *   gui_tab_bars.h
 *
 * Project:
 * --------
 *   MAUI
 *
 * Description:
 * ------------
 *   Tab Bar - UI component
 *
 * Author:
 * -------
 * -------
 *
 *==============================================================================
 *             HISTORY
 * Below this line, this part is controlled by PVCS VM. DO NOT MODIFY!! 
 *------------------------------------------------------------------------------
 * removed!
 *
 *------------------------------------------------------------------------------
 * Upper this line, this part is controlled by PVCS VM. DO NOT MODIFY!! 
 *==============================================================================
 *******************************************************************************/
#ifndef _GUI_TAB_BARS_H
#define _GUI_TAB_BARS_H
#include "gui.h"
#include "gui_theme_struct.h"
#include "gui_buttons.h"
#ifdef __MMI_TOUCH_SCREEN__
#include "kal_non_specific_general_types.h"
#include "TouchScreenGprot.h"
#endif /* __MMI_TOUCH_SCREEN__ */ 
/***************************************************************************** 
* Define
*****************************************************************************/
/* Flags of tab_bar_item_type.flags */
#define UI_TAB_BAR_ITEM_STATE_NORMAL         0x00000000
#define UI_TAB_BAR_ITEM_STATE_BLINKING       0x00000001
/* Flags of horizontal_tab_bar.flags */
#define UI_TAB_BAR_DISABLE_DRAW                       0x00000001
#define UI_TAB_BAR_LOOP                               0x00000002
#define UI_TAB_BAR_BLINKING_DISPLAYED                 0x00000004
/* Disable pen control on tab bars in certain cases */
#define UI_TAB_BAR_DISABLE_PEN                        0x00000008
/***************************************************************************** 
* Typedef 
*****************************************************************************/
typedef struct _tab_bar_item_type
{
    PU8 icon;
    UI_string_type text;
    U32 flags;
} tab_bar_item_type;
#ifdef __MMI_TOUCH_SCREEN__
typedef enum
{
    GUI_TAB_BAR_PEN_NONE,
    GUI_TAB_BAR_PEN_NEED_REDRAW,
    GUI_TAB_BAR_PEN_JUMP_TO_I
} gui_tab_bar_pen_enum;
typedef struct
{
    S16 left_button_x, left_button_y;
    S16 left_button_width, left_button_height;
    S16 right_button_x, right_button_y;
    S16 right_button_width, right_button_height;
    S8 pen_down_left_button;
    S8 pen_down_right_button;
    /* focused item is changed between Pen Down and Pen Up */
    S8 focus_changed;
    S32 pen_down_tab_item_index;
} gui_tab_bar_pen_state_struct;
#endif /* __MMI_TOUCH_SCREEN__ */ 
typedef struct _horizontal_tab_bar
{
    S16 x, y;
    S16 width, height;
    U32 flags;
    UI_string_type hint;
    S8 n_items;
    S8 focused_item;
    tab_bar_item_type *items;
    /* first item displayed */
    S8 first_displayed_item;
    /* last item displayed */
    S8 last_displayed_item;
    /* the maximum number of tab items that can be displayed at the same time */
    S8 n_displayable_item;
    /* the number of tab items to display ahead when rotating the tab items. */
    S8 n_item_ahead;
    /* width of non-focused tab */
    S16 tab_width;
    S16 tab_height;
    /* width of focused tab */
    S16 focused_tab_width;
    S16 focused_tab_height;
    /* height of the tab area */
    S16 tab_area_height;
    /* height of the hint area */
    S16 hint_area_height;
    /* Left & right button */
    S8 left_button_pressed;
    S8 right_button_pressed;
    /* Icon/text position inside a tab item */
    S16 tab_icon_x, tab_icon_y; /* deprecated */
    S16 tab_text_x, tab_text_y, tab_text_width;
    UI_horizontal_tab_bar_theme *theme;
#ifdef __MMI_TOUCH_SCREEN__
    /* Used by gui_horizontal_tab_bar_translate_pen_event() */
    gui_tab_bar_pen_state_struct pen_state;
#endif /* __MMI_TOUCH_SCREEN__ */ 
} horizontal_tab_bar;
/***************************************************************************** 
* Extern Global Variable
*****************************************************************************/
extern UI_horizontal_tab_bar_theme *current_horizontal_tab_bar_theme;
/***************************************************************************** 
* Extern Global Function
*****************************************************************************/
/* Horizontal tab bar - Basic UI conponent interface */
extern void gui_set_horizontal_tab_bar_current_theme(horizontal_tab_bar *tb);
extern void gui_set_horizontal_tab_bar_theme(horizontal_tab_bar *tb, UI_horizontal_tab_bar_theme *t);
extern void gui_create_horizontal_tab_bar(
                horizontal_tab_bar *tb,
                S32 x,
                S32 y,
                S16 width,
                S16 tab_area_height,
                S16 hint_area_height,
                S16 tab_width,
                S16 focused_tab_width,
                UI_string_type hint,
                S8 n_item,
                S8 focused_item,
                tab_bar_item_type *items);
extern void gui_resize_horizontal_tab_bar(
                horizontal_tab_bar *tb,
                S16 width,
                S16 tab_area_height,
                S16 hint_area_height);
extern void gui_move_horizontal_tab_bar(horizontal_tab_bar *tb, S32 x, S32 y);
extern void gui_show_horizontal_tab_bar(horizontal_tab_bar *tb, BOOL disable_tab_area, BOOL disable_hint_area);
#ifdef __MMI_TOUCH_SCREEN__
extern BOOL gui_horizontal_tab_bar_translate_pen_event(
                horizontal_tab_bar *tb,
                mmi_pen_event_type_enum pen_event,
                S16 x,
                S16 y,
                gui_tab_bar_pen_enum *tab_event,
                gui_pen_event_param_struct *tab_event_param);
#endif /* __MMI_TOUCH_SCREEN__ */ 
/* Horizontal tab bar - Attributes */
extern void gui_horizontal_tab_bar_set_icon_position(horizontal_tab_bar *tb, S16 x, S16 y);
extern void gui_horizontal_tab_bar_set_text_position(horizontal_tab_bar *tb, S16 x, S16 y, S16 width);
extern void gui_horizontal_tab_bar_set_blinking(horizontal_tab_bar *tb, S8 index);
extern void gui_horizontal_tab_bar_unset_blinking(horizontal_tab_bar *tb, S8 index);
extern BOOL gui_set_horizontal_tab_bar_display_range(horizontal_tab_bar *tb, S32 first_displayed_item);
/* Horizontal tab bar - Navigation */
extern void gui_horizontal_tab_bar_focus_item(horizontal_tab_bar *tb, S8 index);
extern void gui_horizontal_tab_bar_focus_next_item(horizontal_tab_bar *tb);
extern void gui_horizontal_tab_bar_focus_prev_item(horizontal_tab_bar *tb);
extern void gui_horizontal_tab_bar_focus_first_item(horizontal_tab_bar *tb);
extern void gui_horizontal_tab_bar_focus_last_item(horizontal_tab_bar *tb);
extern BOOL gui_horizontal_tab_bar_is_item_displayed(horizontal_tab_bar *tb, int index);
/* Horizontal tab bar - Blinking */
extern void gui_horizontal_tab_bar_start_blinking(horizontal_tab_bar *tb);
extern void gui_horizontal_tab_bar_stop_blinking(horizontal_tab_bar *tb);
/* Tab item */
extern void gui_setup_tab_item(tab_bar_item_type *item, PU8 icon, UI_string_type text, MMI_BOOL enable_blinking);
#endif /* _GUI_TAB_BARS_H */ 

						