//--------------------------------------------------------------------//
        //                                                        M e t h o d //
        // i n i t i a l i s e D a t a P a t t e r n                          //
        //--------------------------------------------------------------------//
        //                                                                    //
        // Initialise 'Patterns' data.                                        //
        //                                                                    //
        //--------------------------------------------------------------------//

        private void initialiseDataPattern()
        {
            lbOrientation.Visibility = Visibility.Hidden;
            cbOrientation.Visibility = Visibility.Hidden;

            if (_crntPDL == ToolCommonData.ePrintLang.PCL)
            {
                if (_indxPatternTypePCL == ePatternType.Shading)
                {
                    rbPatternTypeShading.IsChecked = true;
                }
                else if (_indxPatternTypePCL == ePatternType.XHatch)
                {
                    rbPatternTypeXHatch.IsChecked = true;
                }
                else
                {
                    _indxPatternTypePCL = ePatternType.Shading;

                    rbPatternTypeShading.IsChecked = true;
                }

                if (_flagPatternFormAsMacroPCL)
                {
                    chkOptFormAsMacro.IsChecked = true;
                }
                else
                {
                    chkOptFormAsMacro.IsChecked = false;
                }
            }
            else
            {
                if (_indxPatternTypePCLXL == ePatternType.Shading)
                {
                    rbPatternTypeShading.IsChecked = true;
                }
                else if (_indxPatternTypePCLXL == ePatternType.XHatch)
                {
                    rbPatternTypeXHatch.IsChecked = true;
                }
                else
                {
                    _indxPatternTypePCLXL = ePatternType.Shading;

                    rbPatternTypeShading.IsChecked = true;
                }

                if (_flagPatternFormAsMacroPCLXL)
                {
                    chkOptFormAsMacro.IsChecked = true;
                }
                else
                {
                    chkOptFormAsMacro.IsChecked = false;
                }
            }

            initialiseDescPattern();
        }
        //--------------------------------------------------------------------//
        //                                                        M e t h o d //
        // m e t r i c s L o a d D a t a P a t t e r n                        //
        //--------------------------------------------------------------------//
        //                                                                    //
        // Load current metrics from persistent storage.                      //
        //                                                                    //
        //--------------------------------------------------------------------//

        public void metricsLoadDataPattern()
        {
            Int32 tmpInt = 0;

            ToolMiscSamplesPersist.loadDataTypePattern(
                "PCL",
                ref tmpInt,
                ref _flagPatternFormAsMacroPCL);

            if (tmpInt == (Int32)ePatternType.XHatch)
            {
                _indxPatternTypePCL = ePatternType.XHatch;
            }
            else
            {
                _indxPatternTypePCL = ePatternType.Shading;
            }

            ToolMiscSamplesPersist.loadDataTypePattern(
                "PCLXL",
                ref tmpInt,
                ref _flagPatternFormAsMacroPCLXL);

            if (tmpInt == (Int32)ePatternType.XHatch)
            {
                _indxPatternTypePCLXL = ePatternType.XHatch;
            }
            else
            {
                _indxPatternTypePCLXL = ePatternType.Shading;
            }
        }
        //--------------------------------------------------------------------//
        //                                                        M e t h o d //
        // r b P a t t e r n T y p e X H a t c h _ C l i c k                  //
        //--------------------------------------------------------------------//
        //                                                                    //
        // Radio button selecting 'Cross-hatch' patterns.                     //
        //                                                                    //
        //--------------------------------------------------------------------//

        private void rbPatternTypeXHatch_Click(object sender,
                                               RoutedEventArgs e)
        {
            if (_crntPDL == ToolCommonData.ePrintLang.PCL)
            {
                _indxPatternTypePCL = ePatternType.XHatch;
            }
            else
            {
                _indxPatternTypePCLXL = ePatternType.XHatch;
            }

            initialiseDescPattern();
        }