WizardStepActivated

Note: This page includes content based on the F1 documentation for Centura development. It may be partially converted to support APF development, but should be regarded to be of uncertain actuality. It is provided as is. Eventually, it should be replaced by documentation available from within Visual Studio.

SalNumber WizardStepActivated( SalString sStep )

The WizardStepActivated hook method is called by the framework when just after a step has been activated. Application should override this method to perform task upon activation of a step.

Parameters

Returns

This method does not return a value.

Comments

A typical task to perform on activation of a step would be to display any values previously entered for this step (for example if the user has activated this step before, moved on to another step, and now reactivated this step)

For steps that use external windows it is usually better to override the FrameActivate method in the external window to perform activation tasks.

Example

Function: WizardStepActivated
   Actions
       ! Display last entered values
       Set rbLocalPrinter = PalStrToBoolean( MsgData.FindAttribute( 'LOCAL_PRINTER', 'TRUE' ) )
       Set rbNetworkPrinter = Not PalStrToBoolean( MsgData.FindAttribute( 'LOCAL_PRINTER', 'TRUE' ) )
       Set dfPrinterName = MsgData.FindAttribute( 'PRINTER_NAME', STRING_Null )

 C# coding sample

public new SalNumber WizardStepActivated(SalString sStep)
{
	#region Local Variables
	#endregion
	
	#region Actions
	using (new SalContext(this))
	{
		if (sStep == "Step2") 
		{
			Sal.SetFocus(lbCompList);
		}
		if (sStep == "Step3") 
		{
			Sal.SetFocus(lbLngList);
		}
		if (sStep == "Step4") 
		{
			if (cbTemplate.Checked) 
			{
				Sal.HideWindowAndLabel(dfHeading2);
				Sal.HideWindowAndLabel(dfHeadingLng2);
			}
			else
			{
				Sal.HideWindowAndLabel(dfHeading3);
				Sal.HideWindowAndLabel(dfHeadingLng3);
			}
			if (!(cbTranslation.Checked)) 
			{
				Sal.HideWindowAndLabel(dfHeadingLng2);
				Sal.HideWindowAndLabel(dfHeadingLng3);
			}
			Sal.SetFocus(pbBrowse);
		}
	}
		return 0;
	#endregion
}