Position Control

Download Position.ocx Visual Studio Control

The Position Control complies with the NMEA sentence protocol $xxRMC [Recommended Minimum Navigation Information] and the Garmin proprietary sentence $GPRMZ [Altitude Information]. Almost everything about this control is configurable by you (the programmer); display options are built into the control for the end user to specify formats for date and time and latitide and longitude. The control is completely resizable.

The banded compass may be hidden and revealed in two different ways: using the ShowCompass Property or the ClickSwapShowCompass Property. The former property allows you as the programmer to turn the compass image visible and invisible; the latter property allows you as the programmer to let the end user use the mouse cursor and left mouse button to toggle between visible and invisible banded compass display. If the ClickSwapShowCompass Property is enabled, the und user may "mouse-click" on the compass to hide it; to unhide the compass, the end user "mouse-clicks" the track/speed/alt section of the control.

There are three different latitude/longitude formats to choose from. The LocationFormatType Property selects between the following:

0 - dd mm ss.ss
1 - dd mm.mmm
2 - dd.ddddd

If the ClickSwapPositionEnabled Property is enabled, the end user may use the mouse cursor to "mouse-click" on the location fields and the control will toggle through the available formats in sequence.



There are four different date formats to choose from. The DateFormatType Property selects between the following:

0 - YYYY/MM/DD
1 - YY/MM/DD
2 - YYYY/MMM/DD
3 - YY/MMM/DD

If the ClickSwapDateEnabled Property is enabled, the end user may use the mouse cursor to "mouse-click" on the date field and the control will toggle through the available formats in sequence.

The TimeFormatType Property changes from a 24-hour time notation (type 0) to an AM/PM notation (type 1). The default date and time shown is from the NMEA stream (GPS), though one may use the UseComputerDateTime Property to tell the control to use the computer's date and time. The time function works with the TimeZone Property and the UseGMT Property to set the date and time to the user's correct local mean time or to Zulu / UTC / Greenwich Mean Time.


The Night and Twilight Properties conform to the same color scheme as the other NMEA Sage Control Suite, though one may also set the colors within the control, as well as specify the compass tick mark location, tick mark colors, degress to span within the compass, and other control aspects.
Events:

Resize
PositionError
Click [if ClickSwaps are not enabled]

Methods:

BlankControl
RMC
RMZ

Properties:

Alignment
Appearance
BackColor
BorderStyle
CardinalAlign
CardinalFontSize
CenterLineColor
ClickSwapDateEnabled
ClickSwapPositionEnabled
ClickSwapShowCompass
ClickSwapTimeEnabled
DateFormatType
DegreeSpan
ErrorDescription
ErrorNumber
FiveTickColor
FontColor
LocationFormatType
Night
OneTickColor
ScaleTicks
ShowCardinals
ShowCenterLine
ShowCompass
ShowFiveTick
ShowOneTick
ShowTenTick
TenTickColor
TimeFormatType
TimeZone
Twilight
UseComputerDateTime
UseGMT

Error Codes

0 - No Current Error
1 - RMZ NMEA sentence appears malformed. It must start with $
2 - RMZ NMEA sentence is not a valid $..RMZ sentence
3 - RMZ Sentence $..RMZ appears malformed
4 - RMC NMEA sentence appears malformed. It must start with $
5 - RMC NMEA sentence is not a valid $..RMC sentence
6 - RMC Sentence $..RMC appears malformed
7 - Appearance must be 0 or 1
8 - BorderStyle must be 0 or 1
9 - DegreeSpan value out of range. Valid range: from 6 to 359 inclusive
10 - Tick Alignment must be 0 (top) or 1 (bottom)
11 - TimeZone must be from -12 to 12
12 - CardinalAlign must be 0 (top), 1 (center), or 2 (bottom)
13 - TimeFormatType must be 0 or 1
14 - DateFormatType must be 0, 1, 2, or 3
15 - LocationFormatType must be 0, 1, or 2
NMEA Sage Home Page

The Banded Compass Control
The Compass Control
The North Biased Compass Control
The Goto Control
Course and Speed (Ground)
The Position Control
Engine RPM Control
The Rudder Control
The GPS Satellite Health Control
The GPS Satellite Elevation Control
Set and Drift control
The NMEA Talker Control
Depth and Water Temperature Control
The Wind Control
The Cross Track Alarm Control
The Pilot Control
Waypoint Plotter Control
Radar Control
Goto Simple Control