查看源代码 wxListItem (wx v2.4.3)
这个类存储关于 wxListCtrl
项目或列的信息。
wxListItem
是一个包含以下信息的类:
基于零的列索引;参见
setColumn/2
和getColumn/1
。图像列表中的基于零的索引;参见
getImage/1
和setImage/2
。应用程序定义的数据;参见
SetData()
(在 wx 中未实现)和GetData()
(在 wx 中未实现)。仅限列:列的宽度;参见
setWidth/2
和getWidth/1
。仅限列:列的格式;以下之一:
wxLIST_FORMAT_LEFT
,wxLIST_FORMAT_RIGHT
,wxLIST_FORMAT_CENTRE
。参见setAlign/2
和getAlign/1
。项目的状态;参见
setState/2
和getState/1
。这是以下标志的位列表:wxLIST_STATE_FOCUSED:
该项目具有焦点。wxLIST_STATE_SELECTED:
该项目被选中。wxLIST_STATE_DONTCARE:
没有特殊标志(此常量的值为 0)。wxLIST_STATE_DROPHILITED:
该项目被突出显示以接收拖放事件。仅限 Win32。wxLIST_STATE_CUT:
该项目处于剪切状态。仅限 Win32。一个掩码,指示哪些状态标志有效;这是项目状态的上述标志的位列表。参见
setStateMask/2
和 GetStateMask()。wxLIST_MASK_STATE:
状态字段有效。wxLIST_MASK_TEXT:
标签字段有效。wxLIST_MASK_IMAGE:
图像字段有效。wxLIST_MASK_DATA:
应用程序定义的数据字段有效。wxLIST_MASK_WIDTH:
列宽度字段有效。wxLIST_MASK_FORMAT:
列格式字段有效。
wxListItem
对象还可以包含项目特定的颜色和字体信息:为此,您需要调用 setTextColour/2
、setBackgroundColour/2
或 setFont/2
函数之一,并传入要使用的颜色/字体。如果未指定颜色/字体,则使用默认列表控件颜色/字体。
参见:wxListCtrl
wxWidgets 文档:wxListItem
摘要
函数
将项目状态重置为默认值。
销毁对象
返回此项目的对齐方式。
返回此项目的背景颜色。
返回基于零的列;仅在报表模式下有意义。
返回用于显示项目的字体。
返回基于零的项目位置。
返回与项目关联的图像在图像列表中的基于零的索引。
返回一个位掩码,指示结构的哪些字段有效。
返回表示项目状态的位字段。
返回标签/标题文本。
返回文本颜色。
仅在报表模式下对列标题有意义。
构造函数。
设置项目的对齐方式。
设置项目的背景颜色。
设置基于零的列。
设置项目的字体。
设置基于零的项目位置。
设置与项目关联的图像在图像列表中的基于零的索引。
设置有效字段的掩码。
设置项目状态标志(请注意,有效的状态标志受状态掩码值的影响,请参阅 setStateMask/2
)。
设置用于确定要设置哪些状态标志的位掩码。
设置项目的文本标签。
设置项目的文本颜色。
仅在报表模式下对列标题有意义。
类型
-type wxListItem() :: wx:wx_object().
函数
-spec clear(This) -> ok when This :: wxListItem().
将项目状态重置为默认值。
-spec destroy(This :: wxListItem()) -> ok.
销毁对象
-spec getAlign(This) -> wx:wx_enum() when This :: wxListItem().
返回此项目的对齐方式。
可以是 wxLIST_FORMAT_LEFT
、wxLIST_FORMAT_RIGHT
或 wxLIST_FORMAT_CENTRE
之一。
-spec getBackgroundColour(This) -> wx:wx_colour4() when This :: wxListItem().
返回此项目的背景颜色。
-spec getColumn(This) -> integer() when This :: wxListItem().
返回基于零的列;仅在报表模式下有意义。
-spec getFont(This) -> wxFont:wxFont() when This :: wxListItem().
返回用于显示项目的字体。
-spec getId(This) -> integer() when This :: wxListItem().
返回基于零的项目位置。
-spec getImage(This) -> integer() when This :: wxListItem().
返回与项目关联的图像在图像列表中的基于零的索引。
-spec getMask(This) -> integer() when This :: wxListItem().
返回一个位掩码,指示结构的哪些字段有效。
可以是以下值的任意组合:
wxLIST_MASK_STATE:
GetState
有效。wxLIST_MASK_TEXT:
GetText
有效。wxLIST_MASK_IMAGE:
GetImage
有效。wxLIST_MASK_DATA:
GetData
有效。wxLIST_MASK_WIDTH:
GetWidth
有效。wxLIST_MASK_FORMAT:
GetFormat
有效。
-spec getState(This) -> integer() when This :: wxListItem().
返回表示项目状态的位字段。
可以是以下各项的任意组合:
wxLIST_STATE_DONTCARE: 没有特殊标志(此常量的值为 0)。
wxLIST_STATE_DROPHILITED: 该项目被突出显示以接收拖放事件。仅限 Win32。
wxLIST_STATE_FOCUSED: 该项目具有焦点。
wxLIST_STATE_SELECTED: 该项目被选中。
wxLIST_STATE_CUT: 该项目处于剪切状态。仅限 Win32。
-spec getText(This) -> unicode:charlist() when This :: wxListItem().
返回标签/标题文本。
-spec getTextColour(This) -> wx:wx_colour4() when This :: wxListItem().
返回文本颜色。
-spec getWidth(This) -> integer() when This :: wxListItem().
仅在报表模式下对列标题有意义。
返回列宽度。
-spec new() -> wxListItem().
构造函数。
-spec new(Item) -> wxListItem() when Item :: wxListItem().
-spec setAlign(This, Align) -> ok when This :: wxListItem(), Align :: wx:wx_enum().
设置项目的对齐方式。
另请参见 getAlign/1
-spec setBackgroundColour(This, ColBack) -> ok when This :: wxListItem(), ColBack :: wx:wx_colour().
设置项目的背景颜色。
-spec setColumn(This, Col) -> ok when This :: wxListItem(), Col :: integer().
设置基于零的列。
仅在报表模式下有意义。
-spec setFont(This, Font) -> ok when This :: wxListItem(), Font :: wxFont:wxFont().
设置项目的字体。
-spec setId(This, Id) -> ok when This :: wxListItem(), Id :: integer().
设置基于零的项目位置。
-spec setImage(This, Image) -> ok when This :: wxListItem(), Image :: integer().
设置与项目关联的图像在图像列表中的基于零的索引。
-spec setMask(This, Mask) -> ok when This :: wxListItem(), Mask :: integer().
设置有效字段的掩码。
参见 getMask/1
。
-spec setState(This, State) -> ok when This :: wxListItem(), State :: integer().
设置项目状态标志(请注意,有效的状态标志受状态掩码值的影响,请参阅 setStateMask/2
)。
有关有效的标志值,请参见 getState/1
。
-spec setStateMask(This, StateMask) -> ok when This :: wxListItem(), StateMask :: integer().
设置用于确定要设置哪些状态标志的位掩码。
另请参见 setState/2
。
-spec setText(This, Text) -> ok when This :: wxListItem(), Text :: unicode:chardata().
设置项目的文本标签。
-spec setTextColour(This, ColText) -> ok when This :: wxListItem(), ColText :: wx:wx_colour().
设置项目的文本颜色。
-spec setWidth(This, Width) -> ok when This :: wxListItem(), Width :: integer().
仅在报表模式下对列标题有意义。
设置列宽度。