 |
Getting Started |
|
|
SatelliteUpdate Event
Triggered when new satellite information has been received from the GPS.
Syntax
Visual Basic
Private Sub GPSToolKitObject_SatelliteUpdate(ByVal AutomaticOperation As Variant, ByVal OperationMode As Variant, ByVal NumSatellitesInView As Variant, ByVal HDOP As Variant, ByVal PDOP As Variant, ByVal VDOP As Variant, ByVal FixSatellitePRNs As Variant, ByVal SatelliteInViewPRNs As Variant)
Visual C++
void CMyWindowName::OnSatelliteUpdateGpstoolkit(const VARIANT FAR& AutomaticOperation, const VARIANT FAR& OperationMode, const VARIANT FAR& NumSatellitesInView, const VARIANT FAR& HDOP, const VARIANT FAR& PDOP, const VARIANT FAR& VDOP, const VARIANT FAR& FixSatellitePRNs, const VARIANT FAR& SatelliteInViewPRNs)
Arguments
| Argument
| Description |
| AutomaticOperation |
a VARIANT (type VT_BOOL/bool) containing the current automatic/manual GPS mode |
| OperationMode |
a VARIANT (type VT_I2/short) containing the current operation mode of the GPS |
| NumSatellitesInView |
a VARIANT (type VT_I2/short) containing the number of satellites currently in view |
| HDOP |
a VARIANT (type VT_R8/double) containing the current horizontal dilution of precision |
| PDOP |
a VARIANT (type VT_R8/double) containing the current positional dilution of precision |
| VDOP |
a VARIANT (type VT_R8/double) containing the current vertical dilution of precision |
| FixSatellitePRNs |
a VARIANT (type VT_ARRAY|VT_VARIANT / VB array) containing an array of PRN numbers (unique ID numbers) of the satellites used in the current fix |
| SatelliteInViewPRNs |
a VARIANT (type VT_ARRAY|VT_VARIANT / VB array) containing an array of PRN numbers (unique ID numbers) of the satellites in view |
Remarks
- This event is fired when the $GPGSA or $GPGSV 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
AutomaticOperation property, OperationMode property, NumSatellitesInView property,
HDOP property, PDOP property,
VDOP property, FixSatellitePRNs property, SatelliteInViewPRNs property,
GetSatelliteInfo method,
Using GPSToolKit Events, Handling Events in Visual C++, Handling Events in Visual Basic
|
