ISProfile.FindCDOPsysUnitByText

Description

This function returns CDO Physical Units by the text.

Syntax

object.FindCDOPsysUnitByText(aText)

Part	Attribute	Type	Description
`object`	Required	ISProfile	The `object` always implements the ISProfile interface
`aText`	In, Required	string	The text that should be found

Return Value

ISCDOPhysUnit

Returns CDO Physical Units by the text.

Example

Display the number of the physical units of the specified physical quantity and some information about them, including their names and values converted into the source physical unit.

Dim aSrcUnit, aUnit
Dim aPhysQuantity
Dim aValue
Dim i
Dim aMessage

set aSrcUnit = Profile.FindCDOPsysUnitByText("g")
set aPhysQuantity = aSrcUnit.PhysQuantity

aMessage = "Source Physical Unit: " & aSrcUnit.Name & vbNewLIne &_
  "Physical Quantity System Unit: " & aPhysQuantity.SysUnit.Name & vbNewLIne &_
  "Other Units of the Physical Quantity: "

for i = 0 to aPhysQuantity.PhysUnitCount - 1
  set aUnit = aPhysQuantity.PhysUnit(i)
  aValue = aSrcUnit.ConvertValue(1, aUnit) 
  
  aMessage = aMessage & vbNewLine & (i + 1) & ") " & aUnit.Name &_
    " (= " & aValue  & " " & aSrcUnit.Name & ")"
next 
 
Profile.MsgBox(aMessage)

Note:

In Profile Client v8 on User Interface CDO Psysical Units can be found in Maintain > Units and measures.

Version information

Added in v7.8.0