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

PortName Property

Returns the name of the port ("COM1", "COM2", etc.).

Syntax

Visual Basic

object.PortName

Visual C++

object.GetPortName()

Part Description
object An object expression that evaluates to a GPS ToolKit object.

Example

Visual Basic

'Get port name
Dim portName As String
portName = myGPSToolKit.PortName

Visual C++

_variant_t vtPortName;

// Get port name
vtPortName = m_myGPSToolKit.GetPortName();
_bstr_t convBSTR = (_bstr_t)vtPortName;
CString strPortName = (LPCSTR)convBSTR;

Remarks

None

Returns

A VARIANT (type VT_BSTR/BSTR/VB String) containing the name of the open port.

Errors

Reading the PortName property while the port is closed is not permitted and will cause GPS ToolKit to throw a "Port is closed" exception.

See Also

Open(), PortHandle