WinRvwColumn

obj -> WinRvwColumn(point1[, int2]) : int;

Spalte eines RecView von einer Koordinate ermitteln

Details

• obj: RecView -Objekt
• point1: Position relativ zur linken oberen Ecke des RecView -Objektes
• int2:
  • Optionen (optional):
  • _WinRvwColumnHitHeader
• Resultat: int Spaltendeskriptor oder 0
• Siehe: Verwandte Befehle

Mit diesem Befehl ist es möglich, ausgehend von einer gegebenen Koordinate (point1), den Deskriptor der Spalte zu ermitteln. Dies ist insbesondere im Ereignis EvtMouseItem hilfreich, wenn dort der Spaltendeskriptor benötigt wird.

Der Rückgabewert liefert den Deskriptor der Spalte an der gegebenen Position oder 0. Ein Deskriptor wird zurückgegeben, wenn die Position (point1) innerhalb des Anzeigebereiches des RecView liegt (ohne Spaltenköpfe und ohne Scrollbars). Sollen die Spaltenköpfe berücksichtigt werden, dann kann die Option (int2) _WinRvwColumnHitHeader angegeben werden.

Beispiel:

sub EvtMouseItem
(
  aEvt                 : event;    // Ereignis
  aButton              : int;      // Maustaste
  aHitTest             : int;      // Hittest-Code
  aItem                : handle;   // Spalte oder Gantt-Intervall
  aID                  : bigint;   // RecID bei RecList / Zelle bei GanttGraph / Druckobjekt bei PrtJobPreview
)
: logic;                           // Ereignis an auslösendes Objekt weitergeben?

  local
  {
    tColumn            : handle;   // Spalte des RecView-Objektes
  }

{
  if (aEvt:Obj->wpName = 'rvwCustomers' and aHitTest = _WinHitGroup)
  {
    // Spalte ermitteln
    tColumn # aEvt:Obj->WinRvwColumn(aEvt:Pos);

    // ...
  }

  return (true);
}

Mögliche Laufzeitfehler:

• _ErrHdlInvalid: In (obj) wurde kein gültiger Deskriptor eines RecView -Objektes angegeben.
• _ErrValueInvalid: In (int2) wurde eine ungültige Option angegeben.