BKM_INSERTPAGE - Parameters

ulPageId (ULONG)

Page ID for placement.

Page identifier used for the placement of the inserted page. This identifier is ignored if the BKA_FIRST or BKA_LAST attribute of the usPageOrder parameter is specified.

usPageStyle (USHORT)

Style attributes.

Attributes that specify the style to be used for an inserted page. You can specify one attribute from each of the following groups by using logical OR operators (|) to combine attributes.

• Specify the following for automatic page position and size:

  BKA_AUTOPAGESIZE

  Notebook handles the positioning and sizing of the application page window specified in the BKM_SETPAGEWINDOWHWND message.
  
  Specify the following to display status area text:

  BKA_STATUSTEXTON

  Page is to be displayed with status area text. If this attribute is not specified, the application cannot associate a text string with the status area of the page being inserted.
  
  Specify one of the following if the page is to have a major or minor tab attribute:

  BKA_MAJOR

  Inserted page will have a major tab attribute.
  BKA_MINOR
  Inserted page will have a minor tab attribute.

  usPageOrder (USHORT)

  Order attributes.

  Placement of page relative to the previously inserted pages. You can specify one of the following attributes:

  BKA_FIRST

  Insert page at the front of the notebook. The page ID specified in the ulPageId parameter for param1 is ignored if this is specified.
  BKA_LAST
  Insert page at the end of the notebook. The page ID specified in the ulPageId parameter for param1 is ignored if this is specified.
  BKA_NEXT
  Insert page after the page whose ID is specified in the ulPageId parameter for param1. If the page ID specified in the ulPageId parameter is invalid, NULL is returned and no page is inserted.
  BKA_PREV
  Insert page before the page whose ID is specified in the ulPageId parameter for param1. If the page ID specified in the ulPageId parameter is invalid, NULL is returned and no page is inserted.

  ulPageId (ULONG)

  Page ID for insertion.

  Identifier for the inserted page.

  NULL

  The page was not inserted into the notebook. An invalid page ID was specified for the ulPageId parameter for param1 or not enough space was available to allocate the page data.
  Other
  Identifier for the inserted page.

  ---

  [Back: BKM_INSERTPAGE Return Value - ulPageId]
  [Next: BKM_INSERTPAGE - Syntax]