Giveda® Embedded Midware  1.2.0
本文档受《版权法》、《版权公约》保护。深圳技达®版权所有
 全部  命名空间 文件 函数 变量 类型定义 枚举 枚举值 友元 宏定义 
Public 类型 | Public 成员函数 | 静态 Public 成员函数 | Public 属性 | Protected 成员函数 | Protected 属性 | 友元 | 所有成员列表
GCtrlListBox类 参考

GCtrlListBox 类提供了类似windows资源管理器中的列表视图;列表视图可以包含任意数目的列表项 GCtrlListBoxItem ;如果没有列表视图,列表项将无法显示。 更多...

#include <gCtrlListBox.h>

继承自 GMContainerItem .

Public 类型

enum  E_ITEMS_LAYOUT_MODE { E_ITEMS_LAYOUT_TOP_2_BOTTOM =0, E_ITEMS_LAYOUT_LEFT_2_RIGHT }
 列表如何排版其中的列表项 更多...
 

Public 成员函数

 GCtrlListBox (GCtrlForm *frm, GMItem *parent=0, const char *name=0, const bool showSingleTitle=false)
 构造一个列表视图。一个列表视图可以包含任意数目的列表项 GCtrlListBoxItem 。默认情况下,列表视图会按照列表项被添加进来的先后顺序,为所有列表项建立索引。用户可以使用索引值来访问、操作任一列表项。默认情况下,列表使用 E_ITEMS_LAYOUT_TOP_2_BOTTOM 从下往下依次布局列表项。 更多...
 
virtual ~GCtrlListBox ()
 
void insertItem (GCtrlListBoxItem *p, int index=-1)
 向列表视图中添加列表项。列表视图会按照列表项被添加进来的先后顺序,为所有列表项建立索引。 更多...
 
void removeItem (int index=-1)
 从列表视图中删除一个列表项。如果 index 等于-1,会删除当前处于焦点状态的列表项;否则,删除第 index 个列表项。系统将自动回收被删除掉的列表项所占用的内存。 更多...
 
void removeItem (GCtrlListBoxItem *)
 从列表视图中删除指定的列表项。系统将自动回收被删除掉的列表项所占用的内存。 更多...
 
void changeItem (GCtrlListBoxItem *, int index=-1)
 更换第 index 个列表项;系统将自动回收被替换掉的列表项所占用的内存;如果 index 等于-1,会替换掉当前处于焦点状态的列表项; 更多...
 
void setRowNums (unsigned int num)
 设置列表视图的行数,即指定一下列表视图中包含几行列表项 更多...
 
void setColumnNums (unsigned int num)
 设置列表视图的列数,即指定一行中包含几个列表项 更多...
 
GCtrlListBoxItemitem (int index=-1)
 获取第 index 个列表项;如果index=-1则获取当前具有焦点状态的列表项 更多...
 
int getCurItemIndex ()
 获取当前具有焦点状态的列表项的索引值 更多...
 
unsigned int count ()
 返回当前列表视图中所包含的列表项的数目 更多...
 
void clear ()
 清空列表视图。列表视图中包含的所有列表项将被删除,它们占用的内存空间将被收回。 更多...
 
void setFocusInImage (const GImage &)
 设置当列表视图处于焦点状态时,列表项所使用的焦点图片 更多...
 
void setFocusOutImage (const GImage &)
 设置当列表视图失去焦点状态之后,列表项所使用的焦点图片 更多...
 
void setCurItemIndex (const int nIndex)
 让第 nIndex 个列表项得到焦点状态 更多...
 
void setItemTextColor (const GColor &c)
 设置列表项文字标题的颜色 更多...
 
void setItemTextFont (const GFont &f)
 设置列表项文字标题的字体 更多...
 
GColor getItemTextColor ()
 获得列表项文字标题的颜色 更多...
 
GFont getItemTextFont ()
 获得列表项文字标题的字体 更多...
 
void setItemScrollEnabled (bool enabled)
 设置列表项的文字标题(在标题长度过长的情况下)是否能够以滚动字幕的形式进行显示 更多...
 
void setLayoutMode (E_ITEMS_LAYOUT_MODE mode)
 设置列表应当如何排版列表项。默认情况下,列表使用 E_ITEMS_LAYOUT_TOP_2_BOTTOM 从下往下依次布局列表项 更多...
 
GCtrlListBox::E_ITEMS_LAYOUT_MODE getLayoutMode () const
 获取列表的布局模式。默认情况下,列表使用 E_ITEMS_LAYOUT_TOP_2_BOTTOM 从下往下依次布局列表项 更多...
 
void setPreviousItemKey (int nKey)
 设置一个用于将焦点移动到上一个列表项的按键键值。默认值为 Giveda::Key_Up
请注意,因为PreviousItemKey/NextItemKey/PreviousColumnKey/NextColumnKey都有默认的值,所以调用此函数有可能会导致键值冲突。键值冲突时,框架会打印出来一条warning提示:can not override another key 更多...
 
void setNextItemKey (int nKey)
 设置一个用于将焦点移动到下一个列表项的按键键值。默认值为 Giveda::Key_Down
请注意,因为PreviousItemKey/NextItemKey/PreviousColumnKey/NextColumnKey都有默认的值,所以调用此函数有可能会导致键值冲突。键值冲突时,框架会打印出来一条warning提示:can not override another key 更多...
 
void setLoopFocus (bool b)
 设置是否允许循环切换焦点;
如果允许,则当移到焦点到最后一个列表项后,此时如果试图移动焦点到下一个列表项,则焦点将移动到第一个列表项;
如果禁止,则当移到焦点到最后一个列表项后,此时如果试图移动焦点到下一个列表项,则焦点保持不变。 更多...
 
void setPreviousColumnKey (int nKey)
 设置一个用于将焦点向前移动一列的按键键值。默认值为 Giveda::Key_PageUp
请注意,因为PreviousItemKey/NextItemKey/PreviousColumnKey/NextColumnKey都有默认的值,所以调用此函数有可能会导致键值冲突。键值冲突时,框架会打印出来一条warning提示:can not override another key 更多...
 
void setNextColumnKey (int nKey)
 设置一个用于将焦点向后移动一列的按键键值。默认值为 Giveda::Key_PageDown
请注意,因为PreviousItemKey/NextItemKey/PreviousColumnKey/NextColumnKey都有默认的值,所以调用此函数有可能会导致键值冲突。键值冲突时,框架会打印出来一条warning提示:can not override another key 更多...
 
void setFocusToItem (GMCtrlItem *pItem)
 设置焦点到指定的 GMCtrlItem 更多...
 
virtual bool isContainerItem ()
 是否是容器 更多...
 
virtual bool isCtrlItem ()
 是否可以接收输入事件 更多...
 
bool isFocusEnabled ()
 获取焦点是否被禁用;焦点被禁用后,此元素将不能获得焦点 ,不能处理各种输入事件。 更多...
 
void setFocusEnabled (bool b)
 设置是否禁此元素的焦点;焦点被禁用后,此元素将不能获得焦点 ,不能处理各种输入事件。 更多...
 
void setFocus ()
 设置此元素到有焦点状态 更多...
 
bool hasFocus ()
 返回此元素是否具有焦点 更多...
 
void setTabIndex (unsigned int index)
 设置此界面元素的tab index;在使用键盘来操作界面时,需要用到tab index 更多...
 
unsigned int tabIndex ()
 获取此界面元素的tab index;在使用键盘来操作界面时,需要用到tab index 更多...
 
virtual void hide ()
 隐藏此界面元素。相当于:
更多...
 
bool fwKeyPress (GKeyEvent *e)
 
bool fwMousePress (GMouseEvent *e)
 
bool fwTap (GTapEvent *e)
 
bool fwSwipe (GSwipeEvent *e)
 
bool fwGestureScroll (GGestureScrollEvent *e)
 
void setX (int x)
 设置此界面元素的x坐标 更多...
 
void setY (int y)
 设置此界面元素的y坐标 更多...
 
void setZ (int z)
 设置此界面元素的z坐标 更多...
 
void setWidth (int w)
 设置此界面元素的宽度 更多...
 
void setHeight (int h)
 设置此界面元素的高度 更多...
 
int x () const
 获取此界面元素的x坐标 更多...
 
int y () const
 获取此界面元素的y坐标 更多...
 
int z () const
 获取此界面元素的z坐标 更多...
 
int width () const
 获取此界面元素的宽度 更多...
 
int height () const
 获取此界面元素的高度 更多...
 
int right () const
 获取右边界的坐标 更多...
 
int bottom () const
 获取下边界的坐标 更多...
 
GRect rect () const
 获取此界面元素所占用的矩形区域 更多...
 
void setPosition (int x, int y)
 设置此界面元素的位置 更多...
 
void setSize (int w, int h)
 设置此界面元素的大小 更多...
 
void setSize (const GSize &s)
 设置此界面元素的大小 更多...
 
void setGeometry (int x, int y, int w, int h)
 设置此界面元素所占用的矩形区域,位置及大小 更多...
 
void moveBy (int x, int y)
 移动此界面元素;将此界面元素沿X轴移动 x 像素,沿Y轴移动 y 像素 更多...
 
void setPaletteBackgroundColor (const GColor &c)
 设置此界面元素的背景颜色 更多...
 
void loadBackgroundPixmap (const uint16_t imgID)
 加载一个图片作为此界面元素的背景 更多...
 
bool isVisible ()
 返回此界面元素当前是否可见;show() 之后可见, hide() 之后不可见 更多...
 
void setVisible (bool b)
 设置此界面元素是否可见;(用户改变此界面元素的可见属性之后,需要调用 update() 或 repaint() ) 更多...
 
virtual void show ()
 显示此界面元素。相当于:
更多...
 
GCtrlFormform ()
 获取此界面元素所在的窗体 更多...
 
void update ()
 更新此界面元素所在的矩形区域;这个函数不会立刻进行重新绘制——而是发送一个绘制事件到事件循环中,后续,事件循环会分发、处理该绘制事件。这样能得到比调用 repaint() 更快的速度和更少的闪烁。 更多...
 
virtual void draw ()
 
QCtrlDefaultAppStyle * getDefaultAppStyle ()
 
virtual bool isComplex ()
 
const char * name () const
 获取对象名称 更多...
 
GObjectparent () const
 获取对象的parent 更多...
 
virtual bool event (GEvent *)
 开发者可以在子类中覆盖此函数,处理自己需要的事件 更多...
 

静态 Public 成员函数

template<class Receiver , typename... Args>
static int connect (GObject *sender, GSignal< void(Args...)> &signal, Receiver *receiver, void(Receiver::*SlotFunc)(Args...))
 将信号和槽建立连接。
Receiver代表接收者的类型 Args是槽函数/信号的参数列表。 更多...
 
template<class Receiver , typename... Args>
static int disconnect (GObject *sender, GSignal< void(Args...)> &signal, Receiver *receiver, void(Receiver::*SlotFunc)(Args...))
 将信号和槽断开连接。
Receiver代表接收者的类型 Args是槽函数/信号的参数列表。 更多...
 
static bool isObjectExist (GObject *obj)
 判断对象是否已经被析构掉了。 更多...
 

Public 属性

GSignal< void(const
GCtrlListBoxItem *)> 
focusChangedTo_pI
 当列表项的焦点发生改变时,该信号被立即发射;参数为:当前具有焦点的列表项 更多...
 
GSignal< void(int)> focusChangedTo_pi
 当列表项的焦点发生改变时,该信号被立即发射;参数为:当前具有焦点的列表项的索引值 更多...
 
GSignal< void(const
GCtrlListBoxItem *)> 
highlighted_pI
 列表项的焦点发生了改变,并且10秒之内列表项的焦点没有再次发生改变,该信号被立即发射;参数为:当前具有焦点的列表项 更多...
 
GSignal< void(int)> highlighted_pi
 列表项的焦点发生了改变,并且10秒之内列表项的焦点没有再次发生改变,该信号被立即发射;参数为:当前具有焦点的列表项的索引值 更多...
 
GSignal< void(const
GCtrlListBoxItem *)> 
selected_pI
 当列表项被用户点击时,该信号被立即发射;参数为:当前具有焦点的列表项 更多...
 
GSignal< void(int)> selected_pi
 当列表项被用户点击时,该信号被立即发射;参数为:当前具有焦点的列表项的索引值 更多...
 
GSignal< void(void)> loseFocus
 当此元素失去焦点时,会立即发射此信号 更多...
 
GSignal< void(void)> getFocus
 当此元素获得焦点时,会立即发射此信号 更多...
 
GSignal< void(void)> sigDestroyed
 当对象被析构时,会发射此信号 更多...
 

Protected 成员函数

virtual bool fwKeyPressEvent (GKeyEvent *)
 
virtual bool fwMousePressEvent (GMouseEvent *)
 
virtual bool fwTapEvent (GTapEvent *)
 
virtual bool fwSwipeEvent (GSwipeEvent *)
 
virtual void paintEvent ()
 
int getMaxIconHeight ()
 获取列表项的最大显示高度 更多...
 
int getMaxIconWidth ()
 获取列表项的最大显示宽度 更多...
 
virtual bool keyPressEvent (GKeyEvent *)
 用户可以在子类中覆盖这个函数处理按键。用户不可以覆盖任何以fw开头的函数 更多...
 
virtual bool mousePressEvent (GMouseEvent *)
 用户可以在子类中覆盖这个函数处理鼠标事件。用户不可以覆盖任何以fw开头的函数 更多...
 
virtual bool tapEvent (GTapEvent *)
 用户可以在子类中覆盖这个函数处理点击事件。用户不可以覆盖任何以fw开头的函数 更多...
 
virtual bool swipeEvent (GSwipeEvent *)
 用户可以在子类中覆盖这个函数处理滑动事件。用户不可以覆盖任何以fw开头的函数 更多...
 
virtual bool gestureScrollEvent (GGestureScrollEvent *)
 用户可以在子类中覆盖这个函数处理滑动手势。用户不可以覆盖任何以fw开头的函数 更多...
 
virtual bool fwGestureScrollEvent (GGestureScrollEvent *)
 

Protected 属性

GPointer< GMCtrlItemmpFocus
 

友元

class GCtrlListBoxItem
 

详细描述

GCtrlListBox 类提供了类似windows资源管理器中的列表视图;列表视图可以包含任意数目的列表项 GCtrlListBoxItem ;如果没有列表视图,列表项将无法显示。

成员枚举类型说明

列表如何排版其中的列表项

枚举值
E_ITEMS_LAYOUT_TOP_2_BOTTOM 

默认值。从上往下排版列表项,超出下边界则在右侧另起一列

E_ITEMS_LAYOUT_LEFT_2_RIGHT 

从左向右排版列表项,超出右边界则在下方另起一行

构造及析构函数说明

GCtrlListBox::GCtrlListBox ( GCtrlForm frm,
GMItem parent = 0,
const char *  name = 0,
const bool  showSingleTitle = false 
)

构造一个列表视图。一个列表视图可以包含任意数目的列表项 GCtrlListBoxItem 。默认情况下,列表视图会按照列表项被添加进来的先后顺序,为所有列表项建立索引。用户可以使用索引值来访问、操作任一列表项。默认情况下,列表使用 E_ITEMS_LAYOUT_TOP_2_BOTTOM 从下往下依次布局列表项。

参数
frm...
parent...
name...
showSingleTitle是否仅显示当前具有焦点的图标项的文字标题。如果为true,则其它无焦点的图标项的文字标题会被隐藏。
virtual GCtrlListBox::~GCtrlListBox ( )
virtual

成员函数说明

int GMItem::bottom ( ) const
inherited

获取下边界的坐标

返回
int
void GCtrlListBox::changeItem ( GCtrlListBoxItem ,
int  index = -1 
)

更换第 index 个列表项;系统将自动回收被替换掉的列表项所占用的内存;如果 index 等于-1,会替换掉当前处于焦点状态的列表项;

参数
...
index...
返回
void
void GCtrlListBox::clear ( )

清空列表视图。列表视图中包含的所有列表项将被删除,它们占用的内存空间将被收回。

返回
void
template<class Receiver , typename... Args>
int GObject::connect ( GObject sender,
GSignal< void(Args...)> &  signal,
Receiver *  receiver,
void(Receiver::*)(Args...)  SlotFunc 
)
staticinherited

将信号和槽建立连接。
Receiver代表接收者的类型 Args是槽函数/信号的参数列表。

参数
sender指向发射者的指针
signal指向信号的引用。
receiver指向接收者的指针
SlotFunc指向槽函数的指针
返回
0代表成功;非0代表失败
unsigned int GCtrlListBox::count ( )

返回当前列表视图中所包含的列表项的数目

返回
unsigned int
template<class Receiver , typename... Args>
int GObject::disconnect ( GObject sender,
GSignal< void(Args...)> &  signal,
Receiver *  receiver,
void(Receiver::*)(Args...)  SlotFunc 
)
staticinherited

将信号和槽断开连接。
Receiver代表接收者的类型 Args是槽函数/信号的参数列表。

参数
sender指向发射者的指针
signal指向信号的引用。
receiver指向接收者的指针
SlotFunc指向槽函数的指针
返回
0代表成功;非0代表失败
virtual void GMItem::draw ( )
virtualinherited
virtual bool GObject::event ( GEvent )
virtualinherited

开发者可以在子类中覆盖此函数,处理自己需要的事件

参数
...
返回
bool

GTcpSocket, GTimer, GUdpSocket , 以及 GTcpServer 重载.

GCtrlForm* GMItem::form ( )
inherited

获取此界面元素所在的窗体

返回
GCtrlForm*
bool GMCtrlItem::fwGestureScroll ( GGestureScrollEvent e)
inherited
virtual bool GMCtrlItem::fwGestureScrollEvent ( GGestureScrollEvent )
protectedvirtualinherited

GMProgressBar 重载.

bool GMCtrlItem::fwKeyPress ( GKeyEvent e)
inherited
virtual bool GCtrlListBox::fwKeyPressEvent ( GKeyEvent )
protectedvirtual

重载 GMCtrlItem .

bool GMCtrlItem::fwMousePress ( GMouseEvent e)
inherited
virtual bool GCtrlListBox::fwMousePressEvent ( GMouseEvent )
protectedvirtual

重载 GMCtrlItem .

bool GMCtrlItem::fwSwipe ( GSwipeEvent e)
inherited
virtual bool GCtrlListBox::fwSwipeEvent ( GSwipeEvent )
protectedvirtual

重载 GMCtrlItem .

bool GMCtrlItem::fwTap ( GTapEvent e)
inherited
virtual bool GCtrlListBox::fwTapEvent ( GTapEvent )
protectedvirtual

重载 GMCtrlItem .

virtual bool GMCtrlItem::gestureScrollEvent ( GGestureScrollEvent )
protectedvirtualinherited

用户可以在子类中覆盖这个函数处理滑动手势。用户不可以覆盖任何以fw开头的函数

参数
...
返回
bool
int GCtrlListBox::getCurItemIndex ( )

获取当前具有焦点状态的列表项的索引值

返回
int
QCtrlDefaultAppStyle* GMItem::getDefaultAppStyle ( )
inherited
GColor GCtrlListBox::getItemTextColor ( )

获得列表项文字标题的颜色

返回
GColor
GFont GCtrlListBox::getItemTextFont ( )

获得列表项文字标题的字体

返回
GFont
GCtrlListBox::E_ITEMS_LAYOUT_MODE GCtrlListBox::getLayoutMode ( ) const

获取列表的布局模式。默认情况下,列表使用 E_ITEMS_LAYOUT_TOP_2_BOTTOM 从下往下依次布局列表项

返回
GCtrlListBox::E_ITEMS_LAYOUT_MODE
int GCtrlListBox::getMaxIconHeight ( )
protected

获取列表项的最大显示高度

返回
int
int GCtrlListBox::getMaxIconWidth ( )
protected

获取列表项的最大显示宽度

返回
int
bool GMCtrlItem::hasFocus ( )
inherited

返回此元素是否具有焦点

返回
bool
int GMItem::height ( ) const
inherited

获取此界面元素的高度

返回
int
virtual void GMCtrlItem::hide ( )
virtualinherited

隐藏此界面元素。相当于:

setVisible (false);
update();
返回
void

重载 GMItem .

void GCtrlListBox::insertItem ( GCtrlListBoxItem p,
int  index = -1 
)

向列表视图中添加列表项。列表视图会按照列表项被添加进来的先后顺序,为所有列表项建立索引。

参数
p列表项
index指定列表项在列表视图中的显示位置;-1意味着列表项将被放置在列表视图的最后;
返回
void
virtual bool GMItem::isComplex ( )
virtualinherited
virtual bool GMContainerItem::isContainerItem ( )
virtualinherited

是否是容器

返回
bool

重载 GMItem .

virtual bool GMCtrlItem::isCtrlItem ( )
virtualinherited

是否可以接收输入事件

返回
bool

重载 GMItem .

bool GMCtrlItem::isFocusEnabled ( )
inherited

获取焦点是否被禁用;焦点被禁用后,此元素将不能获得焦点 ,不能处理各种输入事件。

返回
bool
static bool GObject::isObjectExist ( GObject obj)
staticinherited

判断对象是否已经被析构掉了。

参数
obj...
返回
bool true表示对象健在,false表示对象已经被析构掉了
bool GMItem::isVisible ( )
inherited

返回此界面元素当前是否可见;show() 之后可见, hide() 之后不可见

返回
bool
GCtrlListBoxItem* GCtrlListBox::item ( int  index = -1)

获取第 index 个列表项;如果index=-1则获取当前具有焦点状态的列表项

参数
index...
返回
GCtrlListBoxItem*
virtual bool GMCtrlItem::keyPressEvent ( GKeyEvent )
protectedvirtualinherited

用户可以在子类中覆盖这个函数处理按键。用户不可以覆盖任何以fw开头的函数

参数
...
返回
bool
void GMItem::loadBackgroundPixmap ( const uint16_t  imgID)
inherited

加载一个图片作为此界面元素的背景

参数
imgID图片的数字ID
返回
void
virtual bool GMCtrlItem::mousePressEvent ( GMouseEvent )
protectedvirtualinherited

用户可以在子类中覆盖这个函数处理鼠标事件。用户不可以覆盖任何以fw开头的函数

参数
...
返回
bool
void GMItem::moveBy ( int  x,
int  y 
)
inherited

移动此界面元素;将此界面元素沿X轴移动 x 像素,沿Y轴移动 y 像素

参数
x...
y...
返回
void
const char* GObject::name ( ) const
inherited

获取对象名称

返回
const char*
virtual void GCtrlListBox::paintEvent ( )
protectedvirtual

重载 GMItem .

GObject* GObject::parent ( ) const
inherited

获取对象的parent

返回
GObject*
GRect GMItem::rect ( ) const
inherited

获取此界面元素所占用的矩形区域

返回
GRect
void GCtrlListBox::removeItem ( int  index = -1)

从列表视图中删除一个列表项。如果 index 等于-1,会删除当前处于焦点状态的列表项;否则,删除第 index 个列表项。系统将自动回收被删除掉的列表项所占用的内存。

参数
index...
返回
void
void GCtrlListBox::removeItem ( GCtrlListBoxItem )

从列表视图中删除指定的列表项。系统将自动回收被删除掉的列表项所占用的内存。

参数
...
返回
void
int GMItem::right ( ) const
inherited

获取右边界的坐标

返回
int
void GCtrlListBox::setColumnNums ( unsigned int  num)

设置列表视图的列数,即指定一行中包含几个列表项

参数
num...
返回
void
void GCtrlListBox::setCurItemIndex ( const int  nIndex)

让第 nIndex 个列表项得到焦点状态

参数
nIndex...
返回
void
void GMCtrlItem::setFocus ( )
inherited

设置此元素到有焦点状态

返回
bool
void GMCtrlItem::setFocusEnabled ( bool  b)
inherited

设置是否禁此元素的焦点;焦点被禁用后,此元素将不能获得焦点 ,不能处理各种输入事件。

参数
b...
返回
void
void GCtrlListBox::setFocusInImage ( const GImage )

设置当列表视图处于焦点状态时,列表项所使用的焦点图片

参数
...
返回
void
void GCtrlListBox::setFocusOutImage ( const GImage )

设置当列表视图失去焦点状态之后,列表项所使用的焦点图片

参数
...
返回
void
void GMContainerItem::setFocusToItem ( GMCtrlItem pItem)
inherited

设置焦点到指定的 GMCtrlItem

参数
pItem...
返回
void
void GMItem::setGeometry ( int  x,
int  y,
int  w,
int  h 
)
inherited

设置此界面元素所占用的矩形区域,位置及大小

参数
x...
y...
w...
h...
返回
void
void GMItem::setHeight ( int  h)
inherited

设置此界面元素的高度

参数
h...
返回
void
void GCtrlListBox::setItemScrollEnabled ( bool  enabled)

设置列表项的文字标题(在标题长度过长的情况下)是否能够以滚动字幕的形式进行显示

参数
enabled...
返回
void
void GCtrlListBox::setItemTextColor ( const GColor c)

设置列表项文字标题的颜色

参数
c...
返回
void
void GCtrlListBox::setItemTextFont ( const GFont f)

设置列表项文字标题的字体

参数
f...
返回
void
void GCtrlListBox::setLayoutMode ( E_ITEMS_LAYOUT_MODE  mode)

设置列表应当如何排版列表项。默认情况下,列表使用 E_ITEMS_LAYOUT_TOP_2_BOTTOM 从下往下依次布局列表项

参数
mode...
返回
void
void GCtrlListBox::setLoopFocus ( bool  b)

设置是否允许循环切换焦点;
如果允许,则当移到焦点到最后一个列表项后,此时如果试图移动焦点到下一个列表项,则焦点将移动到第一个列表项;
如果禁止,则当移到焦点到最后一个列表项后,此时如果试图移动焦点到下一个列表项,则焦点保持不变。

参数
b...
返回
void
void GCtrlListBox::setNextColumnKey ( int  nKey)

设置一个用于将焦点向后移动一列的按键键值。默认值为 Giveda::Key_PageDown
请注意,因为PreviousItemKey/NextItemKey/PreviousColumnKey/NextColumnKey都有默认的值,所以调用此函数有可能会导致键值冲突。键值冲突时,框架会打印出来一条warning提示:can not override another key

参数
nKey...
返回
void
void GCtrlListBox::setNextItemKey ( int  nKey)

设置一个用于将焦点移动到下一个列表项的按键键值。默认值为 Giveda::Key_Down
请注意,因为PreviousItemKey/NextItemKey/PreviousColumnKey/NextColumnKey都有默认的值,所以调用此函数有可能会导致键值冲突。键值冲突时,框架会打印出来一条warning提示:can not override another key

参数
nKey...
返回
void
void GMItem::setPaletteBackgroundColor ( const GColor c)
inherited

设置此界面元素的背景颜色

参数
c...
返回
void
void GMItem::setPosition ( int  x,
int  y 
)
inherited

设置此界面元素的位置

参数
x...
y...
返回
void
void GCtrlListBox::setPreviousColumnKey ( int  nKey)

设置一个用于将焦点向前移动一列的按键键值。默认值为 Giveda::Key_PageUp
请注意,因为PreviousItemKey/NextItemKey/PreviousColumnKey/NextColumnKey都有默认的值,所以调用此函数有可能会导致键值冲突。键值冲突时,框架会打印出来一条warning提示:can not override another key

参数
nKey...
返回
void
void GCtrlListBox::setPreviousItemKey ( int  nKey)

设置一个用于将焦点移动到上一个列表项的按键键值。默认值为 Giveda::Key_Up
请注意,因为PreviousItemKey/NextItemKey/PreviousColumnKey/NextColumnKey都有默认的值,所以调用此函数有可能会导致键值冲突。键值冲突时,框架会打印出来一条warning提示:can not override another key

参数
nKey...
返回
void
void GCtrlListBox::setRowNums ( unsigned int  num)

设置列表视图的行数,即指定一下列表视图中包含几行列表项

参数
num...
返回
void
void GMItem::setSize ( int  w,
int  h 
)
inherited

设置此界面元素的大小

参数
w...
h...
返回
void
void GMItem::setSize ( const GSize s)
inherited

设置此界面元素的大小

参数
s...
返回
void
void GMCtrlItem::setTabIndex ( unsigned int  index)
inherited

设置此界面元素的tab index;在使用键盘来操作界面时,需要用到tab index

参数
index...
返回
void
void GMItem::setVisible ( bool  b)
inherited

设置此界面元素是否可见;(用户改变此界面元素的可见属性之后,需要调用 update() 或 repaint() )

参数
b...
返回
void
void GMItem::setWidth ( int  w)
inherited

设置此界面元素的宽度

参数
w...
返回
void
void GMItem::setX ( int  x)
inherited

设置此界面元素的x坐标

参数
x...
返回
void
void GMItem::setY ( int  y)
inherited

设置此界面元素的y坐标

参数
y...
返回
void
void GMItem::setZ ( int  z)
inherited

设置此界面元素的z坐标

参数
z...
返回
void
virtual void GMItem::show ( )
virtualinherited

显示此界面元素。相当于:

setVisible (true);
update();
返回
void
virtual bool GMCtrlItem::swipeEvent ( GSwipeEvent )
protectedvirtualinherited

用户可以在子类中覆盖这个函数处理滑动事件。用户不可以覆盖任何以fw开头的函数

参数
...
返回
bool
unsigned int GMCtrlItem::tabIndex ( )
inherited

获取此界面元素的tab index;在使用键盘来操作界面时,需要用到tab index

返回
unsigned int
virtual bool GMCtrlItem::tapEvent ( GTapEvent )
protectedvirtualinherited

用户可以在子类中覆盖这个函数处理点击事件。用户不可以覆盖任何以fw开头的函数

参数
...
返回
bool
void GMItem::update ( )
inherited

更新此界面元素所在的矩形区域;这个函数不会立刻进行重新绘制——而是发送一个绘制事件到事件循环中,后续,事件循环会分发、处理该绘制事件。这样能得到比调用 repaint() 更快的速度和更少的闪烁。

返回
void
int GMItem::width ( ) const
inherited

获取此界面元素的宽度

返回
int
int GMItem::x ( ) const
inherited

获取此界面元素的x坐标

返回
int
int GMItem::y ( ) const
inherited

获取此界面元素的y坐标

返回
int
int GMItem::z ( ) const
inherited

获取此界面元素的z坐标

返回
int

友元及相关函数文档

friend class GCtrlListBoxItem
friend

类成员变量说明

GSignal<void ( const GCtrlListBoxItem* )> GCtrlListBox::focusChangedTo_pI

当列表项的焦点发生改变时,该信号被立即发射;参数为:当前具有焦点的列表项

GSignal<void ( int )> GCtrlListBox::focusChangedTo_pi

当列表项的焦点发生改变时,该信号被立即发射;参数为:当前具有焦点的列表项的索引值

GSignal<void(void)> GMCtrlItem::getFocus
inherited

当此元素获得焦点时,会立即发射此信号

GSignal<void ( const GCtrlListBoxItem* )> GCtrlListBox::highlighted_pI

列表项的焦点发生了改变,并且10秒之内列表项的焦点没有再次发生改变,该信号被立即发射;参数为:当前具有焦点的列表项

GSignal<void ( int )> GCtrlListBox::highlighted_pi

列表项的焦点发生了改变,并且10秒之内列表项的焦点没有再次发生改变,该信号被立即发射;参数为:当前具有焦点的列表项的索引值

GSignal<void(void)> GMCtrlItem::loseFocus
inherited

当此元素失去焦点时,会立即发射此信号

GPointer<GMCtrlItem> GMContainerItem::mpFocus
protectedinherited
GSignal<void ( const GCtrlListBoxItem* )> GCtrlListBox::selected_pI

当列表项被用户点击时,该信号被立即发射;参数为:当前具有焦点的列表项

GSignal<void ( int )> GCtrlListBox::selected_pi

当列表项被用户点击时,该信号被立即发射;参数为:当前具有焦点的列表项的索引值

GSignal<void(void)> GObject::sigDestroyed
inherited

当对象被析构时,会发射此信号


该类的文档由以下文件生成: