3.45  tab-panel%

Superclass: vertical-panel%

A tab panel arranges its subwindows in a single column, but also incudes a horizontal row of tabs at the top of the panel. See also panel%.

The tab-panel% class does not implement the virtual swapping of the panel content when a new tab is selected. Instead, it merely invokes a callback procedure to indicate that a user changed the tab selection.

• (new tab-panel% (choices _) (parent _) (callback _) [(style _)] [(enabled _)] [(vert-margin _)] [(horiz-margin _)] [(border _)] [(spacing _)] [(alignment _)] [(min-width _)] [(min-height _)] [(stretchable-width _)] [(stretchable-height _)]) -> tab-panel% object
     choices : list of strings (up to 200 characters each)
     parent : frame%, dialog%, panel%, or pane% object
     callback : procedure of two arguments: a tab-panel% object and a control-event% object
     style = null : list of symbols in '(no-border deleted)
   enabled = #t : boolean
     vert-margin = 0 : exact integer in [0, 1000]
     horiz-margin = 0 : exact integer in [0, 1000]
     border = 0 : exact integer in [0, 1000]
     spacing = 0 : exact integer in [0, 1000]
     alignment = '(center top) : two-element list: 'left, 'center, or 'right and 'top, 'center, or 'bottom
   min-width = 0 : exact integer in [0, 10000]
     min-height = 0 : exact integer in [0, 10000]
     stretchable-width = #t : boolean
     stretchable-height = #t : boolean

  Creates a tab pane, where the choices list specifies the tab labels.

  Each string in choices can contain an ampersand, which (in the future) may create a mnemonic for clicking the corresponding tab. A double ampersand is converted to a single ampersand.

  The callback procedure is called (with the event type 'tab-panel) when the user changes the tab selection.

  If the style list includes 'no-border, no border is drawn around the panel content. If style includes 'deleted, then the tab panel is created as hidden, and it does not affect its parent's geometry; the tab panel can be made active later by calling parent's add-child method.

  For information about the enabled argument, see window<%>. For information about the horiz-margin and vert-margin arguments, see subarea<%>. For information about the min-width, min-height, stretchable-width, and stretchable-height arguments, see area<%>.

  
  

Methods
    append
    delete
    get-number
    get-selection
    set-selection

All Methods
    accept-drop-files from window<%>
    add-child from area-container<%>
    after-new-child from area-container<%>
    append from tab-panel%
    begin-container-sequence from area-container<%>
    border from area-container<%>
    change-children from area-container<%>
    client->screen from window<%>
    container-flow-modified from area-container<%>
    container-size from area-container<%>
    delete from tab-panel%
    delete-child from area-container<%>
    enable from window<%>
    end-container-sequence from area-container<%>
    focus from window<%>
    get-alignment from area-container<%>
    get-children from area-container<%>
    get-client-size from window<%>
    get-control-font from area-container-window<%>
    get-cursor from window<%>
    get-graphical-min-size from area<%>
    get-height from window<%>
    get-label from window<%>
    get-label-font from area-container-window<%>
    get-label-position from area-container-window<%>
    get-number from tab-panel%
    get-parent from area<%>
    get-plain-label from window<%>
    get-selection from tab-panel%
    get-size from window<%>
    get-top-level-window from area<%>
    get-width from window<%>
    get-x from window<%>
    get-y from window<%>
    has-focus? from window<%>
    horiz-margin from subarea<%>
    is-enabled? from window<%>
    is-shown? from window<%>
    min-height from area<%>
    min-width from area<%>
    on-drop-file from window<%>
    on-focus from window<%>
    on-move from window<%>
    on-size from window<%>
    on-subwindow-char from window<%>
    on-subwindow-event from window<%>
    on-superwindow-enable from window<%>
    on-superwindow-show from window<%>
    place-children from area-container<%>
    popup-menu from window<%>
    reflow-container from area-container<%>
    refresh from window<%>
    screen->client from window<%>
    set-alignment from area-container<%>
    set-control-font from area-container-window<%>
    set-cursor from window<%>
    set-label from window<%>
    set-label-font from area-container-window<%>
    set-label-position from area-container-window<%>
    set-selection from tab-panel%
    show from window<%>
    spacing from area-container<%>
    stretchable-height from area<%>
    stretchable-width from area<%>
    vert-margin from subarea<%>