查看源代码 wxListItem (wx v2.4.3)

这个类存储关于 wxListCtrl 项目或列的信息。

wxListItem 是一个包含以下信息的类:

  • 基于零的项目位置;参见 setId/2getId/1

  • 基于零的列索引;参见 setColumn/2getColumn/1

  • 标签(或列的标题);参见 setText/2getText/1

  • 图像列表中的基于零的索引;参见 getImage/1setImage/2

  • 应用程序定义的数据;参见 SetData()(在 wx 中未实现)和 GetData()(在 wx 中未实现)。

  • 仅限列:列的宽度;参见 setWidth/2getWidth/1

  • 仅限列:列的格式;以下之一:wxLIST_FORMAT_LEFTwxLIST_FORMAT_RIGHTwxLIST_FORMAT_CENTRE。参见 setAlign/2getAlign/1

  • 项目的状态;参见 setState/2getState/1。这是以下标志的位列表:

  • wxLIST_STATE_FOCUSED: 该项目具有焦点。

  • wxLIST_STATE_SELECTED: 该项目被选中。

  • wxLIST_STATE_DONTCARE: 没有特殊标志(此常量的值为 0)。

  • wxLIST_STATE_DROPHILITED: 该项目被突出显示以接收拖放事件。仅限 Win32。

  • wxLIST_STATE_CUT: 该项目处于剪切状态。仅限 Win32。

  • 一个掩码,指示哪些状态标志有效;这是项目状态的上述标志的位列表。参见 setStateMask/2 和 GetStateMask()。

  • 一个掩码,指示此类中的哪些字段有效;参见 setMask/2getMask/1。这是以下标志的位列表:

  • wxLIST_MASK_STATE: 状态字段有效。

  • wxLIST_MASK_TEXT: 标签字段有效。

  • wxLIST_MASK_IMAGE: 图像字段有效。

  • wxLIST_MASK_DATA: 应用程序定义的数据字段有效。

  • wxLIST_MASK_WIDTH: 列宽度字段有效。

  • wxLIST_MASK_FORMAT: 列格式字段有效。

wxListItem 对象还可以包含项目特定的颜色和字体信息:为此,您需要调用 setTextColour/2setBackgroundColour/2setFont/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_LEFTwxLIST_FORMAT_RIGHTwxLIST_FORMAT_CENTRE 之一。

链接到此函数

getBackgroundColour(This)

查看源代码
-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

链接到此函数

setBackgroundColour(This, ColBack)

查看源代码
-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

链接到此函数

setStateMask(This, StateMask)

查看源代码
-spec setStateMask(This, StateMask) -> ok when This :: wxListItem(), StateMask :: integer().

设置用于确定要设置哪些状态标志的位掩码。

另请参见 setState/2

-spec setText(This, Text) -> ok when This :: wxListItem(), Text :: unicode:chardata().

设置项目的文本标签。

链接到此函数

setTextColour(This, ColText)

查看源代码
-spec setTextColour(This, ColText) -> ok when This :: wxListItem(), ColText :: wx:wx_colour().

设置项目的文本颜色。

-spec setWidth(This, Width) -> ok when This :: wxListItem(), Width :: integer().

仅在报表模式下对列标题有意义。

设置列宽度。