Zum Hauptinhalt springen

WinHitTest

obj -> WinHitTest(obj1, point2, var bigint3, var handle4, var bigint5) : int;​

Ausführbar von Clients mit grafischer Oberfläche Ausführbar vom Server Ausführbar von der DLL-Schnittstelle mit grafischer Erweiterung Ausführbar von der Web-Schnittstelle Ausführbar vom Druckprozessor Ausführbar von der ODBC-Schnittstelle Ausführbar vom SOA-Service mit grafischer Erweiterung

Oberflächen-Objekt-Informationen ermitteln

Details

  • obj1: Abzufragendes Objekt
  • point2: Abzufragende Positon
  • bigint3: Ermittelte Information (Hit-Test)
  • handle4: Ermittelte Information (Handle)
  • bigint5: Ermittelte Information (ID)
  • Resultat: int Hit-Test Ergebnis (siehe Text)
  • Siehe: WinSearch () , HdlInfo ()

Mit dem Befehl können Informationen zu Oberflächenelementen an einer gegebenen Position ermittelt werden. Im Argument (obj1) wird der Deskriptor des Objektes übergeben, dass abgefragt werden soll. Das Argument (point2) definiert die abzufragende Position innerhalb des Objektes. Die Position (0,0) bezieht sich auf die linke obere Ecke des Objektes.

Sofern Informationen an der gegebenen Position vorhanden sind, liefert der Befehl das Resultat _ErrOk. In den Argumenten (bigint3), (handle4) und (bigint5) stehen dann die ermittelten objektspezifschen Informationen. Eine Beschreibung zu den Argumenten findet sich beim Ereignis EvtMouseItem.

Der Befehl unterstützt folgende Fensterobjekte:

Canvas , Calendar , DataList , DataListPopup , DocView , GanttGraph , GroupTile , PrtJobPreview , RecList , RecListPopup , RecNavigator , RecView , StoList , StoListPopup , Statusbar , Toolbar , ToolbarRtf , TreeView .

Mögliche Laufzeitfehler:

  • _ErrHdlInvalid: Bei (obj1( handelt es sich nicht um eines der unterstützten Fensterobjekte.
  • _ErrUnavailable: Keine Informationen an der angegebenen Position verfügbar.