proficy* hmi/scada - ifix · pdf file presentation framework." the windows forms group...

Click here to load reader

Post on 28-May-2020

8 views

Category:

Documents

0 download

Embed Size (px)

TRANSCRIPT

  • Proficy* HMI/SCADA - iFIX

    . N E T C O M P O N E N T

    V e r s i o n 5 . 5

    J a n u a r y 2 0 1 2

  • All rights reserved. No part of this publication may be reproduced in any form or by any electronic or mechanical means, including photocopying and recording, without permission in writing from GE Intelligent Platforms, Inc.

    Disclaimer of Warranties and Liability

    The information contained in this manual is believed to be accurate and reliable. However, GE Intelligent Platforms, Inc. assumes no responsibilities for any errors, omissions or inaccuracies whatsoever. Without limiting the foregoing, GE Intelligent Platforms, Inc. disclaims any and all warranties, expressed or implied, including the warranty of merchantability and fitness for a particular purpose, with respect to the information contained in this manual and the equipment or software described herein. The entire risk as to the quality and performance of such information, equipment and software, is upon the buyer or user. GE Intelligent Platforms, Inc. shall not be liable for any damages, including special or consequential damages, arising out of the user of such information, equipment and software, even if GE Intelligent Platforms, Inc. has been advised in advance of the possibility of such damages. The user of the information contained in the manual and the software described herein is subject to the GE Intelligent Platforms, Inc. standard license agreement, which must be executed by the buyer or user before the use of such information, equipment or software.

    Notice

    ©2012 GE Intelligent Platforms, Inc. All rights reserved. *Trademark of GE Intelligent Platforms, Inc.

    Microsoft® is a registered trademark of Microsoft Corporation, in the United States and/or other countries.

    All other brands or names are property of their respective holders.

    We want to hear from you. If you have comments, questions, or suggestions about our documentation, send them to the following email address:

    doc@ge.com

  • iii

    Table of Contents

    About This Guide ............................................................................................................................. 1

    Introduction................................................................................................................................... 1

    General Overview of Component Hosting ....................................................................................... 3

    .NET Component Browser Dialog Box ......................................................................................... 3

    Browse Tree ............................................................................................................................. 4

    Add Components ..................................................................................................................... 4

    Add Group ................................................................................................................................ 4

    Delete Node ............................................................................................................................. 4

    Help .......................................................................................................................................... 5

    Supported .NET Control Types .................................................................................................... 5

    Inserting a .NET Component into a Picture ................................................................................. 5

    Binding .NET Component Properties to an iFIX Data Source ..................................................... 6

    Example ................................................................................................................................... 6

    Using Font and Enumeration Properties for .NET Components .................................................. 7

    Font Properties for Windows Forms Components ................................................................... 8

    Font Properties for Windows Presentation Framework Components ...................................... 9

    Enumeration Properties for .NET Components ..................................................................... 10

    Scripting in VBA ......................................................................................................................... 11

    Adding References in VBA ..................................................................................................... 12

    Using Intellisense® ................................................................................................................ 12

  • .NET Component

    iv

    Accessing Component Properties and Methods Through Scripting ...................................... 13

    Using Event Handlers ............................................................................................................ 17

    Handling Events with Non-Converted Parameters ................................................................ 24

    Using Properties and Methods of the iFIX Container ............................................................ 29

    Advanced Features ........................................................................................................................ 31

    Creating New Components ........................................................................................................ 31

    Creating a .NET Control ......................................................................................................... 31

    Deleting Nodes on the Component Browser .......................................................................... 35

    Supporting Files for .NET Components ................................................................................. 35

    Uniqueness of .NET Control Assembly Names ..................................................................... 36

    Using New Components on iFIX Systems ................................................................................. 36

    Copying Compiled Component Files to iFIX Nodes............................................................... 36

    Adding Components to the .NET Component Browser Dialog Box ....................................... 37

    Copying Pictures That Include .NET Components ................................................................ 38

    Re-linking Components from Another iFIX Machine .............................................................. 38

    Data Conversion Rules .............................................................................................................. 39

    Passing Complex Data Types ................................................................................................ 41

    Strategies for Parameter Types That Cannot Be Converted ................................................. 43

    Error Logging ............................................................................................................................. 44

    Default Logging Settings ........................................................................................................ 44

    Sample Projects in Visual Studio ............................................................................................... 45

  • 1

    About This Guide The .NET Component feature for iFIX allows you to host .NET components within your iFIX pictures. These .NET Components include pre-selected ones from the .NET Framework, samples from GE Intelligent Platforms, or custom ones that you develop or buy.

    Creating custom components requires proficiency in Microsoft® Visual Studio® 2010 and the .NET Framework. In addition, to develop your own .NET components, you must be proficient in programming with the .NET Framework. For iFIX scripting, you must have a working knowledge of the Visual Basic programming language.

    To help you use the .NET Component feature, this Help file includes the following sections:

    • Introduction

    • General Overview of Component Hosting

    • Advanced Features

    Introduction The .NET Component feature allows you to host .NET components within your iFIX pictures. All hosted .NET components will look and function as OLE objects (ActiveX controls) within your iFIX pictures. Just as other iFIX controls allow you to access the Property Window and Basic Animations dialog box, so do hosted .NET components. Screen editing actions, such as Select, Move, Resize, Delete, Undo, Copy, and Paste are all supported for .NET components as well.

    The Component Hosting feature is installed by default when you install iFIX.

    NOTES:

    • The Backup and Restore Utility does not support backing up .NET Component files.

    • .NET Component is not supported on the XP Embedded OS.

    • Upgrading or in any way re-installing iFIX will result in replacing any .NET Component files that are supplied with the product install. This includes sample files such as Visual Studio solutions and projects in the Sample Components folder which you may have modified. If you have modified these files, they will lose their changes on an upgrade or re-install of iFIX. If you make any changes to these Visual Studio files, they should be backed up prior to upgrade/re-install.

  • .NET Component

    2

    • If a user is a member of

View more