//--------------------------------------------------------------------//
        //                                                        M e t h o d //
        // r b C o l o u r M o d e P C L _ S i m p l e _ C l i c k            //
        //--------------------------------------------------------------------//
        //                                                                    //
        // Radio button selecting PCL 'Simple colour' mode.                   //
        //                                                                    //
        //--------------------------------------------------------------------//

        private void rbColourModePCL_Simple_Click(object sender,
                                                  RoutedEventArgs e)
        {
            if (_crntPDL == ToolCommonData.ePrintLang.PCL)
            {
                _indxColourTypePCL = eColourType.PCL_Simple;

                initialiseDescColour();

                grpColourModePCL_CID.Visibility   = Visibility.Hidden;
                grpColourModePCLFormat.Visibility = Visibility.Hidden;
            }
        }
        //--------------------------------------------------------------------//
        //                                                        M e t h o d //
        // r b C o l o u r M o d e P C L X L _R G B _ C l i c k               //
        //--------------------------------------------------------------------//
        //                                                                    //
        // Radio button selecting 'PCL XL RGB' colour space.                  //
        //                                                                    //
        //--------------------------------------------------------------------//

        private void rbColourModePCLXL_RGB_Click(object sender,
                                                 RoutedEventArgs e)
        {
            if (_crntPDL == ToolCommonData.ePrintLang.PCLXL)
            {
                _indxColourTypePCLXL = eColourType.PCLXL_RGB;
            }

            initialiseDescColour();

            if (_flagColourFmtHexPCLXL)
            {
                rbColourOptPCLXLFmtHex.IsChecked = true;
            }
            else
            {
                rbColourOptPCLXLFmtDec.IsChecked = true;
            }

            colourMapPCLXL_RGB_Display(_flagColourFmtHexPCLXL);

            tabColourPCLXLModes.SelectedItem = tabColourModePCLXL_RGB;
        }
        //--------------------------------------------------------------------//
        //                                                        M e t h o d //
        // r b C o l o u r M o d e P C L _ I m a g i n g _ C l i c k          //
        //--------------------------------------------------------------------//
        //                                                                    //
        // Radio button selecting 'PCL imaging' mode.                         //
        //                                                                    //
        //--------------------------------------------------------------------//

        private void rbColourModePCL_Imaging_Click(object sender,
                                                   RoutedEventArgs e)
        {
            if (_crntPDL == ToolCommonData.ePrintLang.PCL)
            {
                _indxColourTypePCL = eColourType.PCL_Imaging;

                initialiseDescColour();

                if (_flagColourFmtHexPCL)
                {
                    rbColourOptPCLFmtHex.IsChecked = true;
                }
                else
                {
                    rbColourOptPCLFmtDec.IsChecked = true;
                }

                colourMapPCL_CID_Display(_flagColourFmtHexPCL);

                grpColourModePCL_CID.Visibility   = Visibility.Visible;
                grpColourModePCLFormat.Visibility = Visibility.Visible;
            }
        }
        //--------------------------------------------------------------------//
        //                                                        M e t h o d //
        // m e t r i c s L o a d D a t a C o l o u r                          //
        //--------------------------------------------------------------------//
        //                                                                    //
        // Load current metrics from persistent storage.                      //
        //                                                                    //
        //--------------------------------------------------------------------//

        public void metricsLoadDataColour()
        {
            Int32 tmpInt = 0;

            ToolMiscSamplesPersist.loadDataTypeColour(
                "PCL",
                ref tmpInt,
                ref _flagColourFormAsMacroPCL,
                ref _flagColourFmtHexPCL);

            if (tmpInt == (Int32)eColourType.PCL_Simple)
            {
                _indxColourTypePCL = eColourType.PCL_Simple;
            }
            else
            {
                _indxColourTypePCL = eColourType.PCL_Imaging;
            }

            _samplesPCL_CID = new Int32 [_sampleCtPCL_CID];

            ToolMiscSamplesPersist.loadDataTypeColourSample(
                "PCL",
                "Imaging",
                _sampleCtPCL_CID,
                ref _samplesPCL_CID,
                false);

            //----------------------------------------------------------------//

            ToolMiscSamplesPersist.loadDataTypeColour(
                "PCLXL",
                ref tmpInt,
                ref _flagColourFormAsMacroPCLXL,
                ref _flagColourFmtHexPCLXL);

            if (tmpInt == (Int32)eColourType.PCLXL_Gray)
            {
                _indxColourTypePCLXL = eColourType.PCLXL_Gray;
            }
            else
            {
                _indxColourTypePCLXL = eColourType.PCLXL_RGB;
            }

            _samplesPCLXL_Gray = new Int32 [_sampleCtPCLXL_Gray];

            ToolMiscSamplesPersist.loadDataTypeColourSample(
                "PCLXL",
                "Gray",
                _sampleCtPCLXL_Gray,
                ref _samplesPCLXL_Gray,
                true);

            _samplesPCLXL_RGB = new Int32 [_sampleCtPCLXL_RGB];

            ToolMiscSamplesPersist.loadDataTypeColourSample(
                "PCLXL",
                "RGB",
                _sampleCtPCLXL_RGB,
                ref _samplesPCLXL_RGB,
                false);
        }
        //--------------------------------------------------------------------//
        //                                                        M e t h o d //
        // i n i t i a l i s e D a t a C o l o u r                            //
        //--------------------------------------------------------------------//
        //                                                                    //
        // Initialise 'Colour' data.                                          //
        //                                                                    //
        //--------------------------------------------------------------------//

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

            //  chkMiscFormAsMacro.Visibility = Visibility.Visible;

            if (_crntPDL == ToolCommonData.ePrintLang.PCL)
            {
                tabColourData.SelectedItem = tabColourModePCL;

                if (_indxColourTypePCL == eColourType.PCL_Imaging)
                {
                    rbColourModePCL_Imaging.IsChecked = true;

                    grpColourModePCL_CID.Visibility   = Visibility.Visible;
                    grpColourModePCLFormat.Visibility = Visibility.Visible;

                    if (_flagColourFmtHexPCL)
                    {
                        rbColourOptPCLFmtHex.IsChecked = true;
                    }
                    else
                    {
                        rbColourOptPCLFmtDec.IsChecked = true;
                    }

                    colourMapPCL_CID_Display(_flagColourFmtHexPCL);
                }
                else
                {
                    _indxColourTypePCL = eColourType.PCL_Simple;

                    rbColourModePCL_Simple.IsChecked = true;

                    grpColourModePCL_CID.Visibility   = Visibility.Hidden;
                    grpColourModePCLFormat.Visibility = Visibility.Hidden;
                }

                if (_flagColourFormAsMacroPCL)
                {
                    chkOptFormAsMacro.IsChecked = true;
                }
                else
                {
                    chkOptFormAsMacro.IsChecked = false;
                }
            }
            else
            {
                tabColourData.SelectedItem = tabColourOptPCLXL;

                if (_indxColourTypePCLXL == eColourType.PCLXL_RGB)
                {
                    rbColourModePCLXL_RGB.IsChecked = true;

                    tabColourPCLXLModes.SelectedItem = tabColourModePCLXL_RGB;

                    if (_flagColourFmtHexPCLXL)
                    {
                        rbColourOptPCLXLFmtHex.IsChecked = true;
                    }
                    else
                    {
                        rbColourOptPCLXLFmtDec.IsChecked = true;
                    }

                    colourMapPCLXL_RGB_Display(_flagColourFmtHexPCLXL);
                }
                else
                {
                    _indxColourTypePCLXL = eColourType.PCLXL_Gray;

                    rbColourModePCLXL_Gray.IsChecked = true;

                    tabColourPCLXLModes.SelectedItem = tabColourModePCLXL_Gray;

                    if (_flagColourFmtHexPCLXL)
                    {
                        rbColourOptPCLXLFmtHex.IsChecked = true;
                    }
                    else
                    {
                        rbColourOptPCLXLFmtDec.IsChecked = true;
                    }

                    colourMapPCLXL_Gray_Display(_flagColourFmtHexPCLXL);
                }

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

            initialiseDescColour();
        }