檢視原始碼 wxBookCtrlEvent (wx v2.4.3)
此類別代表書籤控制項(wxNotebook
、wxListbook
、wxChoicebook
、wxTreebook
、wxAuiNotebook
)所產生的事件。
在目前頁面變更之前,會先傳送 PAGE_CHANGING 事件。它允許程式檢查目前頁面(可以使用 getOldSelection/1
取得),並且如果舊頁面的控制項中的目前值無效,可以透過呼叫 wxNotifyEvent:veto/1
來否決頁面變更。
PAGE_CHANGED 事件是在頁面變更後傳送,程式無法再否決變更,只是通知程式頁面已變更。
總之,如果程式需要在允許使用者變更頁面之前驗證頁面值,則應該處理 PAGE_CHANGING 事件,否則 PAGE_CHANGED 可能就足夠了。無論如何,可能沒有必要同時處理這兩個事件。
請參閱
此類別衍生自,並且可以使用以下類別的函式:
wxWidgets 文件:wxBookCtrlEvent
摘要
函式
傳回變更之前所選取的頁面,如果沒有選取任何頁面,則傳回 wxNOT\_FOUND
。
傳回目前選取的頁面,如果沒有選取任何頁面,則傳回 wxNOT\_FOUND
。
設定變更之前所選取的頁面的 ID。
設定選取成員變數。
類型
-type wxBookCtrl() :: #wxBookCtrl{type :: wxBookCtrlEvent:wxBookCtrlEventType(), nSel :: integer(), nOldSel :: integer()}.
-type wxBookCtrlEvent() :: wx:wx_object().
-type wxBookCtrlEventType() ::
command_notebook_page_changed | command_notebook_page_changing | choicebook_page_changed |
choicebook_page_changing | treebook_page_changed | treebook_page_changing |
toolbook_page_changed | toolbook_page_changing | listbook_page_changed |
listbook_page_changing.
函式
-spec getOldSelection(This) -> integer() when This :: wxBookCtrlEvent().
傳回變更之前所選取的頁面,如果沒有選取任何頁面,則傳回 wxNOT\_FOUND
。
-spec getSelection(This) -> integer() when This :: wxBookCtrlEvent().
傳回目前選取的頁面,如果沒有選取任何頁面,則傳回 wxNOT\_FOUND
。
注意:在 Windows 下,當從 EVT_BOOKCTRL_PAGE_CHANGING
處理常式呼叫時,getSelection/1
將傳回與 getOldSelection/1
相同的值,而不是即將被選取的頁面。
-spec setOldSelection(This, Page) -> ok when This :: wxBookCtrlEvent(), Page :: integer().
設定變更之前所選取的頁面的 ID。
-spec setSelection(This, Page) -> ok when This :: wxBookCtrlEvent(), Page :: integer().
設定選取成員變數。