Repository.Unit.GetAllUnits: Difference between revisions

From ReliaWiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(16 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Template:APIBreadcrumb|10|Repository}}
{{Template:API}}{{Template:APIBreadcrumb|.[[Repository Class|Repository]]}}
{{Template:API}}
 
Returns a '''[[UnitInfo Class|UnitInfo]]''' object array that contains the name, ID number, abbreviation and multiplier of all predefined units in the current repository. In Synthesis desktop applications, these units are shown in the Manage Units window.  
 
<onlyinclude>Returns an array of '''[[UnitInfo Class|UnitInfo]]''' objects that represent the units of measurement associated with the Repository object.</onlyinclude>


== Syntax ==
== Syntax ==
''object''.'''Project.GetAllUnits()'''
'''.Unit.GetAllUnits()'''


where ''object'' is a variable that represents a Repository object.


== Example ==
== Example ==
  '''VBA|VB.NET'''<br>
  '''VBA|VB.NET'''
  {{APIPrefix|Dim}} MyRepository {{APIPrefix|As New}} Repository
  {{APIComment|...'Add code to connect to a Synthesis repository and set the first project in the repository as the current project.}} <br>
{{APIComment|'Declare a new Repository object and connect to a Synthesis repository.}}
  {{APIPrefix|Dim}} ListOfUnits() {{APIPrefix|As}} UnitInfo
  {{APIPrefix|Dim}} MyRepository {{APIPrefix|As New}} Repository
  ListOfUnits = MyRepository.Unit.GetAllUnits()<br>
  MyRepository.ConnectToAccessRepository({{APIString|"C:\RSRepository1.rsr10"}})
  {{APIComment|'Output example: Get the name and ID of the first available unit in the repository and display them in a message box.}}
 
  Dim UnitName {{APIPrefix|As}} String
  {{APIComment|'Get a list of all defined units in the repository.}}
  Dim UnitID {{APIPrefix|As}} Integer<br>
  {{APIPrefix|Dim}} ListOfUnits() {{APIPrefix|As}} UnitInfo
  UnitName = ListofUnits(0).Name
  ListOfUnits = MyRepository.Unit.GetAllUnits()
  UnitID = ListofUnits(0).ID
  MsgBox ({{APIString|"The first available unit is: "}} & UnitName & {{APIString|", ID#"}} & UnitID)
  {{APIComment|'Output sample: Display the number of elements in the array.}}
  {{APIPrefix|Dim}} NumberofElements {{APIPrefix|As}} Integer
  NumberofElements = UBound(ListofUnits) - LBound(ListofUnits) + 1
  MsgBox (NumberofElements)

Latest revision as of 18:55, 9 June 2016

APIWiki.png


Member of: SynthesisAPI.Repository


Returns an array of UnitInfo objects that represent the units of measurement associated with the Repository object.

Syntax

.Unit.GetAllUnits()


Example

VBA|VB.NET

 'Declare a new Repository object and connect to a Synthesis repository. 
  Dim MyRepository As New Repository
  MyRepository.ConnectToAccessRepository("C:\RSRepository1.rsr10")
  
 'Get a list of all defined units in the repository. 
  Dim ListOfUnits() As UnitInfo
  ListOfUnits = MyRepository.Unit.GetAllUnits()

 'Output sample: Display the number of elements in the array. 
  Dim NumberofElements As Integer
  NumberofElements = UBound(ListofUnits) - LBound(ListofUnits) + 1
  MsgBox (NumberofElements)