WinCC Professional Screen Window: V13 SP1+ Configuration Guide

David Krause11 min read
SiemensTutorial / How-toWinCC
Licensed PE Working through this on a live machine? A Maine-licensed engineer can take it from here — included with IMD hardware, by the hour for everything else. Book an engineer

WinCC Professional Screen Window: Configuration Reference for TIA Portal V13 SP1 and Later

The Screen Window object in WinCC Professional / WinCC RT Professional is the canonical mechanism for implementing pop-up, faceplate, and control-window behavior on process screens. A single Screen Window acts as a container that displays another screen of the project, and it can be made dynamic so that the displayed content, target tag namespace, and visibility all change at runtime in response to operator actions.

This article consolidates the engineering rules, property bindings, tag-prefix syntax, and commissioning checks required to deploy Screen Window-based HMIs reliably from TIA Portal V13 SP1 through current TIA Portal versions (V20 confirmed via the official TIA Siemens Cloud documentation). It also addresses multi-monitor layouts, Comfort Panel constraints, and the most common runtime errors encountered when the tag prefix is incomplete or when a faceplate is incorrectly placed inside a pop-up window.

1. Functional Overview

On a high-density process screen, the operator needs an uncluttered view of the running plant. The Screen Window delivers this by:

  • Embedding a separate screen inside the current process screen as a child layer.
  • Allowing the Visible property to be toggled via a button click, a tag, or a VB/VBScript action so the window appears on demand and disappears when dismissed.
  • Reusing one Screen Window for many source objects by remapping the Tag prefix at runtime. This avoids duplicating screens and keeps the HMI project size small.

The Screen Window is functionally equivalent to features marketed as pop-up window, faceplate window, or control window in third-party SCADA packages, but the implementation in WinCC Professional is object-based rather than script-based.

Availability: The Screen Window object is a feature of WinCC Professional / RT Professional. It is not present in WinCC Comfort, WinCC Basic, or on Basic Panels. Comfort Panels (TP1500 Comfort and similar) do not expose the Screen Window in their target runtime; they use the separate Screen change mechanism with a permanent header/footer layout. Confirm the target runtime is WinCC RT Professional before attempting the procedures in this article.

2. Prerequisites and Version Matrix

TIA Portal Version Screen Window Available Notes
V12 / V12 SP1 No Add/remove control is locked in the toolbox. No native Screen Window object.
V13 (base) No Feature not released. Toolbox icon is locked or absent.
V13 SP1 Yes Initial release of the Screen Window object. Reference manual entry 92323076 documents the feature in Chapter 10.1.
V14 / V14 SP1 Yes Recommended baseline for stable production use. Full VBScript support for Visible / TagPrefix toggling.
V15 / V15.1 / V16 / V17 / V18 / V19 / V20 Yes Object behavior unchanged. Tag prefix syntax and Visible property bindings are stable across all subsequent versions.

Verify the engineering environment by opening the HMI device configuration and confirming the runtime is set to WinCC RT Professional (PC-based). If the device type is a Comfort Panel, the procedures below do not apply to that target.

3. Reference Documentation

4. Creating a Screen Window — Step-by-Step

4.1 Insert the Object

  1. Open the target process screen in the WinCC Professional editor.
  2. In the toolbox, expand the Controls group. In TIA V13 SP1 and later, the Screen window icon is present and unlocked.
  3. Drag the Screen Window onto the screen at the desired position and size. The size should match the pop-up screen resolution you intend to display.
  4. Select the object and inspect the Properties pane.

4.2 Assign the Static Screen

Under Properties > General > Screen, choose the screen to display when the window is first opened. This is the default content. For dynamic content, leave the field blank and continue to Section 4.4.

4.3 Bind the Visible Property

Open Properties > Animations > Visibility and configure a Boolean tag (e.g. DI_PopUp_Visible) or a script-driven expression. When the tag evaluates to 0, the window is hidden; when 1, it is shown.

4.4 Configure the Tag Prefix

The Tag prefix property is the key mechanism that allows one Screen Window to display data for multiple source objects. The prefix is a string that is prepended to every tag name inside the embedded screen when the runtime resolves them.

Example configuration for a digital-input pop-up:

Field Value Effect
Tag prefix (static) All_DI_DI{1} Embeds screen reads tag All_DI_DI{1}Status instead of Status
Tag prefix (dynamic, via VB) "All_DI_DI" & Index Re-evaluated on each open event
Rule: The tag prefix must be a valid namespace prefix that exists in the HMI tag database or in the connected PLC (for direct tags). An empty or mistyped prefix causes compile-time warnings in TIA Portal and runtime tag-not-found errors after download.

5. Multi-Monitor Layouts

For a PC-based runtime with two physical monitors, deploy one Screen Window per monitor on a single full-screen parent screen. The two Screen Windows can display different child screens simultaneously and be toggled independently.

  1. Create a parent screen sized to span both monitors (or set the runtime to full-screen across the desktop).
  2. Insert two Screen Window objects, one positioned over each monitor's coordinates.
  3. Bind each Screen Window's Screen property to a different child screen, and each Visible property to a separate Boolean tag.
  4. Use independent tag prefixes for each window if the displayed content references different PLC tag groups.

This is the recommended pattern for control-room installations that require a fixed left-screen overview and a right-screen detail view, with no overlap of operator input zones.

6. Common Engineering Patterns

6.1 Fixed Header / Footer with Variable Center Area

For a screen layout consisting of a fixed title bar at the top, a fixed alarm bar at the bottom, and a center area that changes per menu selection, place the header and footer directly on the parent screen and use a single Screen Window in the center. Bind the Screen Window's Screen property to a tag that the menu buttons write to, e.g. CenterScreenName.

6.2 Faceplate-Style Pop-Up

The recommended pattern for a pop-up that displays faceplate data is:

  1. Create a dedicated screen (not a faceplate container) containing the controls you want in the pop-up.
  2. Insert the Screen Window on the parent screen and bind the Tag prefix to the source object, e.g. All_DI_DI{1}.
  3. Trigger the Screen Window's visibility from a button click that writes 1 to the Visible tag and writes the tag prefix to its target property.
Critical: Do not place a faceplate instance inside a Screen Window. The runtime cannot resolve the faceplate's internal interface tags through a Screen Window's tag prefix, which produces unresolved-tag warnings and click-through errors. Controls inside the pop-up must be created directly on the screen that the Screen Window displays.

7. Toggling the Screen Window from VB Script

A common requirement is to open the Screen Window with a click on a faceplate instance. Because the tag prefix depends on the clicked object, the click event must update both the Visible tag and the Tag prefix property of the Screen Window object.

Example VBScript for a click event on a digital-input faceplace instance:

' Stored on the click event of the faceplate instance
Dim objScreenWindow
Set objScreenWindow = HmiRuntime.Screens("HOME").ScreenItems("DI_PopUp")

' Set the tag prefix to point at the clicked instance
objScreenWindow.TagPrefix = "All_DI_DI{1}"

' Make the pop-up visible
HmiRuntime.Tags("DI_PopUp_Visible").Write 1

Notes on the script:

  • HOME is the name of the parent screen hosting the Screen Window.
  • DI_PopUp is the name of the Screen Window object on that screen.
  • The tag prefix must be a string that matches the HMI / PLC tag namespace of the source object.
  • The Visible tag must be the same tag bound to the Screen Window's Visibility animation.

8. Troubleshooting Matrix

Symptom Root Cause Resolution
Compile error: "Tag prefix is incomplete" Tag prefix property is empty or contains unresolved placeholders. Confirm the tag prefix is a valid string and the tag namespace exists in the project. Rebuild the project.
Screen Window icon missing in toolbox (TIA V12 / V13 base) Feature not released in the installed service pack. Upgrade to TIA Portal V13 SP1 or later. Reference: Siemens Support 106567433.
VB script error on click: "Object required" or "Item not found" Parent screen name or Screen Window name in the script does not match the runtime objects. Verify the parent screen is the currently active screen, and the Screen Window name is case-sensitive identical to the object name in the screen editor.
Pop-up shows correct layout but tags show "####" or zero Tag prefix is set but the embedded screen uses tag names that do not match the prefix expansion. Confirm every tag inside the embedded screen starts with the prefix string. Check for missing braces in array index notation, e.g. DI{1} vs DI1.
Click on the faceplate inside the Screen Window has no effect A faceplate instance was placed inside the Screen Window, breaking the tag prefix resolution chain. Remove the faceplate and recreate the pop-up content as native controls on the embedded screen. Re-deploy.
Two monitors show the same content Only one Screen Window is configured; the runtime is mirroring the desktop. Configure the Windows desktop to extend (not duplicate). Create two Screen Windows, one per monitor. Set the Screen property of each independently.
Screen Window does not appear despite Visible = 1 Z-order issue: another screen object overlays the Screen Window's coordinates. Bring the Screen Window to front in the editor. Alternatively, set the Z-order via the Display > Layer property.

9. Comfort Panel and Basic Panel Considerations

The Screen Window object is not available on Comfort Panels (TP700 Comfort, TP900 Comfort, TP1200 Comfort, TP1500 Comfort, TP1900 Comfort, TP2200 Comfort) or on Basic Panels. Operators familiar with the look and feel of the Screen Window on a PC-based runtime will not see the same object on a Comfort Panel target.

For Comfort Panels, achieve the equivalent of a fixed header + variable body by using a single global screen and configuring a screen window via the Permanent window feature in the screen editor, with header and footer areas fixed and the center area changed by a screen-change tag. This is a different object and is documented separately in the Comfort Panels programming manual.

10. Commissioning Verification

After download, perform the following checks on the runtime station:

  1. Static open test: Force the Visible tag to 1 from the HMI tag table. The Screen Window must appear with the static screen content.
  2. Dynamic tag prefix test: Click two different faceplate instances in sequence. The pop-up must show different tag values matching each instance's namespace.
  3. Close test: Force the Visible tag to 0. The Screen Window must hide without disturbing the parent screen.
  4. Tag-prefix validation in the runtime trace: In WinCC RT Professional, enable the tag-trace view and confirm that the resolved tag names match the expected prefix + suffix pattern.
  5. Multi-monitor test: If the project uses two Screen Windows on two monitors, open both with different content and confirm that closing one does not affect the other.

11. Best Practices

  • Keep the embedded screen's tag names short and consistent so the tag prefix remains readable at the project level.
  • Prefer a single, dedicated tag (e.g. ActivePopupPrefix) for the tag prefix, written by the click event, instead of hard-coding the prefix on the Screen Window object. This makes the pop-up reusable across many source objects.
  • Use one HMI tag for the Visible state of every Screen Window in the project. Naming convention: <ScreenWindowName>_Visible.
  • Do not place faceplate instances inside the Screen Window's embedded screen. Build the pop-up content as native screen objects.
  • Validate the project on the target runtime version before commissioning. The object model of the Screen Window is stable from V13 SP1 onward, but the exact animation events differ slightly between V13/V14 and V15+.

12. Quick Reference: Property Map

Property Purpose Typical Binding
Screen Static screen displayed in the window Screen name from the project tree, or a string tag for dynamic selection
Tag prefix String prepended to every tag name in the embedded screen Static string, or VB-script-driven string tag
Visible Show / hide the Screen Window Boolean tag, or animation event
Position / Size Coordinates and dimensions of the window on the parent screen Static; optionally dynamic via tag
Layer Z-order relative to other screen objects Integer 0–15 (default 0)

Which TIA Portal version first introduced the WinCC Professional Screen Window?

The Screen Window object was first released in TIA Portal V13 SP1 for WinCC Professional. V12 and the V13 base release do not contain the object, and the toolbox icon is locked. Reference: Siemens Support 106567433.

Can I place a faceplate instance inside a Screen Window pop-up?

No. The runtime cannot resolve the faceplate's interface tags through the Screen Window's tag prefix, which results in unresolved tags and click-through errors. Build the pop-up content using native screen controls on the embedded screen instead of nesting a faceplate.

Is the Screen Window feature available on Comfort Panels such as the TP1500?

No. The Screen Window is a WinCC Professional / RT Professional feature. Comfort Panels (TP700, TP900, TP1200, TP1500, TP1900, TP2200) use a different Permanent window mechanism for fixed header/footer layouts. Confirm the target runtime is PC-based before applying the procedures in this article.

How do I open a Screen Window with a click on a faceplate instance?

Use a VB script on the click event that writes the tag prefix of the clicked instance to the Screen Window's TagPrefix property, then writes 1 to the Boolean tag bound to the Screen Window's Visibility animation. See Section 7 for a working code sample.

Why does the compile fail with "Tag prefix is incomplete" in TIA V15.1?

The Tag prefix property must be a complete, valid namespace string. Empty values, unresolved placeholders, or partial names cause the compile warning. Confirm the tag prefix matches a valid HMI or PLC tag namespace and rebuild the project.

Back to blog