<?xml version="1.0"?>
<!DOCTYPE gsdoc PUBLIC "-//GNUstep//DTD gsdoc 1.0.0//EN" "http://www.gnustep.org/gsdoc-1_0_0.xml">
<gsdoc base="NSBrowser" up="Gui">
  <head>
    <title>NSBrowser</title>
    <author name="Scott Christley">
      <email address="scottc@net-community.com">
        scottc@net-community.com
      </email>
    </author>
    <author name="Felipe A. Rodriguez">
      <email address="far@ix.netcom.com">
        far@ix.netcom.com
      </email>
    </author>
    <author name="Franck Wolff">
      <email address="wolff@cybercable.fr">
        wolff@cybercable.fr
      </email>
    </author>
    <author name="Mirko Viviani">
      <email address="mirko.viviani@rccr.cremona.it">
        mirko.viviani@rccr.cremona.it
      </email>
    </author>
    <author name="Fred Kiefer">
      <email address="FredKiefer@gmx.de">
        FredKiefer@gmx.de
      </email>
    </author>
    <abstract>
      Control to display and select from hierarchal lists
    </abstract>
    <copy>1996, 1997, 2002 Free Software Foundation, Inc.</copy>
  </head>
  <body>
    <front><contents /></front>
    <chapter>
      <heading>
        Software documentation for the NSBrowser class
      </heading>
      <class name="NSBrowser" super="NSControl">
        <declared>AppKit/NSBrowser.h</declared>
        <conform>NSCoding</conform>
        <desc>
          <em>Description forthcoming.</em>
        </desc>
        <method type="Class" factory="yes">
          <sel>cellClass</sel>
          <desc>
            Returns the NSBrowserCell class (regardless of
            whether a setCellClass: message has been sent to a
            particular instance). This method is not meant
            to be used by applications.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="BOOL">
          <sel>acceptsArrowKeys</sel>
          <desc>
            Returns <code>YES</code> if the arrow keys are
            enabled.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>addColumn</sel>
          <desc>
            Adds a column to the right of the last column.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="BOOL">
          <sel>allowsBranchSelection</sel>
          <desc>
            Returns whether the user can select branch items
            when multiple selection is enabled.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="BOOL">
          <sel>allowsEmptySelection</sel>
          <desc>
            Returns whether there can be nothing selected.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="BOOL">
          <sel>allowsMultipleSelection</sel>
          <desc>
            Returns whether the user can select multiple items.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="id">
          <sel>cellPrototype</sel>
          <desc>
            Returns the NSBrowser's prototype NSCell instance.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="int">
          <sel>columnOfMatrix:</sel>
          <arg type="NSMatrix*">matrix</arg>
          <desc>
            Returns the column number in which
            <var>matrix</var> is located.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="id">
          <sel>delegate</sel>
          <desc>
            Returns the NSBrowser's delegate.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>displayAllColumns</sel>
          <desc>
            Updates the NSBrowser to display all loaded
            columns.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>displayColumn:</sel>
          <arg type="int">column</arg>
          <desc>
            Updates the NSBrowser to display the
            <var>column</var> with the given index.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>doClick:</sel>
          <arg type="id">sender</arg>
          <desc>
            Responds to (single) mouse clicks in a column of
            the NSBrowser.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>doDoubleClick:</sel>
          <arg type="id">sender</arg>
          <desc>
            Responds to double-clicks in a column of the
            NSBrowser.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="SEL">
          <sel>doubleAction</sel>
          <desc>
            Returns the NSBrowser's double-click action method.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>drawTitle:</sel>
          <arg type="NSString*">title</arg>
          <sel>inRect:</sel>
          <arg type="NSRect">aRect</arg>
          <sel>ofColumn:</sel>
          <arg type="int">column</arg>
          <desc>
            Draws the <var>title</var> for the <var>column</var>
            at index <var>column</var> within the rectangle defined
            by <var>aRect</var>.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>drawTitleOfColumn:</sel>
          <arg type="int">column</arg>
          <sel>inRect:</sel>
          <arg type="NSRect">aRect</arg>
          <desc>
            <em>Description forthcoming.</em>
          </desc>
          <standards>
            <MacOS-X /> <NotOpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="int">
          <sel>firstVisibleColumn</sel>
          <desc>
            Returns the index of the first visible column.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="NSRect">
          <sel>frameOfColumn:</sel>
          <arg type="int">column</arg>
          <desc>
            Returns the rectangle containing the
            <var>column</var> at index <var>column</var>.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="NSRect">
          <sel>frameOfInsideOfColumn:</sel>
          <arg type="int">column</arg>
          <desc>
            Returns the rectangle containing the
            <var>column</var> at index <var>column</var>,
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="BOOL">
          <sel>hasHorizontalScroller</sel>
          <desc>
            Returns whether an NSScroller is used to scroll
            horizontally.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="BOOL">
          <sel>isLoaded</sel>
          <desc>
            Returns whether column zero is loaded.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="BOOL">
          <sel>isTitled</sel>
          <desc>
            Returns whether columns display titles.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="int">
          <sel>lastColumn</sel>
          <desc>
            Returns the index of the last column loaded.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="int">
          <sel>lastVisibleColumn</sel>
          <desc>
            Returns the index of the last visible column.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>loadColumnZero</sel>
          <desc>
            Loads column zero; unloads previously loaded columns.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="id">
          <sel>loadedCellAtRow:</sel>
          <arg type="int">row</arg>
          <sel>column:</sel>
          <arg type="int">column</arg>
          <desc>
            Loads if necessary and returns the NSCell at
            <var>row</var> in <var>column</var>.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="Class">
          <sel>matrixClass</sel>
          <desc>
            Returns the class of NSMatrix used in the
            NSBrowser's columns.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="NSMatrix*">
          <sel>matrixInColumn:</sel>
          <arg type="int">column</arg>
          <desc>
            Returns the matrix located in the <var>column</var>
            identified by index <var>column</var>.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="int">
          <sel>maxVisibleColumns</sel>
          <desc>
            Returns the maximum number of visible columns.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="int">
          <sel>minColumnWidth</sel>
          <desc>
            Returns the minimum column width in pixels.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="int">
          <sel>numberOfVisibleColumns</sel>
          <desc>
            Returns the number of columns visible.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="NSString*">
          <sel>path</sel>
          <desc>
            Returns the browser's current path.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="NSString*">
          <sel>pathSeparator</sel>
          <desc>
            Returns the path separator. The default is "/".
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="NSString*">
          <sel>pathToColumn:</sel>
          <arg type="int">column</arg>
          <desc>
            Returns a string representing the path from the
            first <var>column</var> up to, but not including, the
            <var>column</var> at index <var>column</var>.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>reloadColumn:</sel>
          <arg type="int">column</arg>
          <desc>
            Reloads <var>column</var> if it is loaded; sets it
            as the last <var>column</var>. Reselects previously
            selected cells, if they remain.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="BOOL">
          <sel>reusesColumns</sel>
          <desc>
            Returns <code>YES</code> if NSMatrix objects aren't
            freed when their columns are unloaded.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>scrollColumnToVisible:</sel>
          <arg type="int">column</arg>
          <desc>
            Scrolls to make the <var>column</var> at index
            <var>column</var> visible.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>scrollColumnsLeftBy:</sel>
          <arg type="int">shiftAmount</arg>
          <desc>
            Scrolls columns left by <var>shiftAmount</var>
            columns.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>scrollColumnsRightBy:</sel>
          <arg type="int">shiftAmount</arg>
          <desc>
            Scrolls columns right by <var>shiftAmount</var>
            columns.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>scrollViaScroller:</sel>
          <arg type="NSScroller*">sender</arg>
          <desc>
            Scrolls columns left or right based on an
            NSScroller.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>selectAll:</sel>
          <arg type="id">sender</arg>
          <desc>
            Selects all NSCells in the last column of the
            NSBrowser.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>selectRow:</sel>
          <arg type="int">row</arg>
          <sel>inColumn:</sel>
          <arg type="int">column</arg>
          <desc>
            Selects the cell at index <var>row</var> in the
            <var>column</var> identified by index
            <var>column</var>.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="id">
          <sel>selectedCell</sel>
          <desc>
            Returns the last (rightmost and lowest) selected
            NSCell.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="id">
          <sel>selectedCellInColumn:</sel>
          <arg type="int">column</arg>
          <desc>
            Returns the last (lowest) NSCell that's selected in
            <var>column</var>.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="NSArray*">
          <sel>selectedCells</sel>
          <desc>
            Returns all cells selected in the rightmost column.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="int">
          <sel>selectedColumn</sel>
          <desc>
            Returns the index of the last column with a
            selected item.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="int">
          <sel>selectedRowInColumn:</sel>
          <arg type="int">column</arg>
          <desc>
            Returns the row index of the selected cell in the
            <var>column</var> specified by index
            <var>column</var>.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="BOOL">
          <sel>sendAction</sel>
          <desc>
            Sends the action message to the target. Returns
            <code>YES</code> upon success, <code>NO</code> if no
            target for the message could be found.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="BOOL">
          <sel>sendsActionOnArrowKeys</sel>
          <desc>
            Returns <code>NO</code> if pressing an arrow key
            only scrolls the browser, <code>YES</code> if it also
            sends the action message specified by setAction:.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="BOOL">
          <sel>separatesColumns</sel>
          <desc>
            Returns whether columns are separated by bezeled
            borders.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>setAcceptsArrowKeys:</sel>
          <arg type="BOOL">flag</arg>
          <desc>
            Enables or disables the arrow keys as used for
            navigating within and between browsers.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>setAllowsBranchSelection:</sel>
          <arg type="BOOL">flag</arg>
          <desc>
            Sets whether the user can select branch items when
            multiple selection is enabled.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>setAllowsEmptySelection:</sel>
          <arg type="BOOL">flag</arg>
          <desc>
            Sets whether there can be nothing selected.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>setAllowsMultipleSelection:</sel>
          <arg type="BOOL">flag</arg>
          <desc>
            Sets whether the user can select multiple items.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>setCellClass:</sel>
          <arg type="Class">classId</arg>
          <desc>
            Sets the class of NSCell used in the columns of the
            NSBrowser.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>setCellPrototype:</sel>
          <arg type="NSCell*">aCell</arg>
          <desc>
            Sets the NSCell instance copied to display items in
            the columns of NSBrowser.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>setDelegate:</sel>
          <arg type="id">anObject</arg>
          <desc>
            Sets the delegate of the receiver. If not
            <code>nil</code>, the delegate must either be
            passive and respond to
            <ref type="method" id="-browser:numberOfRowsInColumn:" class="NSObject">[NSObject&nbsp;-browser:numberOfRowsInColumn:]</ref> or be active and respond to <ref type="method" id="-browser:createRowsForColumn:inMatrix:" class="NSObject">[NSObject&nbsp;-browser:createRowsForColumn:inMatrix:]</ref> but not both. If the delegate is active it must also respond to <ref type="method" id="-browser:willDisplayCell:atRow:column:" class="NSObject">[NSObject&nbsp;-browser:willDisplayCell:atRow:column:]</ref>. If the delegate is not <code>nil</code> but does not meet these conditions, an NSBrowserIllegalDelegateException will be raised.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>setDoubleAction:</sel>
          <arg type="SEL">aSelector</arg>
          <desc>
            Sets the NSBrowser's double-click action to
            <var>aSelector</var>.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>setHasHorizontalScroller:</sel>
          <arg type="BOOL">flag</arg>
          <desc>
            Sets whether an NSScroller is used to scroll
            horizontally.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>setLastColumn:</sel>
          <arg type="int">column</arg>
          <desc>
            Sets the last <var>column</var> to <var>column</var>.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>setMatrixClass:</sel>
          <arg type="Class">classId</arg>
          <desc>
            Sets the matrix class (NSMatrix or an NSMatrix
            subclass) used in the NSBrowser's columns.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>setMaxVisibleColumns:</sel>
          <arg type="int">columnCount</arg>
          <desc>
            Sets the maximum number of columns displayed.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>setMinColumnWidth:</sel>
          <arg type="int">columnWidth</arg>
          <desc>
            Sets the minimum column width in pixels.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="BOOL">
          <sel>setPath:</sel>
          <arg type="NSString*">path</arg>
          <desc>
            <p>
              Parses <var>path</var> and selects corresponding
              items in the NSBrowser columns.
            </p>
            <p>
              This is the primary mechanism for programmatically
              updating the selection of a browser. It should
              result in the browser cells corresponding to the
              components being selected, and the browser
              columns up to the end of <var>path</var> (and
              just beyond if the last selected cell's
              <ref type="method" id="-isLeaf" class="NSBrowserCell">
                [NSBrowserCell&nbsp;-isLeaf]
              </ref>
              returns <code>YES</code>). <br /> It does
              <em>not</em> result in the browsers action being
              sent to its target, just in a change to the browser
              selection and display.
            </p>
            <p>
              If <var>path</var> begins with the
              <ref type="method" id="-pathSeparator">
                -pathSeparator
              </ref>
              then it is taken to be absolute and the first
              component in it is expected to denote a cell in
              column zero. Otherwise it is taken to be relative
              to the currently selected column.
            </p>
            <p>
              Empty components (ie where a
              <ref type="method" id="-pathSeparator">
                -pathSeparator
              </ref>
              occurs immediately after another or at the end of
              <var>path</var>) are simply ignored.
            </p>
            <p>
              The receivers delegate is asked to select each cell
              in turn using the
              <ref type="method" id="-browser:selectCellWithString:inColumn:">-browser:selectCellWithString:inColumn:</ref> method (if it implements it). If this call to the delegate returns <code>NO</code> then the attempt to set the <var>path</var> fails. <br /> If the delegate does not implement the method, the browser attempts to locate and select the cell itsself, and the method fails if it is unable to locate the cell by matching its <ref type="method" id="-stringValue" class="NSCell">[NSCell&nbsp;-stringValue]</ref> with the component of the <var>path</var>.
            </p>
            <p>
              The method returns <code>YES</code> if
              <var>path</var> contains no components or if a cell
              corresponding to the <var>path</var> was
              found. Otherwise it returns <code>NO</code>.
            </p>
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>setPathSeparator:</sel>
          <arg type="NSString*">aString</arg>
          <desc>
            Sets the path separator to newString.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>setReusesColumns:</sel>
          <arg type="BOOL">flag</arg>
          <desc>
            If <var>flag</var> is <code>YES</code>, prevents
            NSMatrix objects from being freed when their
            columns are unloaded, so they can be reused.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>setSendsActionOnArrowKeys:</sel>
          <arg type="BOOL">flag</arg>
          <desc>
            Sets whether pressing an arrow key will cause the
            action message to be sent (in addition to causing
            scrolling).
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>setSeparatesColumns:</sel>
          <arg type="BOOL">flag</arg>
          <desc>
            Sets whether to separate columns with bezeled borders.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>setTakesTitleFromPreviousColumn:</sel>
          <arg type="BOOL">flag</arg>
          <desc>
            Sets whether the title of a column is set to the
            string value of the selected NSCell in the previous
            column.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>setTitle:</sel>
          <arg type="NSString*">aString</arg>
          <sel>ofColumn:</sel>
          <arg type="int">column</arg>
          <desc>
            Sets the title of the <var>column</var> at index
            <var>column</var> to <var>aString</var>.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>setTitled:</sel>
          <arg type="BOOL">flag</arg>
          <desc>
            Sets whether columns display titles.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="BOOL">
          <sel>takesTitleFromPreviousColumn</sel>
          <desc>
            Returns <code>YES</code> if the title of a column
            is set to the string value of the selected NSCell in the
            previous column.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>tile</sel>
          <desc>
            Adjusts the various subviews of
            NSBrowser-scrollers, columns, titles,
            and so on-without redrawing. Your code shouldn't send
            this message. It's invoked any time the appearance of
            the NSBrowser changes.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="NSRect">
          <sel>titleFrameOfColumn:</sel>
          <arg type="int">column</arg>
          <desc>
            Returns the bounds of the title frame for the
            <var>column</var> at index <var>column</var>.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="float">
          <sel>titleHeight</sel>
          <desc>
            Returns the height of column titles.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="NSString*">
          <sel>titleOfColumn:</sel>
          <arg type="int">column</arg>
          <desc>
            Returns the title displayed for the
            <var>column</var> at index <var>column</var>.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>updateScroller</sel>
          <desc>
            Updates the horizontal scroller to reflect column
            positions.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>validateVisibleColumns</sel>
          <desc>
            Invokes delegate method browser:isColumnValid: for
            visible columns.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <standards>
          <MacOS-X /> <OpenStep /> <GNUstep />
        </standards>
      </class>
    </chapter>
    <chapter>
      <heading>
        Software documentation for the
        NSBrowser(GNUstepExtensions)
        category
      </heading>
      <category name="GNUstepExtensions" class="NSBrowser">
        <declared>AppKit/NSBrowser.h</declared>
        <desc>
          <em>Description forthcoming.</em>
        </desc>
        <method type="BOOL">
          <sel>acceptsAlphaNumericalKeys</sel>
          <desc>
            Returns <code>YES</code> if the alphanumerical keys
            are enabled.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="BOOL">
          <sel>sendsActionOnAlphaNumericalKeys</sel>
          <desc>
            Returns <code>NO</code> if pressing an arrow key
            only scrolls the browser, <code>YES</code> if it also
            sends the action message specified by setAction:.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>setAcceptsAlphaNumericalKeys:</sel>
          <arg type="BOOL">flag</arg>
          <desc>
            Enables or disables the arrow keys as used for
            navigating within and between browsers.
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>setSendsActionOnAlphaNumericalKeys:</sel>
          <arg type="BOOL">flag</arg>
          <desc>
            Sets whether pressing an arrow key will cause the
            action message to be sent (in addition to causing
            scrolling).
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <standards>
          <MacOS-X /> <OpenStep /> <GNUstep />
        </standards>
      </category>
    </chapter>
    <chapter>
      <heading>
        Software documentation for the
        NSObject(NSBrowserDelegate)
        informal protocol
      </heading>
      <category name="NSBrowserDelegate" class="NSObject">
        <declared>AppKit/NSBrowser.h</declared>
        <desc>
          <em>Description forthcoming.</em>
        </desc>
        <method type="void">
          <sel>browser:</sel>
          <arg type="NSBrowser*">sender</arg>
          <sel>createRowsForColumn:</sel>
          <arg type="int">column</arg>
          <sel>inMatrix:</sel>
          <arg type="NSMatrix*">matrix</arg>
          <desc>
            <em>Description forthcoming.</em>
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="BOOL">
          <sel>browser:</sel>
          <arg type="NSBrowser*">sender</arg>
          <sel>isColumnValid:</sel>
          <arg type="int">column</arg>
          <desc>
            <em>Description forthcoming.</em>
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="int">
          <sel>browser:</sel>
          <arg type="NSBrowser*">sender</arg>
          <sel>numberOfRowsInColumn:</sel>
          <arg type="int">column</arg>
          <desc>
            <em>Description forthcoming.</em>
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="BOOL">
          <sel>browser:</sel>
          <arg type="NSBrowser*">sender</arg>
          <sel>selectCellWithString:</sel>
          <arg type="NSString*">title</arg>
          <sel>inColumn:</sel>
          <arg type="int">column</arg>
          <desc>
            <em>Description forthcoming.</em>
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="BOOL">
          <sel>browser:</sel>
          <arg type="NSBrowser*">sender</arg>
          <sel>selectRow:</sel>
          <arg type="int">row</arg>
          <sel>inColumn:</sel>
          <arg type="int">column</arg>
          <desc>
            <em>Description forthcoming.</em>
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="NSString*">
          <sel>browser:</sel>
          <arg type="NSBrowser*">sender</arg>
          <sel>titleOfColumn:</sel>
          <arg type="int">column</arg>
          <desc>
            <em>Description forthcoming.</em>
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>browser:</sel>
          <arg type="NSBrowser*">sender</arg>
          <sel>willDisplayCell:</sel>
          <arg type="id">cell</arg>
          <sel>atRow:</sel>
          <arg type="int">row</arg>
          <sel>column:</sel>
          <arg type="int">column</arg>
          <desc>
            <em>Description forthcoming.</em>
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>browserDidScroll:</sel>
          <arg type="NSBrowser*">sender</arg>
          <desc>
            <em>Description forthcoming.</em>
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <method type="void">
          <sel>browserWillScroll:</sel>
          <arg type="NSBrowser*">sender</arg>
          <desc>
            <em>Description forthcoming.</em>
          </desc>
          <standards>
            <MacOS-X /> <OpenStep /> <GNUstep />
          </standards>
        </method>
        <standards>
          <MacOS-X /> <OpenStep /> <GNUstep />
        </standards>
      </category>
    </chapter>
  </body>
</gsdoc>
