TableView
=========

A :class:`View` sublass that represents Cocoa's ``NSTableView``. Note that although it's a view and
that views are added to their superview, ``xibless`` wraps the view into a ``NSScrollView`` and
adds that view to the superview (XCode does the same). The reference to the table view, however
(if you do stuff like ``owner.table = Table(superview)``) will be the reference of the
``NSTableView`` instance.

.. class:: TableView(parent)
    
    :param parent: A :class:`View` instance. Same as :attr:`View.parent`.
    
    .. method:: addColumn(identifier, title, width)
        
        :param identifier: String. See :attr:`TableColumn.identifier`.
        :param title: String. See :attr:`TableColumn.title`.
        :param width: Integer. See :attr:`TableColumn.width`.
        
        Creates a :class:`TableColumn` and adds it to self. The created item is returned by the
        method.
    
    .. attribute:: allowsColumnReordering
    .. attribute:: allowsColumnResizing
    .. attribute:: allowsColumnSelection
    .. attribute:: allowsEmptySelection
    .. attribute:: allowsMultipleSelection
    .. attribute:: allowsTypeSelect
        
        *Boolean*. Sets the corresponding flag in ``NSTableView``. Default values are the same as
        in ``NSTableView``.
    
    .. attribute:: alternatingRows
        
        *Boolean*. Whether rows have an alternating background colors. In Cocoa, it's
        ``usesAlternatingRowBackgroundColors``.
    
    .. attribute:: gridStyleMask
        
        :ref:`Cocoa constant <literal-consts>`. Style of the table grid lines, if any. Use
        ``NSTableViewGridLineStyle`` constants.
    
    .. attribute:: borderType
        
        :ref:`Cocoa constant <literal-consts>`. Border type of the enclosing scroll view. Use
        ``NSBorderType`` constants.
    
    .. attribute:: font
    .. attribute:: editable
    
        If you set these attributes before adding your columns, all added columns will copy this
        attribute.

ListView
--------

A convenience subclass of :class:`TableView`. It also represents a ``NSTableView``, but it sets the
table so that it has only one column that resizes with the table and no header view.

.. class:: ListView(parent)
    
    :param parent: A :class:`View` instance. Same as :attr:`View.parent`.

OutlineView
-----------

A :class:`TableView` sublass that represents Cocoa's ``NSOutlineView``.

.. class:: OutlineView(parent)
    
    :param parent: A :class:`View` instance. Same as :attr:`View.parent`.

TableColumn
-----------

The ``TableColumn`` is created by :meth:`TableView.addColumn` and represents a ``NSTableColumn``.
You shouldn't create it directly, but you can set its attributes.

.. class:: TableColumn(table, identifier, title, width)
    
    :param table: The parent :class:`TableView`.
    :param identifier: String. See :attr:`TableColumn.identifier`.
    :param title: String. See :attr:`TableColumn.title`.
    :param width: Integer. See :attr:`TableColumn.width`.
    
    .. attribute:: identifier
        
        *String*. The identifier of the column.
    
    .. attribute:: title
        
        *String*. The title of the column. In Cocoa: ``headerCell.stringValue``.
    
    .. attribute:: width
        
        *Integer*. The width of the column.
    
    .. attribute:: font
        
        :class:`Font`. The font of the column. In Cocoa: ``dataCell.font``.
    
    .. attribute:: editable
        
        *Boolean*. Whether the column can be edited.
    
    .. attribute:: userResizable
        
        *Boolean*. Whether the user can resize the column.
    
    .. attribute:: autoResizable
        
        *Boolean*. Whether the column resizes itself when the table is resized.
    
    .. attribute:: dataCell
        
        :class:`Control` instance. Sets the column's ``dataCell`` attribute to the control's cell.
        During code generation, the code will look like ``[column setDataCell:[control cell]]``.