Neue Features des Objektmodells von FlexPro 9
In den folgenden Abschnitten finden Sie detaillierte Informationen über alle Änderungen am Objektmodell von FlexPro 9. Bei den Änderungen, die am Automation Objektmodell von FlexPro 9 gegenüber der Vorgängerversion vorgenommen wurden, handelt es sich um abwärtskompatible Erweiterungen. Sie brauchen ihre für FlexPro 8 geschriebenen Programme daher nur dann anzupassen, wenn Sie die neuen Leistungsmerkmale von FlexPro 9 nutzen möchten. Ansonsten genügt es, die Programme neu zu kompilieren.
Falls Sie Makros oder Automation-Code von FlexPro 6 oder FlexPro 7 nach FlexPro 9 portieren möchten, sollten Sie zunächst die unter Neue Features des Objektmodells von FlexPro 7 und Neue Features des Objektmodells von FlexPro 8 aufgeführten Anpassungen vornehmen.
Neue Objekte
Das Media-Objekt repräsentiert das neue Präsentationsobjekt Medium. Es ist, wie die anderen Präsentationsobjekte auch, vom DocObject-Objekt abgeleitet.
Das FileDialog-Objekt repräsentiert ein Dateiauswahldialogfeld, welches Sie über die neue FileDialog-Eigenschaft des Application-Objekts anfordern können. In diesem Zusammenhang stehen auch das FileDialogFilter-Objekt und die beiden Auflistungen FileDialogFilters und FileDialogSelectedItems.
Das CursorProperties-Objekt wird vom FpCursor-Objekt zurückgegeben und repräsentiert die Einstellungen auf der Registerkarte Cursor des Diagramms, dem der Cursor zugeordnet ist.
Die CustomFPScriptFunctions-Auflistung enthält alle registrierten benutzerdefinierten FPScript-Funktionen, welche durch das neue CustomFPScriptFunction-Objekt repräsentiert werden.
Die CustomFPScriptFunctionParameters-Auflistung enthält die Parameter einer benutzerdefinierten FPScript-Funktion, welche durch das neue CustomFPScriptFunctionParameter-Objekt repräsentiert werden.
Die CustomFPScriptConstants-Auflistung enthält alle registrierten benutzerdefinierten FPScript-Konstanten, welche durch das neue CustomFPScriptConstant-Objekt repräsentiert werden.
Das SignalSamplingAnalysis-Objekt repräsentiert das neue Analyseobjekt Signalabtastung.
Das Approximation2DAnalysis-Objekt repräsentiert das neue Analyseobjekt 2D-Approximation.
Erweiterungen an bestehenden Objekten
Das Global-Objekt und das Application-Objekt wurden um die Eigenschaften CustomFPScriptFunctions und CustomFPScriptConstants erweitert, die die gleichnamigen Auflistungen zurückgeben. Das Application-Objekt wurde zusätzlich um die Eigenschaft DecimalSeparator erweitert, mit der Sie das Dezimaltrennzeichen und das Listentrennzeichen festlegen können. Die neue FileDialog-Eigenschaft wurde oben bereits beschrieben.
Das Database-Objekt, das die Projektdatenbank repräsentiert, wurde um die Eigenschaften FPScriptDecimalsAsFloat, ComplexOutputMode, PercentageCalculation, UnitCollectionsEnabled und UnitControlLevel erweitert. FPScriptDecimalsAsFloat bestimmt, ob Zahlen ohne Dezimalpunkt in FPScript als Fließkomma- oder Ganzzahlen interpretiert werden sollen. ComplexOutputMode bestimmt das Ausgabeformat komplexer Zahlen. PercentageCalculation aktiviert oder deaktiviert die Prozentrechnung in FPScript, UnitCollectionsEnabled legt fest, welche zusätzlichen Einheitensammlungen verwendet werden sollen, und UnitControlLevel bestimmt die Betriebsart der Einheitenverwaltung von FlexPro.
Das Folder-Objekt, das einen Ordner in der Projektdatenbank repräsentiert, wurde um die Methode AddFromTemplate erweitert, mit der neue Objekte basierend auf einer Vorlage hinzugefügt werden können.
Das FpObjectParameter-Objekt, das einen Parameter in der Parameterliste eines beliebigen Objekts von FlexPro repräsentiert, wurde um die Eigenschaft Unit erweitert. Hiermit können Sie auf die Einheit eines Parameters zugreifen.
Das FpObject-Objekt, das ein beliebiges Objekt von FlexPro repräsentiert, wurde um die Eigenschaft UpdateViews erweitert. Hiermit können Sie die Aktualisierung der Ansichten eines Objektes temporär unterbinden und damit die Leistung beim Ändern mehrerer Attribute in Folge eines Objekts erhöhen.
Das ValueObject-Objekt, das ein Datenobjekt repräsentiert, wurde um die Eigenschaften DataUnit, DataUnitY, DataUnitX, DataUnitZ, Quantity, QuantityY, QuantityX, QuantityZ und QuantityOrCommentsOrName erweitert. Die DataUnit-Eigenschaften geben die aktuelle Einheit einer Datenkomponente zurück. Bei Schreibzugriff auf diese Eigenschaften werden die Daten in die neue Einheit transformiert. Die Quantity-Eigenschaften greifen auf das neue Attribut Größe in den Kopfinformationen von Datenobjekten zu.
Das CursorObject-Objekt wurde um die Eigenschaften SynchronizeYZoom, ZoomAllCurves, AxisAdjustment, PlaybackRate und PlaybackIncrement erweitert. Das Argument Object der Eigenschaft AutoZoom ist seit FlexPro 9 obsolet und wird nur noch zur Abwärtskompatibilität unterstützt. Es ist nun als optional deklariert.
Das FpCursor-Objekt, das einen Datencursor repräsentiert, wurde um die Methode RemoveAllMarkers erweitert. Hiermit können Sie alle Marken auf dem Kurvenzug unter dem Cursor löschen. Die Methode PlayReverse dient zum Animieren des Cursors und mit der Methode PlaceImageMarker können Bildmarken gesetzt werden. Die neue Eigenschaft Markers gibt die Markers-Auflistung zurück, welche die Marken des Kurvenzuges unter dem Cursor repräsentiert, und die Eigenschaft Properties liefert das CursorProperties-Objekt, das die Einstellungen auf der Registerkarte Cursor des zugeordneten Diagramms repräsentiert.
Die Objekte Axis2DScaling und Axis3DScaling, welche die Skalierung einer 2D- bzw. 3D-Achse repräsentieren, wurden um die Eigenschaften CurrentDivision, Unit, CurrentUnit und CurrentUnitInBrackets erweitert. CurrentDivision liefert das momentan gültige Teilungsintervall. Mit Unit können Sie eine Ausgabeeinheit für die Achse und damit für alle über ihr skalierten Kurvenzüge festlegen. CurrentUnit und CurrentUnitInBrackets liefern das momentan gültige Einheitensymbol für die Achse. Dies entspricht entweder Unit oder ergibt sich aus den Einheiten der Datensätze.
Die Objekte ColumnTableColumnData und ColumnTableColumnColumnIndex, welche die Datenspalte bzw. die Spaltenindexzeile einer Spaltentabelle repräsentieren, wurden um die Eigenschaften Unit, CurrentUnit und CurrentUnitInBrackets erweitert. Der Verwendungszweck dieser Eigenschaften entspricht dem der Achsen.
Das ImportSettings-Objekt wurde um die Eigenschaft UnitProcessing erweitert. Die Eigenschaft entspricht dem Feld Einheiten im Importieren-Dialogfeld.
Das CFCFilterAnalysis-Objekt wurde um die Eigenschaft Algorithm erweitert, mit der der Filteralgorithmus eingestellt werden kann.
Das ApproximationAnalysis-Objekt wurde um die Eigenschaften UseCustomModel und CustomModel erweitert, mit denen benutzerdefinierte Elementfunktionen für die Approximation angegeben werden können.
Das SignalCorrectionAnalysis-Objekt wurde um die Eigenschaft CorrectionValue erweitert, mit der der Korrekturwert eingestellt werden kann.
Die Markers-Auflistung wurde um die Eigenschaften LabelWidth, LabelHeight, ImageWidth und ImageHeight erweitert, mit denen die Größe von Text- und Bildmarken eingestellt werden können. Mit den neuen Eigenschaften ImageSource und Media kann ein Media-Objekt als Bildquelle für Bildmarken eingerichtet werden.
Das Marker-Objekt wurde um die Eigenschaften Width und Height erweitert, mit welchen die Größe des Textfeldes bzw. des Bildes der Marke eingestellt werden kann.
Das neue Ereignis WindowActivated, das anzeigt, dass ein Fenster aktiviert wurde, wurde in die Objekte Windows und Window aufgenommen.
Neue Aufzählungstypen
Die Aufzählungstypen FpAxisAdjustment, FpApprox2DResult, FpApproximation2DElementFunction, FpMarkerImageSource, FpParameterStructure, FpParameterType,FpSignalSamplingResult, FpTemplateType, FpUnitControlLevel, FpDecimalSeparator, FpComplexOutputMode, FpUnitProcessing, FpFileDialogType, FCFilterAlgorithm und FpMediaTimeBase wurden neu hinzugefügt.
Erweiterungen an bestehenden Aufzählungstypen
In den Aufzählungstyp FpObjectType wurden die zusätzlichen Elemente fpObjectTypeSignalSampling und fpObjectTypeApproximation2D aufgenommen.
In den Aufzählungstyp FpSignalCorrectionOperation wurde das zusätzliche Element fpSignalCorrectionOperationReplace aufgenommen.
In den Aufzählungstyp FpCursorPeakMode wurde die zusätzlichen Elemente fpCursorPeakModeMarker und fpCursorPeakModeMarkerMinMax aufgenommen.
In den Aufzählungstyp FpEventIsolationResult wurden die zusätzlichen Elemente fpEventIsolationResultInterpolate und lfpEventIsolationResultSetVoidMatches.
In den Aufzählungstyp FpSearchItem wurde das zusätzliche Element fpSearchItemQuantity aufgenommen.
In den Aufzählungstyp FpSurfaceInterpolationType wurde das zusätzliche Element fpSurfaceInterpolationTypeNaturalNeighborConvex aufgenommen.
In den Aufzählungstyp FpStatisticQuantity wurde das zusätzliche Element fpStatisticQuantityCrestFactor aufgenommen.
In den Aufzählungstyp FpExportFormat wurden die zusätzlichen Elemente fpExportFormatCellTablesAsTXT, lfpExportFormatColumnTablesAsTXT, fpExportFormatTextsAsTXT und fpExportFormatFlexProText3 aufgenommen.
Im Aufzählungstyp FpObjectsToExportInFolders wurde das Element fpExportMedia hinzugefügt.
Im Aufzählungstyp FpIndicatorScaling wurde das Element fpIndicatorScalingAbsolute in fpIndicatorScalingAbsolutePosition, das Element fpIndicatorScalingRelative in fpIndicatorScalingAbsoluteError und das Element fpIndicatorScalingPercent in fpIndicatorScalingRelativeErrorPercent umbenannt. Die vorherigen Bezeichnungen werden zwar noch unterstützt, sollten aber im VBA-Code ersetzt werden.