Class: DSVLabelView

• Inheritance
• Description
• Class protocol
  • accessing
  • defaults
• Instance protocol
  • accessing
  • drawing
  • enumerating columns
  • event handling
  • focus handling
  • help
  • initialization
  • instance creation
  • queries
  • scrolling
• Private classes

Inheritance:

   Object
   |
   +--GraphicsMedium
      |
      +--DisplaySurface
         |
         +--SimpleView
            |
            +--DSVLabelView

Package:

stx:libwidg2

Category:

Views-DataSet

Version:

rev: 1.89 date: 2023/07/15 18:36:33

user: cg

file: DSVLabelView.st directory: libwidg2

module: stx stc-classLibrary: libwidg2

Description:

shows the labels assigned to the column descriptions. 
Used as the title-part of a DataSetView.

[Instance variables:]

    dataSet         <DSVColumnView>         column view which shows the columns

    selection       <Integer or nil>        current selected index or nil.

    enabled         <Boolean>               if a press action exists on a column
                                            entry, this action could be enabled or
                                            disabled.

    preferredHeight <Integer>               the preferred height of the labelView

copyright
COPYRIGHT (c) 1997 by Claus Gittinger / eXept Software AG
             All Rights Reserved

This software is furnished under a license and may be used
only in accordance with the terms of that license and with the
inclusion of the above copyright notice.   This software may not
be provided or otherwise made available to, or used by, any
other person.  No title to or ownership of the software is
hereby transferred.

Class protocol:

 tabSpacing

returns the tab spacing

 defaultFont

Instance protocol:

 columns: aListOfColumns

the list of columns changed

 dataSet

 indexOfSortColumn

 opaqueColumnResize

 opaqueColumnResize: aBoolean

 reverseSort

 invalidate

(comment from inherited method)
add a damage to redraw the receiver to its input event queue.
This is preferable to calling redraw directly, in that the drawing is done by
the view's process itself, and there is a possibilty to merge
multiple damage rectangles into single redraws.
However, be aware, that the redrawing may be delayed for some time,
until the receiver's windowGroupProcess gets rescheduled.

 invalidateItemAt: anIndex

invalidate rectangle assigned to an item at an index

 redrawColumnsInX: x y: y width: w height: h

redraw a rectangle

 redrawEdgesX: x y: yTop width: aWidth height: aHeight

redraw the edges in the range

 redrawX: xArg y: y width: wArg height: h

(comment from inherited method)
redraw part of myself immediately, given logical coordinates
(if transformation is nonNil)
The default here is to redraw everything
- subclasses usually redefine this, adding more intelligence

 columnsDo: aOneArgBlock

evaluate the argument, aOneArgBlock for every column

 buttonMotion: state x: x y: y

mouse-button was moved;
redraw thumb at its new position and, if scroll-mode is asynchronous,
the scroll action is performed

 buttonPress: button x: x y: y

handle a button press event; checks whether the item under the mouse
is selectable. If true, the selection is set to the item.

 buttonRelease: button x: x y: y

handle a button press event; checks whether the item under the mouse
is the selected item. If true, the application is informed.

 fontChanged

invoked after the font has changed

 mouseWheelZoom: amount

(comment from inherited method)
CTRL-wheel action.
ignored here - redefined in views which can zoom

 pointerLeave: state

mouse left view - restore cursor.

 sendClickMsgForColumnNr: colNr

inform the receiver of a button release notification

 xVisibleToColNr: x

returns the column number for a physical x position.
Returns nil if x is beyond the last column.

 canTab

 wantsFocusWithButtonPress

never wants the focus - view which keeps the labels

 helpTextAt: aPoint

return the helpText for aPoint (i.e. when mouse-pointer is moved over an item).

 initStyle

self level:0.

 initialize

super level:(self defaultLevel).

 sortByColumnIndex: columnIndex

pre-set the column sort order.
Negative columnIndex means reverse sort.

 for: aColumnView

initialization

 realize

recompute contents and fit columns to view

 columnIndexOfDescription: aColumnDescription

 computePreferredExtent

(comment from inherited method)
return my computed preferred extent - this is the minimum size I would like to have.
If there are any components, a rectangle enclosing them
is returned. Otherwise, the actual extent is returned.

 enabled

true, if widget is enabled

 enabled: aBoolean

true, if widget is enabled

 indexOfLabel: aLabel

 preferredHeight

 xVisibleOfColNr: colNr

must adjust, because dataset includes its own margin, which might be different from ours

 xVisibleToSelectionIndex: x

returns the column number assigned to a physical x or nil. If
the column exists but is not selectable nil is returned.

 copyFromX: x0 y: y0 toX: x1 y: y1 width: w invalidateX: leftX

Private classes:

    LineDrag