About GPS ToolKit
Introduction
Purchasing GPS ToolKit
Redistributing GPS ToolKit
License Agreement
Support
Getting Started
How to Use GPS ToolKit
Adding GPS ToolKit to a Visual Basic Project
Adding GPS ToolKit to a Visual C++ Project
Adding GPS ToolKit to an Excel Worksheet
Setting up the GPS
How to Use Events
Handling Events in Visual Basic
Handling Events in Visual C++
Handling Events in Microsoft Excel
GPS ToolKit Sample Projects
Handling GPS ToolKit Errors
Reference
Properties
Altitude
AltitudeUnits
ArrivedAtDest
AutomaticOperation
BaudRate
CrossTrackError
DegLabel
DestClosingVelocity
DestWptID
DestWptLatitude
DestWptLongitude
DistUnits
DGPSRefStationID
FixDateTime
FixGood
FixQuality
FixSatellitePRNs
GeoidHeightAboveWGS84Ellipsoid
HDOP
Latitude
LatLonFormat
Longitude
MagVariation
MinLabel
ModeIndicator
NumSatellitesInFix
NumSatellitesInView
OperationMode
OrigToDestMagBearing
OrigToDestTrueBearing
OriginWptID
PDOP
PortHandle
PortName
RangeToDest
RouteContainsAllWpts
RouteName
SatelliteInViewPRNs
SecLabel
Speed
SpeedUnits
TimeSinceLastDGPSUpdate
TrueBearingToDest
TrueCourse
VDOP
WptsInRoute
Methods
Close
GetSatelliteInfo
GetWptLocation
Open
OpenFile
Events
FixUpdate
FileComplete
NavUpdate
RawDataReceived
SatelliteUpdate

NavUpdate Event

Triggered when new satellite information has been received from the GPS.

Syntax

Visual Basic

Private Sub GPSToolKitObject_NavUpdate(ByVal OriginWptID As Variant, ByVal DestWptID As Variant, ByVal DestWptLatitude As Variant, ByVal DestWptLongitude As Variant, ByVal TrueBearingToDest As Variant, ByVal RangeToDest As Variant, ByVal CrossTrackError As Variant, ByVal DestClosingVelocity As Variant, ByVal DestArrivalAlarm As Variant, ByVal RouteName As Variant, ByVal WptsInRoute As Variant)

Visual C++

void CMyWindowName::OnSatelliteUpdateGpstoolkit(const VARIANT FAR& OriginWptID, const VARIANT FAR& DestWptID, const VARIANT FAR& DestWptLatitude, const VARIANT FAR& DestWptLongitude, const VARIANT FAR& TrueBearingToDest, const VARIANT FAR& RangeToDest, const VARIANT FAR& CrossTrackError, const VARIANT FAR& DestClosingVelocity, const VARIANT FAR& DestArrivalAlarm, const VARIANT FAR& RouteName, const VARIANT FAR& WptsInRoute)

Arguments

Argument Description
OriginWptID a VARIANT (type VT_BSTR/BSTR/VB String) containing the ID (name) of the current origin waypoint
DestWptID a VARIANT (type VT_BSTR/BSTR/VB String) containing the ID (name) of the current destination waypoint
DestWptLatitude a VARIANT (type VT_BSTR/BSTR/VB String) containing the last reported destination waypoint latitude
DestWptLongitude a VARIANT (type VT_BSTR/BSTR/VB String) containing the last reported destination waypoint longitude
TrueBearingToDest a VARIANT (type VT_R8/double) containing the last reported true bearing value in degrees
RangeToDest a VARIANT (type VT_R8/double) containing the last reported range value
CrossTrackError a VARIANT (type VT_BSTR/BSTR/VB String) containing the last reported cross track error
DestClosingVelocity a VARIANT (type VT_R8/double) containing the velocity component in the direction of the current destination waypoint
DestArrivalAlarm a VARIANT (type VT_BOOL/bool) containing the destination arrival status.
RouteName a VARIANT (type VT_BSTR/BSTR/VB String) containing the name of the currently selected route
WptsInRoute a VARIANT array (type VT_ARRAY/SAFEARRAY/VB Array) containing elements of VARIANTs (type VT_BSTR/BSTR/VB String) which holds the ID (name) of the waypoint

Remarks

  • This event is fired when the $GPRMB, $GPBOD, or $GPRTE sentence is received.
  • All arguments passed into this function behave just as the properties of the same name including their units and interpretations.
  • See Using GPS ToolKit Events for information and instructions regarding GPS ToolKit event handling.

Errors

None

See Also

OriginWptID property, DestWptID property, DestWptLatitude property, DestWptLongitude property, TrueBearingToDest property, RangeToDest property, CrossTrackError property, SatelliteInViewPRNs property, DestClosingVelocity property, ArrivedAtDest property, RouteName property, WptsInRoute property, Using GPSToolKit Events, Handling Events in Visual C++, Handling Events in Visual Basic