Home
Engineering
Leistungsstarke Tools für einfache sowie komplexe Engineering-Aufgaben.
Grafik-Editor GEDI
Dient zur Erstellung und Änderung von Panels, bietet Werkzeuge zur Erstellung und Parametrierung von Grafikobjekten.
Komplexe Grafikobjekte
EWO - Grundlagen und Entwicklung
Maps Widget (EWO)
Maps Widget
Dieser Abschnitt enthält die Referenzdokumentation für alle Eigenschaften, Funktionen und Ereignisse des Maps Widgets.
"pan()"
The function moves the map by the given number of steps

Versionsinformationen
Release Notes, Update-Informationen, Zertifizierungen and häufig gestellte Fragen.
Konzepte
Ihr erster Schritt in die moderne und leistungsstarke Prozessvisualisierung.
Deployment
Themen, die Sie vor der Nutzung von WinCC OA wissen sollten.
Sicherheit
Wachsen sie in Bezug auf Cybersecurity über die Norm hinaus.
Engineering
Leistungsstarke Tools für einfache sowie komplexe Engineering-Aufgaben.
- Projektadministration
  Dieses Kapitel beinhaltet Beschreibungen für den Prozess Monitor wie auch die Projektadministration.
- Grafik-Editor GEDI
  Dient zur Erstellung und Änderung von Panels, bietet Werkzeuge zur Erstellung und Parametrierung von Grafikobjekten.
  - Grundlagen GEDI
  - Katalogfenster
  - Der Skript-Editor
  - Das Eigenschaftenfenster
  - Grafikobjekte erstellen
  - Einfache Grafikobjekte
  - Komplexe Grafikobjekte
    - Auswahlliste
    - Balken-Trend
    - Combobox
      Comboboxen erlauben die Auswahl von genau einer Option aus einer Reihe von vorgegebenen Alternativen. Da nach getroffener Wahl nur der ausgewählte Optionseintrag angezeigt bleibt, benötigt eine Combobox innerhalb eines Anlagenbildes nur wenig Platz.
    - Checkbox
      Check-Boxen sind dazu da, um eine Auswahl aus mehreren vorgegebenen Alternativen zu erlauben. Damit können etwa Datenpunktwerte gesetzt oder Aktionen ausgelöst werden. Beispielsweise die Zuschaltung der ersten und dritten von drei installierten Pumpen.
    - DP Baumansicht
    - DP Typ Ansicht
    - Eingebettetes Modul
    - EWO - Grundlagen und Entwicklung
      - WinCC OA EWOs
      - WebView.ewo
      - Maps Widget (EWO)
        Maps Widget - Konfiguration
        Maps Widget
        Dieser Abschnitt enthält die Referenzdokumentation für alle Eigenschaften, Funktionen und Ereignisse des Maps Widgets.
        Maps Widget - Hinweise und Einschränkungen
        Lizenzvereinbarung
        Beispiel - Google Maps Integration
        Maps Widget Example - Web Map Service
        Maps Widget
        Dieser Abschnitt enthält die Referenzdokumentation für alle Eigenschaften, Funktionen und Ereignisse des Maps Widgets.
        "animationsEnabled"
        Specifies how a new visible section of the map is displayed.
        "distance"
        Distance of the view point from the globe in meters.
        "latitude"
        Specifies the latitude of the center of the visible map section in degrees.
        "longitude"
        Specifies the longitude of the center of the visible map section in degrees.
        "mapThemeId"
        Allows you to select one of the predefined map themes to be shown.
        "persistentTileCacheLimit"
        Maximum size of the persistent tile cache (tiles stored on disk) in kilobytes.
        "projection"
        The type of projection that is used to display the 3D globe onto the 2D screen.
        "renderPlugins"
        Returns a list of plug-in names that are available in the Maps Widget.
        "showCrosshairs"
        Specifies whether a crosshairs symbol should be displayed for the current position.
        "showGrid"
        Specifies whether a coordinate grid is shown within the map.
        "showNavigation"
        Specifies whether the interactive navigation box is displayed in the lower right corner of the Maps Widget.
        "showOverviewmap"
        Specifies whether an overview map as well as the current position on the map are displayed.
        "showScalebar"
        Specifies whether a scale bar for the map is displayed.
        "volatileTileCacheLimit"
        Maximum size of the volatile tile cache (tiles stored in memory) in kilobytes.
        "workOffline"
        Specifies whether the Maps Widget will try to access online data or only displays data available locally.
        "zoomStep"
        Specifies the factor which is zoomed per step when using the function zoom().
        "addEmptyLayer()"
        This function adds a new empty layer to the Maps EWO.
        "addGeoDataFile()"
        The function adds offline map material into the Maps Widget.
        "addLine()"
        This function adds a new empty line to the Maps EWO.
        "addPlacemark()"
        The function adds a new placemark to the map.
        "addPointToLine()"
        The function adds a point to a line of the Maps EWO.
        "addPolygon()"
        The function adds an empty polygon to the Maps EWO.
        "addSymbol()"
        The function allows to add a custom symbol to the Maps Widget.
        "appendPolygonInnerBoundaries()"
        The function adds a cutout to a polygon of the Maps EWO.
        "centerOn()"
        Changes the map view to stated coordinates.
        "centerOnBox()"
        Changes the map view within the stated region borders.
        "centerOnHome()"
        Changes the map view to the defined home coordinate.
        "centerOnLine()"
        Changes the map view to the center of the specified line.
        "centerOnPlacemark()"
        Changes the map view to the stated placemark.
        "centerOnPolygon()"
        Changes the map view to the center of the specified polygon.
        "centerOnSymbol()"
        Changes the map view to the stated object.
        "clearLayer()"
        The function removes all polygons, lines and symbols of a specific layer of the Maps EWO.
        "getLayerClickEnabled()"
        The function returns whether the click events for a specific layer of the Maps EWO are enabled.
        "getLayerFromName()"
        The function returns the layer number for a given name of a layer in the Maps EWO.
        "getLayerName()"
        The function returns the name of a specified layer of the Maps EWO.
        "getLayers()"
        The function returns all layers of the Maps EWO.
        "getLineColor()"
        The function gets the color of a line of the Maps EWO.
        "getLinePoints()"
        Returns the points of a specified line of the Maps EWO.
        "getLines()"
        The function returns all lines of the Maps EWO.
        "getLineType()"
        Returns the type of a specified line of the Maps EWO.
        "getLineWidth()"
        The function returns the width of a line of the Maps EWO.
        "getMapCoordinates()"
        Returns the current map coordinates for a specified position on the panel..
        getPluginData()
        "getPolygonColor()"
        The function gets the colors of a polygon of the Maps EWO.
        "getPolygonFillPattern()"
        Returns the fill pattern for a specified polygon of the Maps EWO.
        "getPolygonInnerBoundaries()"
        Returns the inner boundaries of a specified polygon of the Maps EWO..
        "getPolygonLineType()"
        Returns the line type of the border of a specified polygon of the Maps EWO.
        "getPolygonLineWidth()"
        The function returns the line width of the outline of a polygon.
        "getPolygonOuterBoundaries()"
        Returns the outer boundaries of a specified polygon of the Maps EWO.
        "getPolygons()"
        The function returns a list of all polygons of the Maps EWO.
        "getScreenCoordinates()"
        Returns the current screen position of a location on the map.
        "getVisibleBox()"
        The function gets the current visible maps area.
        hideLayer()
        "ignoreSslErrors()"
        Instructs the Maps Widget to ignore specific SSL errors when loading map tiles.
        isLayerVisible()
        "isPositionVisible()"
        Returns if the specified coordinates are shown in the current visible map area.
        "latLonToString()"
        The function converts float coordinates into string coordinates.
        "layerExists()"
        Returns whether the specified layer exists on the Maps EWO.
        "lineExists()"
        Returns whether the specified line exists on the Maps EWO.
        "moveLayerToTop()"
        The function moves a layer of the Maps EWO to the top in the hierarchy.
        "pan()"
        The function moves the map by the given number of steps
        "polygonExists()"
        Returns whether the specified polygon exists on the Maps EWO.
        "removeGeoDataFile()"
        The function removes offline map material from the Maps Widget.
        removeLayer()
        "removeLine()"
        The function deletes a line from the Maps EWO.
        "removePlacemark()"
        Removes the stated placemark.
        "removePolygon()"
        The function removes a polygon from the Maps EWO.
        "removeSymbol()"
        Removes the stated object.
        setHome()
        "setLayerClickEnabled()"
        Enables or disables the click events for a specific layer of the Maps EWO.
        "setLayerVisibleRange()"
        The function sets the viewing distance, for which the specified layer will be shown.
        "setLineColor()"
        The function changes the color of a line of the Maps EWO.
        "setLineType()"
        Sets the type of a specified line of the Maps EWO.
        "setLineWidth()"
        The function sets the width of a line of the Maps EWO.
        setPluginData()
        "setPolygonColor()"
        The function sets the color of a polygon of the Maps EWO.
        "setPolygonFillPattern()"
        Sets the fill pattern for a specified polygon of the Maps EWO.
        "setPolygonLineType()"
        Sets the line type of the border of a specified polygon of the Maps EWO.
        "setPolygonLineWidth()"
        The function sets the line width of the outline of a polygon.
        "setPolygonOuterBoundaries()"
        The function sets the corner coordinates of a polygon of the Maps EWO.
        showLayer()
        "stringToLatLon()"
        The function converts string coordinates into float coordinates.
        "zoom()"
        The function is used to zoom in or out of the map.
        "clicked"
        The event is triggered whenever the left mouse button is released on the Maps Widget.
        "geoDataFileAdded"
        The event is triggered if a geoDataFile has been loaded using the function addGeoDataFile().
        "lineClicked"
        The event is triggered whenever a line is clicked on the map.
        "polygonClicked"
        The event is triggered whenever a polygon is clicked on the map.
        "visibleBoxChanged"
        The event is triggered as soon as the visible maps area changes.
    - Kalender
    - Kaskade
    - Label
    - LCD-Nummer
    - Panel-Referenz
    - Progress Bar
    - Radiobox
      Radioboxen sind dazu da, um die Auswahl genau einer Option aus mehreren vorgegebenen Alternativen zu erlauben. Damit können etwa Datenpunktwerte gesetzt oder Aktionen ausgelöst werden. Ein Beispiel wäre z.B. die Umschaltung zwischen Automatik, Handbetrieb und dem Zustand "Aus".
    - Registerkarte
    - Schaltfläche
    - Slider (Schieberegler)
    - Spin-Button
    - Splitter
    - Tabelle
    - TextEdit
    - Textfeld
    - Thumb wheel
    - Trend-Widget
      Das Trend-Widget ist ein fortschrittliches Visualisierungstool, das entwickelt wurde, um eine umfassende Ansicht darüber zu bieten, wie sich zwei oder mehr Werte im Laufe der Zeit zueinander verändern. Diese leistungsstarke Funktion ist unerlässlich für die Verfolgung und Überwachung von Leistungskennzahlen, die Analyse aufkommender Muster und die Identifizierung von Anomalien. Durch die Nutzung des Trend-Widgets können Benutzer fundierte, datenbasierte Entscheidungen treffen, die die Betriebseffizienz und die strategische Planung verbessern.
    - Tree-Widget (Baum-Ansicht)
    - Uhr
    - Zoom Navigator
      Mit dem Zoom Navigator Widget zoomen Sie ein Modul.
  - Einfache Parametrierung
    Dialogfenster bzw. Panels zur Einfachen Parametrierung bieten eine komfortable Eingabe- und Editierhilfe für die Verknüpfung von Datenpunktänderungen und Attributen von Grafikobjekten. Ereignisse (wie Mausklick) können so mit verschiedenen Aktionen wie Setzen von Datenpunktwerten, Zeigen von Panels oder Ändern von Attributen verknüpft werden.
  - ScriptWizard
    Einfacher Wizard zur Erstellung grafischer Oberflächen für Benutzer ohne Programmier-Vorkenntnisse.
  - Grundlagen Versionsverwaltung
    Versionsverwaltungssysteme erfassen und speichern Änderungen an Dateien in einem Repository. In WinCC OA können verschiedene Systeme integriert werden, um Projektdateien effizient zu verwalten.
  - Grundlagen Style Sheets
    Style Sheets bieten eine flexible Möglichkeit, das Erscheinungsbild von Widgets im WinCC OA Projekt anzupassen. Sie basieren auf CSS-Konzepten und ermöglichen individuelle Designs, können jedoch die Performance beeinflussen.
  - Standardsymbole (STD_Symbols)
    Symbolbibliothek aus Grafikobjekten für die rasche Visualisierung und Gestaltung von Anlagenbildern.
  - Erweiterbarkeit
  - Grundlagen Simple Symbols
    Um das Arbeiten mit unterschiedlichen Symbolen zu vereinfachen, können mittels der "Simple Symbols"-Funktionalität auf einfachste Weise Verbindungen zwischen Datenpunkttypen und den dafür vorgesehen Symbolen erstellt werden.
  - Layout Management
    Layouts verändern Größe und Position von Objekten gemäß der zuvor im GEDI festgelegten Parameter.
  - Objektorientierte Panelreferenzen
    Mehrfach verwendbare Objekte, welche mit GEDI Werkzeugen erstellt wurden. Durch das Hinzufügen von Referenzen in bestehende Panels können grafische Elemente dargestellt werden.
  - Input Event Recorder
    Der Input Event Recorder (auch als Macro Recorder bekannt) zeichnet Maus- und Tastatur-Events in Laufzeit-Panels auf und erstellt CTRL-Skripte zur automatisierten Wiedergabe. Verwenden Sie ihn zur Erstellung automatisierter Testsequenzen und wiederholbarer Arbeitsabläufe.
  - Encryption
- System Management
  Die Systemverwaltung ist die zentrale Verwaltungseinheit für WinCC OA Systeme.
- Wizard-Framework
  Dient der vereinfachten Erstellung von Wizards und stellt einen einheitlichen Stil sicher. Die Elemente "Navigation Bar" und "Bottom Bar" können bei neu erstellten Wizards frei konfiguriert werden.
- XML-Panelformat
  Das XML (Extensible Markup Language) Panelformat ermöglicht Ihnen das Erstellen von WinCC OA Panels.
- Grundlagen Simple Symbols
  Um das Arbeiten mit unterschiedlichen Symbolen zu vereinfachen, können mittels der "Simple Symbols"-Funktionalität auf einfachste Weise Verbindungen zwischen Datenpunkttypen und den dafür vorgesehen Symbolen erstellt werden.
- ScriptWizard
  Einfacher Wizard zur Erstellung grafischer Oberflächen für Benutzer ohne Programmier-Vorkenntnisse.
- Paneltopologie/Summenmeldung
  Baumstruktur für Anlagenpanels mit integrierter Summenmeldung von Alarmen
- Objektorientierte Panelreferenzen
  Mehrfach verwendbare Objekte, welche mit GEDI Werkzeugen erstellt wurden. Durch das Hinzufügen von Referenzen in bestehende Panels können grafische Elemente dargestellt werden.
- Mehrsprachigkeit
  WinCC OA bietet einerseits einen "Native Language Support" und stellt andererseits auch einen "Multi Language Support" zur Verfügung.
- Translator
  Die WinCC OA Translator-Funktionalität unterstützt Sie bei der Erstellung und Pflege mehrsprachiger Pprojekte. Sie bietet eine komfortable Schnittstelle für die Übersetzung von wiederverwendbaren Begriffen.
- Layout Management
  Layouts verändern Größe und Position von Objekten gemäß der zuvor im GEDI festgelegten Parameter.
- Generic Dialog Framework
  Mit dem Generic-Dialog-Framework können auf einfache Weise durch das Anpassen einiger vorgefertigter Panels Dialoge erstellt werden.
- Einfache Parametrierung
  Dialogfenster bzw. Panels zur Einfachen Parametrierung bieten eine komfortable Eingabe- und Editierhilfe für die Verknüpfung von Datenpunktänderungen und Attributen von Grafikobjekten. Ereignisse (wie Mausklick) können so mit verschiedenen Aktionen wie Setzen von Datenpunktwerten, Zeigen von Panels oder Ändern von Attributen verknüpft werden.
Datenmanagement
Klassifizieren, strukturieren und archivieren sie Ihre Daten.
Business Logic / Control
Endlose Möglichkeiten in der Datenverarbeitung für Ihre Projekte.
Datenvisualisierung
User Interfaces, Trends und Reports für jeden Zweck und jedes Gerät.
Southbound Interfaces
Der Prozessanschluss zu den echten Maschinen/Sensoren.
Northbound Interfaces
Ihr Portal zur Cloud oder übergeordneten Systemen.
Konnektivität / Netzwerk Schnittstellen
Datenaustausch, APIs und moderne (Web) Technologien.
Benutzerverwaltung
Alles über Autorisierung, Authentifizierung und Login-Anpassung.
Verfügbarkeit
Wie sie maximale Systemverfügbarkeit erreichen können.
Reporting
Erstellen sie "State of the art"-Reports ohne Limits.
Erweiterungen
Nützliche Werkzeuge und Erweiterungen für spezielle Anforderungen.
Referenztabellen
Detaillierte und umfangreiche Inhalte für spezielle Projektanpassungen.
Videos & Tutorials
Erkunden Sie die Möglichkeiten von WinCC OA mit unserer sorgfältig ausgewählten Sammlung von Video-Tutorials und Anleitungen.
eLearning
Bauen Sie Ihre Expertise Schritt für Schritt auf
Dokumentation
Grundlegende Informationen über Bezeichnungen und Funktionsweisen innerhalb der Dokumentation.
Support & Services
Ein erfahrenes Team von Support-Mitarbeitern, Beratern und Trainern steht bereit, aktive Partnerschaften mit Kunden zu fördern, die von unserem umfassenden Service profitieren.
Disclaimer
Erläuterungen zu Haftungsausschlüssen oder rechtlichen Hinweisen.
SIMATIC WinCC OA World
Entdecken Sie die Welt von WinCC OA und bleiben Sie über die neuesten Produktneuigkeiten informiert.

"pan()"

The function moves the map by the given number of steps

Synopsis

void pan(int horizontalSteps, int verticalSteps)

Parameter


Parameter	Description
horizontalSteps	Specifies the number of steps in horizontal direction. A positive value moves the map to the right, negative values to the left, 0 results in no horizontal movement.
verticalSteps	Specifies the number of steps in vertical direction. A positive value moves the map up, negative values down, 0 results in no vertical movement.

Description

This function moves the visible map area by a specified number of steps in horizontal and vertical direction. It can be used to build a custom navigation menu for the Maps EWO.

Maps_ewo1.pan(-1, 1);

Assignment

Maps Widget