檢視原始碼 wxListView (wx v2.4.3)
這個類別目前僅為 wxListCtrl
提供一個更簡單易用的介面 — 可以將它視為該複雜類別的 facade
(外觀模式)。
在未來,某些埠可能只會實作 wxListView
,而不是全部的 wxListCtrl
功能,因此盡可能使用它會比直接使用 wxListCtrl
來得更好。
除了介面不同之外,這個類別與 wxListCtrl
完全相同。特別是,它使用相同的事件、相同的視窗樣式等等。
請參閱: setColumnImage/3
這個類別繼承自下列類別,並可以使用它們的函式:
wxWidgets 文件: wxListView
摘要
函式
重設欄位的圖片 — 在呼叫此函式後,不會顯示任何圖片。
將焦點設定到具有給定 index
的項目。
傳回(可能)多重選擇控制項中第一個被選取的項目。
傳回目前獲得焦點的項目,如果沒有則傳回 -1。
與 getFirstSelected/1
一起使用,以迭代控制項中所有被選取的項目。
如果具有給定 index
的項目被選取,則傳回 true,否則傳回 false。
選取或取消選取給定的項目。
為指定的欄位設定圖片。
型別
-type wxListView() :: wx:wx_object().
函式
-spec clearColumnImage(This, Col) -> ok when This :: wxListView(), Col :: integer().
重設欄位的圖片 — 在呼叫此函式後,不會顯示任何圖片。
請參閱: setColumnImage/3
-spec focus(This, Index) -> ok when This :: wxListView(), Index :: integer().
將焦點設定到具有給定 index
的項目。
-spec getFirstSelected(This) -> integer() when This :: wxListView().
傳回(可能)多重選擇控制項中第一個被選取的項目。
與 getNextSelected/2
一起使用,可用來迭代控制項中所有被選取的項目。
回傳值:第一個被選取的項目,如果有的話,否則傳回 -1。
-spec getFocusedItem(This) -> integer() when This :: wxListView().
傳回目前獲得焦點的項目,如果沒有則傳回 -1。
請參閱
-spec getNextSelected(This, Item) -> integer() when This :: wxListView(), Item :: integer().
與 getFirstSelected/1
一起使用,以迭代控制項中所有被選取的項目。
回傳值:傳回下一個被選取的項目,如果沒有則傳回 -1。
-spec isSelected(This, Index) -> boolean() when This :: wxListView(), Index :: integer().
如果具有給定 index
的項目被選取,則傳回 true,否則傳回 false。
請參閱
-spec select(This, N) -> ok when This :: wxListView(), N :: integer().
等同於 select(This, N, [])
。
-spec select(This, N, [Option]) -> ok when This :: wxListView(), N :: integer(), Option :: {on, boolean()}.
選取或取消選取給定的項目。
請注意,此方法繼承了 wxListCtrl:setItemState/4
的不尋常行為,當它被用來選取項目時,會發送一個 wxEVT_LIST_ITEM_SELECTED 事件,這與只有使用者動作才會導致選取的通常規則相反。
-spec setColumnImage(This, Col, Image) -> ok when This :: wxListView(), Col :: integer(), Image :: integer().
為指定的欄位設定圖片。
要使用欄位圖片,控制項必須有一個有效的圖片列表,其中至少包含一張圖片。