全局对象存取函数
FTK中有一些单实例的对象,这些对象是以全局变量的形式存在的,为了有效的控制对这些对象的访问,我们提供了相应的存/取函数。这些对象都是在FTK初始化时创建的,所以开发人员无需要再调用相应的“存”函数,但有时需要“取”出这些对象,以后 获得相应的信息。故这里只介绍“取”的函数:
1.获取缺省显示设备。
原型 :FtkDisplay* ftk_default_display(void);
说明 :目前FTK只支持一个显示设备,本函数用于获取这个显示设备对象。对于普通开发人员来说,获取显示设备的主要目的,是通过FtkDisplay对象来获得显示设备的宽度和高度。
参数 :无。
返回值 :缺省的显示设备对象。
示例: 获取显示设备的宽度和高度
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中注入按键事件。
5.获取状态栏窗口。
原型 :FtkWidget* ftk_default_status_panel(void);
说明 :状态栏窗口通常是显示在屏幕上方,用于显示当前窗口的标题或关闭按键等。开发人员通过本函数获取状态栏窗口,然后可以向状态栏窗口中增加自己的控件。
参数 :无。
返回值 :状态栏窗口。
示例: 桌面向状态栏中增加显示时间的控件。
6.获取位图工厂。
原型 :FtkBitmapFactory* ftk_default_bitmap_factory(void);
说明 :位图工厂主要用于加载图片文件,通过本函数获取位图工厂,然后加载自己需要的图片。
参数 :无。
返回值 :位图工厂。
示例:
7.获取事件源管理器对象。
原型 :FtkSourcesManager* ftk_default_sources_manager(void);
说明 :这个函数主要是给FTK实现者使用的,普通开发人员不会用到。
参数 :无。
返回值 :事件源管理器对象。
8.获取共享画板对象。
原型 :FtkCanvas* ftk_shared_canvas(void);
说明 :这个函数主要是给FTK实现者使用的,普通开发人员不会用到。
参数 :无。
返回值 :共享画板对象。
9.获取主题对象。
原型 :FtkTheme* ftk_default_theme(void);
说明 :主题对象负责FTK的外在表现,换一个主题,FTK可能有完全不同的表现效果。通常开发人员可以利用主题对象来加载主题相关的图片,或者获取相关的配置信息。
参数 :无。
返回值 :主题对象。
示例 :加载主题中的图片。
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控件使用文本排版对象计算文字宽度。
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实现者使用的,普通开发人员不会用到。
参数 :无。
返回值 :动画触发对象。