Microsoft-Windows-Embedded-DialogFilterService (Industry 8.1)
7/8/2014
Review the settings and examples of the Microsoft-Windows-Embedded-DialogFilterService feature package for Windows System Image Manager (SIM) in Windows Embedded 8.1 Industry (Industry 8.1).
You can use Dialog Filter to control which dialog boxes and windows are displayed on the screen and to automatically handle dialog boxes by taking a default action, such as to close or show the dialog box. Also, in Windows Embedded 8.1 Industry (Industry 8.1), you can configure Dialog Filter to always show dialog boxes from specific processes, regardless of the specified default action.
Settings available in Windows SIM
DialogFilterDefaultConfiguration settings
You can configure Dialog Filter to take a default action for any top-level dialog box that is not blocked or part of a protected process. The default action can be to close or show the dialog box. If the default action is not defined, then Dialog Filter shows the dialog box by default.
Setting |
Description |
---|---|
SetDefaultActionToShow |
Specifies whether the default for any dialog box is to display or hide the dialog box. |
BlockedWindow settings
Each time a process creates or attempts to show a dialog box or window, Dialog Filter examines the properties of the new dialog box to determine if any actions need to be taken on the dialog box. Dialog Filter blocks any dialog box that matches entries in the blocked dialog box list.
Setting |
Description |
---|---|
Action |
Specifies whether to add, modify, or remove a blocked window list item. |
Action |
Specifies the required action on a blocked window that is set by the developer at design time. |
ActionList |
Specifies a list of valid actions that can be performed on a blocked window. Valid actions can vary depending on the window. Some examples of common actions are minimize, maximize, and close. |
id |
Specifies a unique identifier for the blocked windows configuration. |
NumOfChild |
Specifies the number of top-level child windows of a blocked window. |
ProcessName |
Specifies the full path of the process that creates the blocked window. |
WindowTitle |
Specifies the title of the blocked window. |
Content Info | CHILD settings
Setting |
Description |
---|---|
Action |
Specifies whether to add, modify, or remove a child window list item. |
ChildIdentifier |
Specifies a unique identifier for a child control of a blocked window. |
ControlName |
Specifies a list of the names of all immediate child controls in the blocked window. |
ControlType |
Specifies the control type identifier for a child control of a blocked window. |
Protected Processes | Protected Process settings
You can configure Dialog Filter to indicate that a specific process is protected. This means that if a dialog box belongs to a protected process, the dialog box is shown, regardless of the configured default action. Dialog boxes that are specifically blocked are still blocked for protected processes.
Setting |
Description |
---|---|
Action |
Specifies whether to add, modify, or remove a protected process list item. |
id |
Specifies a unique identifier for the protected process configuration. |
ProcessName |
Specifies the full path of the protected process. |
Settings details
DialogFilterDefaultConfiguration settings
SetDefaultActionToShow
Specifies whether the default for any dialog box is to display or hide the dialog box.
- Type
Boolean
Values
Value
Description
true
Display the dialog box.
false
Hide the dialog box.
- Parent hierarchy
Microsoft-Windows-Embedded-DialogFilterService | DialogFilterDefaultConfiguration | SetDefaultActionToShow
- Valid passes
specialize
XML example
<settings pass="specialize"> <component name="Microsoft-Windows-Embedded-DialogFilterService" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <DialogFilterDefaultConfiguration> <SetDefaultActionToShow>false</SetDefaultActionToShow> </DialogFilterDefaultConfiguration> </component> </settings>
BlockedWindow settings
Action
Specifies whether to add, modify, or remove a blocked windows list item.
Values
Value
Description
AddListItem
Add a new blocked window to the list.
Modify
Modify an existing list item.
RemoveListItem
Remove a blocked window from the list.
- Parent hierarchy
Microsoft-Windows-Embedded-DialogFilterService | DialogFilterDefaultConfiguration | BlockedWindows | BlockedWindow | Action
- Valid passes
specialize
XML example
<settings pass="specialize"> <component name="Microsoft-Windows-Embedded-DialogFilterService" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <DialogFilterDefaultConfiguration> <BlockedWindows> <BlockedWindow wcm:action="add"> <ContentInfo> <CHILD wcm:action="add"> <ControlType>50000</ControlType> <ChildIdentifier>CHILD0</ChildIdentifier> <ControlName>OK_Button</ControlName> </CHILD> </ContentInfo> <Action>OK</Action> <ActionList>Close</ActionList> <id>2</id> <NumOfChild>6</NumOfChild> <ProcessName>C:\Program Files\Internet Explorer\iexplore.exe</ProcessName> <WindowTitle>Internet Options</WindowTitle> </BlockedWindow> </BlockedWindows> </DialogFilterDefaultConfiguration> </component> </settings>
Action
Specifies the required action on a blocked window that is set by the developer at design time.
- Type
String, max length 255
Values
Value
Description
Action
Specifies the required action on a blocked window that is set by the developer at design time.
- Parent hierarchy
Microsoft-Windows-Embedded-DialogFilterService | DialogFilterDefaultConfiguration | BlockedWindows | BlockedWindow | Action
- Valid passes
specialize
XML example
<settings pass="specialize"> <component name="Microsoft-Windows-Embedded-DialogFilterService" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <DialogFilterDefaultConfiguration> <BlockedWindows> <BlockedWindow wcm:action="add"> <ContentInfo> <CHILD wcm:action="add"> <ControlType>50000</ControlType> <ChildIdentifier>CHILD0</ChildIdentifier> <ControlName>OK_Button</ControlName> </CHILD> </ContentInfo> <Action>OK</Action> <ActionList>Close</ActionList> <id>2</id> <NumOfChild>6</NumOfChild> <ProcessName>C:\Program Files\Internet Explorer\iexplore.exe</ProcessName> <WindowTitle>Internet Options</WindowTitle> </BlockedWindow> </BlockedWindows> </DialogFilterDefaultConfiguration> </component> </settings>
ActionList
Specifies a list of valid actions that can be performed on a blocked window. Valid actions can vary depending on the window. Some examples of common actions are minimize, maximize, and close.
- Type
String[]
Values
Value
Description
ActionList
Specifies a list of valid actions that can be performed on a blocked window. Valid actions can vary depending on the window. Some examples of common actions are minimize, maximize, and close.
The default value is System.Object[]
- Parent hierarchy
Microsoft-Windows-Embedded-DialogFilterService | DialogFilterDefaultConfiguration | BlockedWindows | BlockedWindow | ActionList
- Valid passes
specialize
XML example
<settings pass="specialize"> <component name="Microsoft-Windows-Embedded-DialogFilterService" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <DialogFilterDefaultConfiguration> <BlockedWindows> <BlockedWindow wcm:action="add"> <ContentInfo> <CHILD wcm:action="add"> <ControlType>50000</ControlType> <ChildIdentifier>CHILD0</ChildIdentifier> <ControlName>OK_Button</ControlName> </CHILD> </ContentInfo> <Action>OK</Action> <ActionList>Close</ActionList> <id>2</id> <NumOfChild>6</NumOfChild> <ProcessName>C:\Program Files\Internet Explorer\iexplore.exe</ProcessName> <WindowTitle>Internet Options</WindowTitle> </BlockedWindow> </BlockedWindows> </DialogFilterDefaultConfiguration> </component> </settings>
id
Specifies a unique identifier for the blocked windows configuration.
- Type
UInt32
Values
Value
Description
id
Specifies a unique identifier for the blocked windows configuration.
- Parent hierarchy
Microsoft-Windows-Embedded-DialogFilterService | DialogFilterDefaultConfiguration | BlockedWindows | BlockedWindow | id
- Valid passes
specialize
XML example
<settings pass="specialize"> <component name="Microsoft-Windows-Embedded-DialogFilterService" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <DialogFilterDefaultConfiguration> <BlockedWindows> <BlockedWindow wcm:action="add"> <ContentInfo> <CHILD wcm:action="add"> <ControlType>50000</ControlType> <ChildIdentifier>CHILD0</ChildIdentifier> <ControlName>OK_Button</ControlName> </CHILD> </ContentInfo> <Action>OK</Action> <ActionList>Close</ActionList> <id>2</id> <NumOfChild>6</NumOfChild> <ProcessName>C:\Program Files\Internet Explorer\iexplore.exe</ProcessName> <WindowTitle>Internet Options</WindowTitle> </BlockedWindow> </BlockedWindows> </DialogFilterDefaultConfiguration> </component> </settings>
NumOfChild
Specifies the number of top-level child windows of a blocked window.
- Type
UInt32, Min 0, Max 255
Values
Value
Description
NumOfChild
Specifies the number of top-level child windows of a blocked window.
The default value is 0 (zero).
- Parent hierarchy
Microsoft-Windows-Embedded-DialogFilterService | DialogFilterDefaultConfiguration | BlockedWindows | BlockedWindow | NumOfChild
- Valid passes
specialize
XML example
<settings pass="specialize"> <component name="Microsoft-Windows-Embedded-DialogFilterService" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <DialogFilterDefaultConfiguration> <BlockedWindows> <BlockedWindow wcm:action="add"> <ContentInfo> <CHILD wcm:action="add"> <ControlType>50000</ControlType> <ChildIdentifier>CHILD0</ChildIdentifier> <ControlName>OK_Button</ControlName> </CHILD> </ContentInfo> <Action>OK</Action> <ActionList>Close</ActionList> <id>2</id> <NumOfChild>6</NumOfChild> <ProcessName>C:\Program Files\Internet Explorer\iexplore.exe</ProcessName> <WindowTitle>Internet Options</WindowTitle> </BlockedWindow> </BlockedWindows> </DialogFilterDefaultConfiguration> </component> </settings>
ProcessName
Specifies the full path of the process that creates the blocked window.
- Type
String, max length 260
Values
Value
Description
ProcessName
Specifies the full path of the process that creates the blocked window.
- Parent hierarchy
Microsoft-Windows-Embedded-DialogFilterService | DialogFilterDefaultConfiguration | BlockedWindows | BlockedWindow | ProcessName
- Valid passes
specialize
XML example
<settings pass="specialize"> <component name="Microsoft-Windows-Embedded-DialogFilterService" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <DialogFilterDefaultConfiguration> <BlockedWindows> <BlockedWindow wcm:action="add"> <ContentInfo> <CHILD wcm:action="add"> <ControlType>50000</ControlType> <ChildIdentifier>CHILD0</ChildIdentifier> <ControlName>OK_Button</ControlName> </CHILD> </ContentInfo> <Action>OK</Action> <ActionList>Close</ActionList> <id>2</id> <NumOfChild>6</NumOfChild> <ProcessName>C:\Program Files\Internet Explorer\iexplore.exe</ProcessName> <WindowTitle>Internet Options</WindowTitle> </BlockedWindow> </BlockedWindows> </DialogFilterDefaultConfiguration> </component> </settings>
WindowTitle
Specifies the title of the blocked window.
- Type
String, max length 255
Values
Value
Description
WindowTitle
Specifies the title of the blocked window.
- Parent hierarchy
Microsoft-Windows-Embedded-DialogFilterService | DialogFilterDefaultConfiguration | BlockedWindows | BlockedWindow | WindowTitle
- Valid passes
specialize
XML example
<settings pass="specialize"> <component name="Microsoft-Windows-Embedded-DialogFilterService" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <DialogFilterDefaultConfiguration> <BlockedWindows> <BlockedWindow wcm:action="add"> <ContentInfo> <CHILD wcm:action="add"> <ControlType>50000</ControlType> <ChildIdentifier>CHILD0</ChildIdentifier> <ControlName>OK_Button</ControlName> </CHILD> </ContentInfo> <Action>OK</Action> <ActionList>Close</ActionList> <id>2</id> <NumOfChild>6</NumOfChild> <ProcessName>C:\Program Files\Internet Explorer\iexplore.exe</ProcessName> <WindowTitle>Internet Options</WindowTitle> </BlockedWindow> </BlockedWindows> </DialogFilterDefaultConfiguration> </component> </settings>
Content Info | CHILD settings
Action
Specifies whether to add, modify, or remove a child window list item.
Values
Value
Description
AddListItem
Add a new CHILD item to the list.
Modify
Modify an existing CHILD item.
RemoveListItem
Remove a CHILD item from the list.
- Parent hierarchy
Microsoft-Windows-Embedded-DialogFilterService | DialogFilterDefaultConfiguration | BlockedWindows | BlockedWindow | ContentInfo | CHILD | Action
- Valid passes
specialize
XML example
<settings pass="specialize"> <component name="Microsoft-Windows-Embedded-DialogFilterService" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <DialogFilterDefaultConfiguration> <BlockedWindows> <BlockedWindow wcm:action="add"> <ContentInfo> <CHILD wcm:action="add"> <ControlType>50000</ControlType> <ChildIdentifier>CHILD0</ChildIdentifier> <ControlName>OK_Button</ControlName> </CHILD> </ContentInfo> <Action>OK</Action> <ActionList>Close</ActionList> <id>2</id> <NumOfChild>6</NumOfChild> <ProcessName>C:\Program Files\Internet Explorer\iexplore.exe</ProcessName> <WindowTitle>Internet Options</WindowTitle> </BlockedWindow> </BlockedWindows> </DialogFilterDefaultConfiguration> </component> </settings>
ChildIdentifier
Specifies a unique identifier for a child control of a blocked window.
- Type
String
Values
Value
Description
ChildIdentifier
Specifies a unique identifier for a child control of a blocked window.
The 255 available values are a range of strings from CHILD0 to CHILD254.
- Parent hierarchy
Microsoft-Windows-Embedded-DialogFilterService | DialogFilterDefaultConfiguration | BlockedWindows | BlockedWindow | ContentInfo | CHILD | ChildIdentifier
- Valid passes
specialize
- XML example
ControlName
Specifies a list of the names of all immediate child controls in the blocked window.
- Type
String, max length 255
Values
Value
Description
ControlName
Specifies a list of the names of all immediate child controls in the blocked window.
- Parent hierarchy
Microsoft-Windows-Embedded-DialogFilterService | DialogFilterDefaultConfiguration | BlockedWindows | BlockedWindow | ContentInfo | CHILD | ControlName
- Valid passes
specialize
XML example
<settings pass="specialize"> <component name="Microsoft-Windows-Embedded-DialogFilterService" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <DialogFilterDefaultConfiguration> <BlockedWindows> <BlockedWindow wcm:action="add"> <ContentInfo> <CHILD wcm:action="add"> <ControlType>50000</ControlType> <ChildIdentifier>CHILD0</ChildIdentifier> <ControlName>OK_Button</ControlName> </CHILD> </ContentInfo> <Action>OK</Action> <ActionList>Close</ActionList> <id>2</id> <NumOfChild>6</NumOfChild> <ProcessName>C:\Program Files\Internet Explorer\iexplore.exe</ProcessName> <WindowTitle>Internet Options</WindowTitle> </BlockedWindow> </BlockedWindows> </DialogFilterDefaultConfiguration> </component> </settings>
ControlType
Specifies the control type identifier for a child control of a blocked window.
- Type
UInt32
Values
Value
Description
50000
Specifies the Button control type.
50001
Specifies the Calendar control type.
50002
Specifies the CheckBox control type.
50003
Specifies the ComboBox control type.
50025
Specifies the Custom control type.
50028
Specifies the DataGrid control type.
50029
Specifies the DataItem control type.
50030
Specifies the Document control type.
50004
Specifies the Edit control type.
50026
Specifies the Group control type.
50034
Specifies the Header control type.
50035
Specifies the HeaderItem control type.
50005
Specifies the Hyperlink control type.
50006
Specifies the Image control type.
50008
Specifies the List control type.
50007
Specifies the ListItem control type.
50010
Specifies the MenuBar control type.
50009
Specifies the Menu control type.
50011
Specifies the MenuItem control type.
50033
Specifies the Pane control type.
50012
Specifies the ProgressBar control type.
50013
Specifies the RadioButton control type.
50014
Specifies the ScrollBar control type.
50038
Specifies the Separator control type.
50015
Specifies the Slider control type.
50016
Specifies the Spinner control type.
50031
Specifies the SplitButton control type.
50017
Specifies the StatusBar control type.
50018
Specifies the Tab control type.
50019
Specifies the TabItem control type.
50036
Specifies the Table control type.
50020
Specifies the Text control type.
50027
Specifies the Thumb control type.
50037
Specifies the TitleBar control type.
50021
Specifies the ToolBar control type.
50022
Specifies the ToolTip control type.
50023
Specifies the Tree control type.
50024
Specifies the TreeItem control type.
50032
Specifies the Window control type.
- Parent hierarchy
Microsoft-Windows-Embedded-DialogFilterService | DialogFilterDefaultConfiguration | BlockedWindows | BlockedWindow | ContentInfo | CHILD | ControlType
- Valid passes
specialize
XML example
<settings pass="specialize"> <component name="Microsoft-Windows-Embedded-DialogFilterService" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <DialogFilterDefaultConfiguration> <BlockedWindows> <BlockedWindow wcm:action="add"> <ContentInfo> <CHILD wcm:action="add"> <ControlType>50000</ControlType> <ChildIdentifier>CHILD0</ChildIdentifier> <ControlName>OK_Button</ControlName> </CHILD> </ContentInfo> <Action>OK</Action> <ActionList>Close</ActionList> <id>2</id> <NumOfChild>6</NumOfChild> <ProcessName>C:\Program Files\Internet Explorer\iexplore.exe</ProcessName> <WindowTitle>Internet Options</WindowTitle> </BlockedWindow> </BlockedWindows> </DialogFilterDefaultConfiguration> </component> </settings>
ProtectedProcesses | ProtectedProcess settings
Action
Specifies whether to add, modify, or remove a protected process list item.
Values
Value
Description
AddListItem
Add a new protected process to the list.
Modify
Modify an existing list item.
RemoveListItem
Remove a protected process from the list.
- Parent hierarchy
Microsoft-Windows-Embedded-DialogFilterService | DialogFilterDefaultConfiguration | ProtectedProcesses | ProtectedProcess | Action
- Valid passes
specialize
XML example
<settings pass="specialize"> <component name="Microsoft-Windows-Embedded-DialogFilterService" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <DialogFilterDefaultConfiguration> <ProtectedProcesses> <ProtectedProcess wcm:action="add"> <id>2</id> <ProcessName>C:\Program Files\Internet Explorer\iexplore.exe</ProcessName> </ProtectedProcess> </ProtectedProcesses> </DialogFilterDefaultConfiguration> </component> </settings>
id
Specifies a unique identifier for the protected process configuration.
- Type
UInt32
Values
Value
Description
id
Specifies a unique identifier for the protected process configuration.
- Parent hierarchy
Microsoft-Windows-Embedded-DialogFilterService | DialogFilterDefaultConfiguration | ProtectedProcesses | ProtectedProcess | id
- Valid passes
specialize
XML example
<settings pass="specialize"> <component name="Microsoft-Windows-Embedded-DialogFilterService" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <DialogFilterDefaultConfiguration> <ProtectedProcesses> <ProtectedProcess wcm:action="add"> <id>2</id> <ProcessName>C:\Program Files\Internet Explorer\iexplore.exe</ProcessName> </ProtectedProcess> </ProtectedProcesses> </DialogFilterDefaultConfiguration> </component> </settings>
ProcessName
Specifies the full path of the protected process.
- Type
String, max length 260
Values
Value
Description
ProcessName
Specifies the full path of the protected process.
- Parent hierarchy
Microsoft-Windows-Embedded-DialogFilterService | DialogFilterDefaultConfiguration | ProtectedProcesses | ProtectedProcess | ProcessName
- Valid passes
specialize
XML example
<settings pass="specialize"> <component name="Microsoft-Windows-Embedded-DialogFilterService" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <DialogFilterDefaultConfiguration> <ProtectedProcesses> <ProtectedProcess wcm:action="add"> <id>2</id> <ProcessName>C:\Program Files\Internet Explorer\iexplore.exe</ProcessName> </ProtectedProcess> </ProtectedProcesses> </DialogFilterDefaultConfiguration> </component> </settings>
See Also
Concepts
Add lockdown and branding features to your image by using Windows SIM
Dialog Filter
Dialog Filter API
Create a custom filter for Dialog Filter