Modifying the Windows Control Initialization String

  • Article

Windows controls require containers to host them in the Agent Desktop. Broadly, there are three types of containers:

  • Parent Container: The container that hosts one or more of the windows controls.
  • Nested Container: The container that hosts other container.
  • Related Container: The container that is invoked by a control on hosted in a different container.

The initialization string for a parent container is as follows:

<?xml version="1.0" encoding="utf-16"?>
   <initstring>
      <assemblyInfo>
         <URL>C:\Program Files\Microsoft CCF 2009\AgentDesktop\Microsoft.Ccf.Mce.Containers.AIF.dll</URL>
         <type>Microsoft.Ccf.Mce.Containers.AIF.MceAifContainer</type>
      </assemblyInfo>

      <adapter>
         <URL>Microsoft.Ccf.HostedApplicationToolkit.AutomationHosting</URL><type>Microsoft.Ccf.HostedApplicationToolkit.AutomationHosting.AutomationAdapter</type>
      </adapter>

      <DataDrivenAdapterBindings>
         <Type>Microsoft.Ccf.HostedApplicationToolkit.DataDrivenAdapter.WinDataDrivenAdapter, Microsoft.Ccf.HostedApplicationToolkit.DataDrivenAdapter</Type>
      <Controls />
      </DataDrivenAdapterBindings>

      <global />
      <displayGroup>MainPanel</displayGroup>
         <optimumSize x="800" y="600" />
         <minimumSize x="640" y="420" />
   </initstring>

For nested container, you can include the other containers in the <Controls> tag.

For related containers, we include the container name from which it is invoked (parent container) to reference the parent control. The initialization string for a related container is as follows:

<initstring>
  <assemblyInfo>
    <URL>[path]\Microsoft.Ccf.Mce.Containers.AIF.dll</URL>
    <type>Microsoft.Ccf.Mce.Containers.AIF.MceAifContainer</type>
    <ContainerName>MCEContainer1</ContainerName>
    <RelatedContainer>MCEContainer</RelatedContainer>
  </assemblyInfo>
</initstring>