Skip to content

showdialog-action.md

Latest commit

 

History

History
49 lines (37 loc) · 3.18 KB

showdialog-action.md

File metadata and controls

49 lines (37 loc) · 3.18 KB
title Configuration Manager ShowDialog Action
ms.date 09/20/2016
description In Configuration Manager, the ShowDialog action opens a property sheet or regular dialog box in the console. With the ShowDialog action, you can display existing dialog boxes or extension dialog boxes that you create.
ms.subservice sdk
ms.topic article
ms.collection tier3

Configuration Manager ShowDialog Action

The ShowDialog action, in Configuration Manager, opens a property sheet or regular dialog box in the Configuration Manager console. With the ShowDialog action, you can display existing dialog boxes or extension dialog boxes that you create.

The following attributes and elements are specific to an action that opens a dialog box:

  • The ActionDescription element Class attribute is set to ShowDialog.

  • The DialogID element is the identifier for a property sheet or dialog box displayed in a dialog. It matches the name of the form XML file in the %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Forms folder.

Sample ShowDialog Action XML

The following XML shows how to show a dialog box with the identifier PrototypeForm:

<ActionDescription Class="ShowDialog" DisplayName="Test Action (dialog)" MnemonicDisplayName="Mnemonic" Description="Description"> <ShowOn>              <string>DefaultHomeTab</string>      <string>ContextMenu</string>           </ShowOn>
 <DialogId>PrototypeForm</DialogId>
</ActionDescription>

Sample Properties ShowDialog Action XML

The following attributes and elements are specific to an action that adds a property page to a properties property sheet:

  • The ActionDescription element ActionVerb attribute is set to Properties.

  • The DialogID element identifies a property sheet containing the property page to be displayed in the Properties dialog.

    The following XML shows how to integrate a property page (PrototypeForm) into a properties context menu option:

<ActionDescription ActionVerb="Properties" Class="ShowDialog">  <ShowOn>    <string>DefaultHomeTab</string>    <string>ContextMenu</string>  </ShowOn>  <DialogId>PrototypeForm</DialogId>
</ActionDescription>

For more information about creating and showing dialog boxes, see About console forms.

See Also

About Configuration Manager Dialog Boxes Configuration Manager Actions How to Create a Configuration Manager Action How to Create Form XML for a Configuration Manager Property Sheet How to Create Form XML for a Configuration Manager Dialog Box How to Find a Configuration Manager Node GUID