FTK应用程序编程接口(API)手册-2

全局对象存取函数

FTK中有一些单实例的对象，这些对象是以全局变量的形式存在的，为了有效的控制对这些对象的访问，我们提供了相应的存/取函数。这些对象都是在FTK初始化时创建的，所以开发人员无需要再调用相应的“存”函数，但有时需要“取”出这些对象，以后 获得相应的信息。故这里只介绍“取”的函数：

1.获取缺省显示设备。
原型 ：FtkDisplay*       ftk_default_display(void);
说明 ：目前FTK只支持一个显示设备，本函数用于获取这个显示设备对象。对于普通开发人员来说，获取显示设备的主要目的，是通过FtkDisplay对象来获得显示设备的宽度和高度。
参数 ：无。
返回值 ：缺省的显示设备对象。
示例： 获取显示设备的宽度和高度

int screen_width = ftk_display_width(ftk_default_display()); int screen_height = ftk_display_height(ftk_default_display());

2.获取缺省的主循环对象。
原型 ：FtkMainLoop*      ftk_default_main_loop(void);
说明 ：这个函数主要是给FTK实现者使用的，普通开发人员不会用到。
参数 ：无。
返回值 ：缺省的主循环对象。

3.获取调试信息的输出级别。
原型 ：FtkLogLevel       ftk_default_log_level(void);
说明 ：log_level决定了FTK输出哪些调试信息，本函数用于返回当前的级别。调试信息的级别可以在配置文件中指定，也可以通过命令行参数传入。
参数 ：无。
返回值 ：见FtkLogLevel。

4.获取缺省的窗口管理器。
原型 ：FtkWndManager*    ftk_default_wnd_manager(void);
说明 ： 窗口管理器负责窗口的管理和事件的分发，可以通过窗口管理器可以向GUI注入事件，或者拦截事件。
参数 ：无。
返回值 ：缺省的窗口管理器
示例： 向FTK中注入按键事件。

ftk_event_init(&event, FTK_EVT_KEY_DOWN); event.u.key.code = code; ftk_wnd_manager_dispatch_event(ftk_default_wnd_manager(), &event); ftk_event_init(&event, FTK_EVT_KEY_UP); event.u.key.code = code; ftk_wnd_manager_dispatch_event(ftk_default_wnd_manager(), &event);

5.获取状态栏窗口。
原型 ：FtkWidget*        ftk_default_status_panel(void);
说明 ：状态栏窗口通常是显示在屏幕上方，用于显示当前窗口的标题或关闭按键等。开发人员通过本函数获取状态栏窗口，然后可以向状态栏窗口中增加自己的控件。
参数 ：无。
返回值 ：状态栏窗口。
示例： 桌面向状态栏中增加显示时间的控件。

static Ret desktop_add_time_item_on_statusbar(void) {     FtkWidget* item = NULL;     FtkWidget* panel = NULL;     panel = ftk_default_status_panel();     if(panel != NULL)     {        item = ftk_status_item_create(panel, -2, 60);        ftk_widget_set_id(item, IDC_TIME_ITEM);        ftk_widget_show(item, 1);     }     ftk_logd("%s\n", __func__);     return RET_OK; }

6.获取位图工厂。
原型 ：FtkBitmapFactory* ftk_default_bitmap_factory(void);
说明 ：位图工厂主要用于加载图片文件，通过本函数获取位图工厂，然后加载自己需要的图片。
参数 ：无。
返回值 ：位图工厂。
示例：

FtkBitmap* bitmap = NULL; char filename[FTK_MAX_PATH+1] = {0}; ftk_snprintf(filename, FTK_MAX_PATH, "%s/earth.png",        ftk_config_get_test_data_dir(ftk_default_config())); bitmap = ftk_bitmap_factory_load(ftk_default_bitmap_factory(), filename);

7.获取事件源管理器对象。
原型 ：FtkSourcesManager* ftk_default_sources_manager(void);
说明 ：这个函数主要是给FTK实现者使用的，普通开发人员不会用到。
参数 ：无。
返回值 ：事件源管理器对象。

8.获取共享画板对象。
原型 ：FtkCanvas*         ftk_shared_canvas(void);
说明 ：这个函数主要是给FTK实现者使用的，普通开发人员不会用到。
参数 ：无。
返回值 ：共享画板对象。

9.获取主题对象。
原型 ：FtkTheme*          ftk_default_theme(void);
说明 ：主题对象负责FTK的外在表现，换一个主题，FTK可能有完全不同的表现效果。通常开发人员可以利用主题对象来加载主题相关的图片，或者获取相关的配置信息。
参数 ：无。
返回值 ：主题对象。
示例 ：加载主题中的图片。

FtkBitmap* bitmap = ftk_theme_load_image(ftk_default_theme(), filename);

10.获取基本事件源。
原型 ：FtkSource*         ftk_primary_source(void);
说明 ：这个函数主要是给FTK实现者使用的，普通开发人员不会用到。
参数 ：无。
返回值 ：基本事件源。

11.获取配置信息对象。
原型 ：FtkConfig*         ftk_default_config(void);
说明 ：配置信息对象提供了一些函数用于获取系统的配置信息。
参数 ：无。
返回值 ：配置信息对象。

12.获取内存分配器。
原型 ：FtkAllocator*      ftk_default_allocator(void);
说明 ：一般不要直接使用这个对象，而且用FTK_ALLOC/FTK_ZALLOC/FTK_FREE等宏来管理内存。
参数 ：无。
返回值 ：内存分配器。

13.获取文本排版对象。
原型 ：FtkTextLayout*     ftk_default_text_layout(void);
说明 ：显示文本时可以利用FtkTextLayout对文字进行排版。
参数 ：无。
返回值 ：文本排版对象。
示例： button控件使用文本排版对象计算文字宽度。

static Ret ftk_button_on_paint(FtkWidget* thiz) {        FTK_BEGIN_PAINT(x, y, width, height, canvas);        ftk_canvas_reset_gc(canvas, ftk_widget_get_gc(thiz));        if(ftk_widget_get_text(thiz) != NULL)        {                int xoffset = 0;                int yoffset = FTK_HALF(height);                FtkTextLine line = {0};                const char* text = ftk_widget_get_text(thiz);                FtkTextLayout* text_layout = ftk_default_text_layout();                        ftk_text_layout_init(text_layout, text, -1, ftk_widget_get_gc(thiz)->font, width);                if(ftk_text_layout_get_visual_line(text_layout, &line) == RET_OK)                {                        xoffset = FTK_HALF(width - line.extent);                        ftk_canvas_draw_string(canvas, x + xoffset, y + yoffset, line.text, line.len, 1);                }        }        FTK_END_PAINT(); }

14.获取输入法管理器。
原型 ：FtkInputMethodManager* ftk_default_input_method_manager(void);
说明 ：这个函数主要是给FTK实现者使用的，普通开发人员不会用到。
参数 ：无。
返回值 ：输入法管理器。

15.获取输入法预编辑器。
原型 ：FtkImPreeditor*        ftk_default_input_method_preeditor(void);
说明 ：这个函数主要是给FTK实现者使用的，普通开发人员不会用到。
参数 ：无。
返回值 ：输入法预编辑器。

16.获取字体管理对象。
原型 ：FtkFontManager*        ftk_default_font_manager(void);
说明 ：通过字体管理器可以加载自己需要的字体，要使用不同大小的字体，一定要在编译配置时使用freetype。因为缺省字体是点阵字体，只有一种大小。
参数 ：无。
返回值 ：字体管理对象。

17.获取动画触发对象。
原型 ：FtkAnimationTrigger*   ftk_default_animation_trigger(void);
说明 ：这个函数主要是给FTK实现者使用的，普通开发人员不会用到。
参数 ：无。
返回值 ：动画触发对象。