Questions about this article, topic, or product? Click here. 

CONNECT APIs

MicroStation CONNECT Edition API Topics listed by Area (or technology).

NOTE: You can also follow the latest MicroStation SDK Blog posts on medium.com.

Cells
Database
Dimensions

DimensionStyles

  • In MicroStation CONNECT call C++ DimensionStyle API in place of mdlDimStyle_xxx() calls.
  • Use DimStyleIterator where mdlDimStyle_traverse was previously used.
  • The C++ APIs have further DGN Library integration options and improvements
  • The MicroStation SDK provides an example to get started: ..\DimensionsExample\DimensionsExampleCreateTool.cpp
  • The following code snip shows how to set the active dimension style to none:
    // Make style:(none) active.
BentleyStatus rtc;
//DimensionStylePtr dimstyle = DimensionStyle::GetActive ();
DimensionStylePtr settings = DimensionStyle::GetSettings (*ISessionMgr::GetActiveDgnFile());
settings->SetName (L"");
rtc = DimensionStyle::SetActive (*settings);
EC

Blogs

Training

Tips

Languages Consider adding a Web Browser add-in; like: e.g. Google Translate; that permits you to view code: pages, blogs and posts; though highly readable in your preferred/desired language. This effectively provides you with greater access to more learning and content materials our communities present.
Instances

Notes

NOTE: Previous versions of “Bentley Class Editor: and “iModel Schema Editor” have been superseded by tools referenced above.

Related
Elements
  • Get/Set Basis Range/Transform
    • Get/Set BasisRange and BasisTransform methods provide a means to store an alternate "basis/home" element range/transform via XAttributes.  If no (application) "basis" is present the range/transform returned will be that directly obtained from the current ElementHandle range/transform. [Ref1]
    • This was implemented to store/return an "element aligned" vs. "axis aligned" box that fits geometry. Similar to the range diagonal for cells/shared cells. A basis range would typically be centered around 0, the basis transform denotes the local to world transform. In practice I haven't found it "generally" useful as it wasn't required to be implemented, meaning you need a fallback for dealing with elements that don't store/return a valid basis range anyway. So, it mostly ends up being useful to applications when dealing with their own elements.[Ref2]
Event Handlers MicroStation .NET APIs utilize Microsoft's .NET EventHandler event delegate system. To identify a complete list of .NET events, open the respective help file (MstnPlatformNET.chm or DgnPlatformNET.chm) and search for: EventHandler.
Geometry
GUI/UI
  • Q: How can I programatically modify the product Ribbon control?
    A: If you currently own an active Telerik development license you can freely consume Telerik APIs and Events published within your (deployed) customizations. If you do not own a Telerik development license you are limited to using the convenient product User/Admin tools and workflows provided within our software. e.g. See: Customizing the Ribbon and Importing and Exporting Ribbon Customizations). Due to our existing Telerik licensing agreement we cannot create/provide (public/published) Bentley APIs that wrap or export this functionality directly.
  • Q: What do I need to do to add Tabs to the Ribbon with a custom XML file?
    A: Tabs must be referenced by a Tab Collection which in turn must be referenced by a Workflow. Here is an example.
    Fullscreen MyRibbon.xml Download 
    <RibbonItems xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="RibbonDefinitions.xsd">
  <Workflows>
    <Workflow Name="MyWorkFlow" Priority="10000">
      <Label>MyWorkFlow</Label>
      <Ribbon>
        <TabCollectionRef>MyTabs</TabCollectionRef>
      </Ribbon>
    </Workflow>
  </Workflows>
  <TabCollections>
    <TabCollection Name="MyTabs">
      <TabRef Name="MyTab1" Priority="1000" MatchProcessing="Override">
        <TabParams>
          <AccessText>H</AccessText>
          <Visibility />
        </TabParams>
      </TabRef>
      <TabRef Name="MyTab2" Priority="1000" MatchProcessing="Override">
        <TabParams>
          <AccessText>H</AccessText>
          <Visibility />
        </TabParams>
      </TabRef>
    </TabCollection>
  </TabCollections>
    <Tabs>
        <Tab Name="MyTab1" Priority="100">
            <Label>MyTab1</Label>
            <TabParams>
                <AccessText />
            </TabParams>
            <TabItems>
                <GroupRef Name="Drawing.Attach.ItemTypes" Priority="10000">
                    <GroupParams>
                        <AccessText>1</AccessText>
                        <GroupLauncherAccessText>1</GroupLauncherAccessText>
                    </GroupParams>
                </GroupRef>
                <GroupRef Name="Modeling.Content.Cells" Priority="20000">
                    <GroupParams>
                        <AccessText>2</AccessText>
                        <GroupLauncherAccessText>2</GroupLauncherAccessText>
                    </GroupParams>
                </GroupRef>
                <GroupRef Name="Modeling.Content.NamedPresentation" Priority="30000">
                    <GroupParams>
                        <AccessText>3</AccessText>
                        <GroupLauncherAccessText>3</GroupLauncherAccessText>
                    </GroupParams>
                </GroupRef>
                <GroupRef Name="PWCatalog" Priority="30000">
                    <GroupParams>
                        <AccessText>G9</AccessText>
                        <GroupLauncherAccessText>9</GroupLauncherAccessText>
                    </GroupParams>
                </GroupRef>
                <GroupRef Name="Personal.ac_gui.Content.CC2.0" Priority="31000" MatchProcessing="Override">
                    <GroupParams>
                        <AccessText />
                        <Visibility />
                    </GroupParams>
                </GroupRef>
            </TabItems>
        </Tab>
        <Tab Name="MyTab2" Priority="20000">
            <Label>MyTab2</Label>
            <TabParams>
                <AccessText>O</AccessText>
                <Visibility />
            </TabParams>
            <TabItems>
                <GroupRef Name="Drawing.Attach.ItemTypes" Priority="10000" MatchProcessing="Override">
                    <GroupParams>
                        <AccessText>1</AccessText>
                        <GroupLauncherAccessText>1</GroupLauncherAccessText>
                        <Visibility />
                    </GroupParams>
                </GroupRef>
                <GroupRef Name="Modeling.Content.Cells" Priority="20000" MatchProcessing="Override">
                    <GroupParams>
                        <AccessText>2</AccessText>
                        <GroupLauncherAccessText>2</GroupLauncherAccessText>
                        <Visibility />
                    </GroupParams>
                </GroupRef>
                <GroupRef Name="Modeling.Content.NamedPresentation" Priority="30000" MatchProcessing="Override">
                    <GroupParams>
                        <AccessText>3</AccessText>
                        <GroupLauncherAccessText>3</GroupLauncherAccessText>
                        <Visibility />
                    </GroupParams>
                </GroupRef>
                <GroupRef Name="PWCatalog" Priority="30000" MatchProcessing="Override">
                    <GroupParams>
                        <AccessText>G9</AccessText>
                        <GroupLauncherAccessText>9</GroupLauncherAccessText>
                        <Visibility />
                    </GroupParams>
                </GroupRef>
            </TabItems>
        </Tab>
    </Tabs>
    <Groups>
        <Group Name="Personal.ac_gui.Content.CC2.0" Priority="31000" PanelType="Collapsible">
            <Label>CC2.0</Label>
            <Icon Type="NamedIcon">
                <NamedIcon>PlaceActivePoint</NamedIcon>
            </Icon>
            <GroupParams>
                <AccessText />
                <Visibility />
            </GroupParams>
            <GroupItems>
                <ButtonRef Name="Personal.ac_gui.Content.CC2.0.Launch1" Priority="1000" MatchProcessing="Override">
                    <ButtonParams Size="Large" CollapseToSmall="WhenGroupIsSmall" CollapseToMedium="WhenGroupIsMedium">
                        <AccessText>GP1</AccessText>
                        <PopupAccessText>M</PopupAccessText>
                        <Visibility />
                    </ButtonParams>
                </ButtonRef>
            </GroupItems>
        </Group>
    </Groups>
    <GroupPanels>
        <GroupPanel Name="Personal.ac_gui.Content.CC2.0.CC2.0" PanelType="VerticalStacked" Priority="0">
            <Label>CC2.0</Label>
            <GroupPanelParams>
                <Visibility />
            </GroupPanelParams>
        </GroupPanel>
    </GroupPanels>
    <Buttons>
        <Button Name="Personal.ac_gui.Content.CC2.0.Launch" Priority="0">
            <ButtonParams Size="Large" CollapseToSmall="WhenGroupIsSmall" CollapseToMedium="WhenGroupIsMedium">
                <AccessText>GP1</AccessText>
                <PopupAccessText>M</PopupAccessText>
                <Visibility />
            </ButtonParams>
            <ButtonData>
                <CommandData Type="UserKeyinCommand">
                    <UserKeyinCommand>
                        <Keyin>bentley.componentscenter.client.microstationaddin helloworld</Keyin>
                        <Icon Type="NamedIcon">
                            <NamedIcon>3D</NamedIcon>
                        </Icon>
                        <Label>Launch</Label>
                        <Description>Launches Components Center</Description>
                    </UserKeyinCommand>
                </CommandData>
            </ButtonData>
        </Button>
        <Button Name="Personal.ac_gui.Content.CC2.0.CC2.0.Launch" Priority="0">
            <ButtonParams Size="Large" CollapseToSmall="WhenGroupIsSmall" CollapseToMedium="WhenGroupIsMedium">
                <AccessText>GP1</AccessText>
                <PopupAccessText>M</PopupAccessText>
                <Visibility />
            </ButtonParams>
            <ButtonData>
                <CommandData Type="UserKeyinCommand">
                    <UserKeyinCommand>
                        <Keyin>bentley.componentscenter.client.microstationaddin helloworld</Keyin>
                        <Icon Type="NamedIcon">
                            <NamedIcon>PlaceContent</NamedIcon>
                        </Icon>
                        <Label>Launch</Label>
                        <Description>Launches Components Center</Description>
                    </UserKeyinCommand>
                </CommandData>
            </ButtonData>
        </Button>
        <Button Name="Personal.ac_gui.Content.CC2.0.Launch1" Priority="0">
            <ButtonParams Size="Large" CollapseToSmall="WhenGroupIsSmall" CollapseToMedium="WhenGroupIsMedium">
                <AccessText>GP1</AccessText>
                <PopupAccessText>M</PopupAccessText>
                <Visibility />
            </ButtonParams>
            <ButtonData>
                <CommandData Type="UserKeyinCommand">
                    <UserKeyinCommand>
                        <Keyin>bentley.componentscenter.client.microstationaddin helloworld</Keyin>
                        <Icon Type="NamedIcon">
                            <NamedIcon>PlaceContent</NamedIcon>
                        </Icon>
                        <Label>Launch</Label>
                        <Description>Launches Components Center</Description>
                    </UserKeyinCommand>
                </CommandData>
            </ButtonData>
        </Button>
    </Buttons>
</RibbonItems>
ItemTypes
Materials
  • Q: How can I access color and other attributes from a material name?
    A: Use the DgnPlatform MaterialManager API (Material.h) and MaterialSettings structure (MaterialSettings.h) where all material settings are stored.
Mesh
Namespaces
PickLists
Reports/Tables
Solids
  • Q: How can I process a Parametric Cell?
    A: Parametric Cell Instances are XGraphics. Use the ElementGraphics ElementGraphicsOutput class to iterate contents.
Transforms
Unit Testing
  • Created by Bentley Colleague
  • When:
  • Last revision by Bentley Colleague
  • When:
  • Revisions: 51
  • Comments: 0
Recommended
Related
Communities
Support and Services
Training and Learning
Social Media