Each page has an optional status line that can be used to display information for the user. To include this status line, the application must specify the BKA_STATUSTEXTON attribute when inserting the page. If the application inserts the page without specifying this attribute, the status line is not available for that page.
To display text on the status line of the specified page, the application must use the BKM_SETSTATUSLINETEXT message to associate a text string with the page. A separate message must be sent for each page that is to display status-line text. If the application does not send a BKM_SETSTATUSLINETEXT message for a page, no text is displayed in the status line of that page. The application can send this message to the notebook at any time to change the status-line text. The status line can be cleared by setting the text to NULL.
The following sample code shows how to insert a page into a notebook, where the inserted page has a major tab attribute, the status line is available, and the page is inserted after the last page in the notebook. This sample code also shows how to associate a text string with the status line of the inserted page.
HWND hwndNotebook; /* Notebook window handle */ ULONG ulPageId; /* Page identifier */ /***********************************************************************/ /* Insert a new page into a notebook. */ /***********************************************************************/ ulPageId = (ULONG) WinSendMsg( hwndNotebook, /* Notebook window handle */ BKM_INSERTPAGE, /* Message for inserting a page */ (MPARAM)NULL, /* NULL for page ID */ MPFROM2SHORT( BKA_MAJOR | /* Insert page with a major tab */ /* attribute */ BKA_STATUSTEXTON), /* Make status-line text visible */ BKA_LAST)); /* Insert this page at end of notebook */ /***********************************************************************/ /* Set the status-line text. */ /***********************************************************************/ WinSendMsg( hwndNotebook, /* Notebook window handle */ BKM_SETSTATUSLINETEXT, /* Message for setting status-line */ /* text */ (MPARAM)ulPageId, /* ID of page to receive status-line */ /* text */ MPFROMP("Page 1 of 2")); /* Text string to put on status line */