Communicator UI: 5.2 FoamProgressDialog: Setting Up the Template

5.1 FoamProgressDialog Instance Data | Next:

A FoamProgressDialogClass object (and its children) should be contained within its own resource. The resource should remain unattached to the application tree. The routine PutUpDialogViaUIThread() will take care of copying and attaching the group of objects.

To set up your template, perform the following steps:

Declare the template's resource and make it notDetachable .
Define the root object as a FoamProgressDialogClass object.
Set the root object not usable (~GS_USABLE).
Set the object GIA_SYS_MODAL (and make sure to turn off its default GIA_MODAL flag).
Set the FPDI_descriptionText instance field with text describing the action.
Set FPDI_statusText with text to reside along the status indicator.
Set HINT_DRAW_IN_BOX.

Code Display 2-12 FoamProgressDialog Template

@start FoamProgressDialogTemplate, notDetachable;

@chunk TCHAR DescriptionText[] = "While, we're waiting a series of dots will appear below."

@chunk TCHAR StatusText[] = "Here are the dots: ";

@object FoamProgressDialogClass ProgressSample = {
    FPDI_descriptionText = @DescriptionText;
    FPDI_statusText = @StatusText;
    GII_attrs = (@default | GIA_SYS_MODAL) & ~GIA_MODAL;
    GI_states = (@default) & ~GS_USABLE;
    HINT_DRAW_IN_BOX;
}

@end FoamProgressDialogTemplate;

GEOS SDK TechDocs |

5.1 FoamProgressDialog Instance Data | Next:

5.3 Using a FoamProgressDialog