檢視原始碼 wxBookCtrlEvent (wx v2.4.3)

此類別代表書籤控制項(wxNotebookwxListbookwxChoicebookwxTreebookwxAuiNotebook)所產生的事件。

在目前頁面變更之前,會先傳送 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 相同的值,而不是即將被選取的頁面。

連結到此函式

setOldSelection(This, Page)

檢視原始碼
-spec setOldSelection(This, Page) -> ok when This :: wxBookCtrlEvent(), Page :: integer().

設定變更之前所選取的頁面的 ID。

連結到此函式

setSelection(This, Page)

檢視原始碼
-spec setSelection(This, Page) -> ok when This :: wxBookCtrlEvent(), Page :: integer().

設定選取成員變數。