FrmMainApp.Startup.cs

using System;
using System.Collections.Generic;
using System.Diagnostics.CodeAnalysis;
using System.Globalization;
using System.Linq;
using System.Threading.Tasks;
using System.Windows.Forms;
using GeoTagNinja.Helpers;
using GeoTagNinja.View.DialogAndMessageBoxes;

namespace GeoTagNinja;

public partial class FrmMainApp
{
    /// <summary>
    ///     Calls the InitializeComponent
    /// </summary>
    private Task AppStartupInitializeComponentFrmMainApp()
    {
        // InitializeComponent();
        Logger.Debug(message: "Starting");

        try
        {
            InitializeComponent();
        }
        catch (Exception ex)
        {
            Logger.Fatal(message: "Error: " + ex.Message);
            CustomMessageBox customMessageBox = new(
                text: HelperControlAndMessageBoxHandling.GenericGetMessageBoxText(
                          messageBoxName: "mbx_FrmMainApp_ErrorInitializeComponent") +
                      ex.Message,
                caption: HelperControlAndMessageBoxHandling.GenericGetMessageBoxCaption(
                    captionType: HelperControlAndMessageBoxHandling.MessageBoxCaption.Error.ToString()),
                buttons: MessageBoxButtons.OK,
                icon: MessageBoxIcon.Error);
            customMessageBox.ShowDialog();
        }

        return Task.CompletedTask;
    }

    /// <summary>
    ///     Enables double-buffering so that the listview doesn't flicker
    /// </summary>
    private Task AppStartupEnableDoubleBuffering()
    {
        Logger.Debug(message: "Starting");

        try
        {
            lvw_FileList.DoubleBuffered(enable: true);
        }
        catch (Exception ex)
        {
            Logger.Fatal(message: "Error: " + ex.Message);
            CustomMessageBox customMessageBox = new(
                text: HelperControlAndMessageBoxHandling.GenericGetMessageBoxText(
                          messageBoxName: "mbx_FrmMainApp_ErrorDoubleBuffer") +
                      ex.Message,
                caption: HelperControlAndMessageBoxHandling.GenericGetMessageBoxCaption(
                    captionType: HelperControlAndMessageBoxHandling.MessageBoxCaption.Error.ToString()),
                buttons: MessageBoxButtons.OK,
                icon: MessageBoxIcon.Error);
            customMessageBox.ShowDialog();
        }

        return Task.CompletedTask;
    }


    /// <summary>
    ///     Assigns labels to various objects in the application during startup. This includes buttons, labels, checkboxes, and
    ///     other UI elements.
    ///     It also sets up tooltips for specific controls. The labels and tooltips are fetched from a data source using the
    ///     HelperDataLanguageTZ.DataReadDTObjectText method.
    /// </summary>
    private void AppStartupAssignLabelsToObjects()
    {
        Logger.Debug(message: "Starting");

        HelperNonStatic helperNonstatic = new();
        IEnumerable<Control> c = helperNonstatic.GetAllControls(control: this);
        string objectName;
        string objectText;

        GetUOMAbbreviated();

        foreach (Control cItem in c)
        {
            if (
                cItem.GetType() == typeof(MenuStrip) ||
                cItem.GetType() == typeof(ToolStrip) ||
                cItem.GetType() == typeof(Label) ||
                cItem.GetType() == typeof(Button) ||
                cItem.GetType() == typeof(CheckBox) ||
                cItem.GetType() == typeof(TabPage) ||
                cItem.GetType() == typeof(ToolStripButton) ||
                (cItem.GetType() == typeof(ListView) && cItem.Name != "lvw_FileView")
                // cItem.GetType() == typeof(ToolTip) // tooltips are not controls.
            )
            {
                if (cItem.Name == "lbl_ParseProgress")
                {
                    objectName = cItem.Name;
                    objectText = HelperDataLanguageTZ.DataReadDTObjectText(
                        objectType: HelperDataLanguageTZ.GetControlType(
                            controlType: cItem.GetType())
                       ,
                        objectName: objectName + "_Normal"
                    );
                    cItem.Text = objectText;
                    Logger.Trace(message: "" + objectName + ": " + objectText);
                }
                else if (cItem is ToolStrip ts)
                {
                    // https://www.codeproject.com/Messages/3329190/How-to-convert-a-Control-into-a-ToolStripButton.aspx
                    foreach (ToolStripItem tsi in ts.Items)
                    {
                        ToolStripButton tsb = tsi as ToolStripButton;
                        if (tsb != null)
                        {
                            objectName = tsb.Name;
                            objectText = HelperDataLanguageTZ.DataReadDTObjectText(
                                objectType: HelperDataLanguageTZ.GetControlType(
                                    controlType: tsb.GetType()),
                                objectName: tsb.Name
                            );
                            tsb.ToolTipText = objectText;
                            Logger.Trace(message: "" + objectName + ": " + objectText);
                        }
                    }
                }
                else if (cItem is ListView lvw)
                {
                    foreach (ColumnHeader columnHeader in lvw.Columns)
                    {
                        // this is entirely stupid but .Name in this case returns nothing of use even though it's hard-coded in the Designer.
                        // alas .Text works -- fml.
                        objectName = columnHeader.Text;
                        objectText = HelperDataLanguageTZ.DataReadDTObjectText(
                            objectType: HelperDataLanguageTZ.GetControlType(
                                controlType: columnHeader.GetType()),
                            objectName: objectName
                        );
                        columnHeader.Text = objectText;
                        columnHeader.Width = 120; // arbitrary
                        Logger.Trace(message: "" + objectName + ": " + objectText);
                    }
                }
                else
                {
                    objectName = cItem.Name;
                    objectText = HelperDataLanguageTZ.DataReadDTObjectText(
                        objectType: HelperDataLanguageTZ.GetControlType(
                            controlType: cItem.GetType()),
                        objectName: cItem.Name
                    );
                    cItem.Text = objectText;
                    Logger.Trace(message: "" + objectName + ": " + objectText);
                }
            }
        }

        // Text for ImagePreview
        pbx_imagePreview.EmptyText = HelperDataLanguageTZ.DataReadDTObjectText(
            objectType: ControlType.PictureBox,
            objectName: "pbx_imagePreviewEmptyText"
        );

        // don't think the menustrip above is working
        List<ToolStripItem> allMenuItems = new();
        foreach (ToolStripItem toolItem in mns_MenuStrip.Items)
        {
            allMenuItems.Add(item: toolItem);
            Logger.Trace(message: "Menu: " + toolItem.Name);
            //add sub items - not logging this.
            allMenuItems.AddRange(collection: helperNonstatic.GetMenuItems(item: toolItem));
        }

        foreach (ToolStripItem toolItem in cms_FileListView.Items)
        {
            allMenuItems.Add(item: toolItem);
            //add sub items
            allMenuItems.AddRange(collection: helperNonstatic.GetMenuItems(item: toolItem));
        }

        foreach (ToolStripItem cItem in allMenuItems)
        {
            if (cItem is ToolStripMenuItem)
            {
                objectName = cItem.Name;
                objectText = HelperDataLanguageTZ.DataReadDTObjectText(
                    objectType: HelperDataLanguageTZ.GetControlType(
                        controlType: cItem.GetType()),
                    objectName: cItem.Name
                );
                cItem.Text = objectText;
                Logger.Trace(message: objectName + ": " + objectText);
            }
        }

        pbx_imagePreview.EmptyText = HelperDataLanguageTZ.DataReadDTObjectText(
            objectType: ControlType.PictureBox,
            objectName: "pbx_imagePreviewEmptyText"
        );

        Logger.Trace(message: "Setting Tooltips");
        List<(ToolTip, Control, string)> ttpLabelsList = new()
        {
            (ttp_loctToFile, btn_loctToFile, "ttp_loctToFile"),
            (ttp_loctToFileDestination, btn_loctToFileDestination, "ttp_loctToFileDestination"),
            (ttp_NavigateMapGo, btn_NavigateMapGo, "ttp_NavigateMapGo"),
            (ttp_SaveFavourite, btn_SaveFavourite, "ttp_SaveFavourite"),
            (ttp_LoadFavourite, btn_LoadFavourite, "ttp_LoadFavourite"),
            (ttp_ManageFavourites, btn_ManageFavourites, "ttp_ManageFavourites")
        };
        foreach ((ToolTip, Control, string) valueTuple in ttpLabelsList)
        {
            ToolTip ttp = valueTuple.Item1;
            ttp.SetToolTip(control: valueTuple.Item2,
                caption: HelperDataLanguageTZ.DataReadDTObjectText(
                    objectType: ControlType.ToolTip,
                    objectName: valueTuple.Item3
                ));
        }
    }

    internal static string GetUOMAbbreviated()
    {
        return HelperVariables.UOMAbbreviated = HelperDataLanguageTZ.DataReadDTObjectText(
            objectType: ControlType.Label,
            objectName: HelperVariables.UserSettingUseImperial
                ? "lbl_Feet_Abbr"
                : "lbl_Metres_Abbr"
        );
    }

    /// <summary>
    ///     Pulls the last lat/lng combo from Settings if available, otherwise points to NASA's HQ
    /// </summary>
    private void AppStartupGetLastLatLngFromSettings()
    {
        Logger.Debug(message: "Starting");

        try
        {
            nud_lat.Text = HelperDataApplicationSettings.DataReadSQLiteSettings(
                dataTable: HelperVariables.DtHelperDataApplicationSettings,
                settingTabPage: "generic",
                settingId: "lastLat"
            );
            if (nud_lat.Text != null)
            {
                nud_lat.Value = Convert.ToDecimal(value: nud_lat.Text, provider: CultureInfo.CurrentCulture);
            }

            nud_lng.Text = HelperDataApplicationSettings.DataReadSQLiteSettings(
                dataTable: HelperVariables.DtHelperDataApplicationSettings,
                settingTabPage: "generic",
                settingId: "lastLng"
            );
            if (nud_lng.Text != null)
            {
                nud_lng.Value = Convert.ToDecimal(value: nud_lng.Text, provider: CultureInfo.CurrentCulture);
            }
        }
        catch
        {
            // ignored
        }

        if (nud_lat.Text == "" || nud_lat.Text == "0")
        {
            // NASA HQ
            string defaultLat = "38.883056";
            string defaultLng = "-77.016389";
            nud_lat.Text = defaultLat;
            nud_lng.Text = defaultLng;

            nud_lat.Value = Convert.ToDecimal(value: defaultLat, provider: CultureInfo.InvariantCulture);
            nud_lng.Value = Convert.ToDecimal(value: defaultLng, provider: CultureInfo.InvariantCulture);
        }

        HelperVariables.HsMapMarkers.Clear();
        HelperVariables.HsMapMarkers.Add(item: (nud_lat.Text.Replace(oldChar: ',', newChar: '.'),
                                                nud_lng.Text.Replace(oldChar: ',', newChar: '.')));
        HelperVariables.LastLat = double.Parse(s: nud_lat.Text.Replace(oldChar: ',', newChar: '.'),
            provider: CultureInfo.InvariantCulture);
        HelperVariables.LastLng = double.Parse(s: nud_lng.Text.Replace(oldChar: ',', newChar: '.'),
            provider: CultureInfo.InvariantCulture);
    }


    /// <summary>
    ///     Sets the application theme at startup based on the user's settings.
    /// </summary>
    /// <remarks>
    ///     If the user has chosen to use dark mode, the method sets the theme color to dark and applies a custom renderer to
    ///     the menu strip.
    ///     If the user has not chosen to use dark mode, the method sets the theme color to light and uses the default
    ///     rendering for the controls.
    /// </remarks>
    private Task AppStartupSetAppTheme()
    {
        // the custom logic is ugly af so no need to be pushy about it in light mode.
        if (!HelperVariables.UserSettingUseDarkMode)
        {
            tcr_Main.DrawMode = TabDrawMode.Normal;
            lvw_FileList.OwnerDraw = false;
            lvw_ExifData.OwnerDraw = false;
        }
        else
        {
            mns_MenuStrip.Renderer = new DarkMenuStripRenderer();
        }

        // adds colour/theme

        HelperControlThemeManager.SetThemeColour(
            themeColour: HelperVariables.UserSettingUseDarkMode
                ? ThemeColour.Dark
                : ThemeColour.Light, parentControl: this);

        return Task.CompletedTask;
    }

    /// <summary>
    ///     Reads the data in SQLite for panel widths/heights/sizes and applies them if available.
    /// </summary>
    [SuppressMessage(category: "ReSharper", checkId: "InconsistentNaming")]
    private void AppStartupApplyVisualStyleDefaults()
    {
        Logger.Debug(message: "Starting");
        // there should be a better way of doing this. 
        // reflections could do it and i asked GPT on the how-part but it only gave options for storing and retrieving _all_ the controls and _all_ their details, which isn't something i'd like.

        Dictionary<string, int> settingsApplicationDesignValuesDict = new()
        {
            { "splitContainerMainSplitterDistance", 0 },
            { "splitContainerLeftTopSplitterDistance", 0 }
        };

        // need to make it into a list else the foreach complains that the collection has been modfied.
        List<string> settingsApplicationDesignValuesKeysList = settingsApplicationDesignValuesDict.Keys.ToList();

        foreach (string settingsApplicationDesignValue
                 in settingsApplicationDesignValuesKeysList)
        {
            string dataInSQL =
                HelperDataApplicationSettings.DataReadSQLiteSettings(
                    dataTable: HelperVariables.DtHelperDataApplicationSettings,
                    settingTabPage: "generic",
                    settingId: settingsApplicationDesignValue, returnBlankIfNull: true);

            Logger.Debug(
                message:
                $"Reading settingsApplicationDesignValue {settingsApplicationDesignValue}, dataInSQL {dataInSQL}.");


            bool parsedDataInSQLSuccessfully = int.TryParse(s: dataInSQL,
                style: NumberStyles.Any,
                provider: CultureInfo.InvariantCulture,
                result: out int parsedSQLValueInt);

            if (!string.IsNullOrWhiteSpace(value: dataInSQL) && parsedDataInSQLSuccessfully)
            {
                settingsApplicationDesignValuesDict[key: settingsApplicationDesignValue] = parsedSQLValueInt;
            }
        }

        foreach (KeyValuePair<string, int> settingsApplicationDesignValue in settingsApplicationDesignValuesDict)
        {
            checkAssignSingleValues(dictValueKey: settingsApplicationDesignValue.Key);
        }

        void checkAssignSingleValues(string dictValueKey)
        {
            int valToAssign = settingsApplicationDesignValuesDict[key: dictValueKey];
            Logger.Debug(
                message:
                $"Assinging value {valToAssign} to {dictValueKey}.");
            if (valToAssign > 0)
            {
                switch (dictValueKey)
                {
                    case "splitContainerMainSplitterDistance":
                        splitContainerMain.SplitterDistance = valToAssign;
                        break;
                    case "splitContainerLeftTopSplitterDistance":
                        splitContainerLeftTop.SplitterDistance = valToAssign;
                        break;
                }
            }
        }

        string TrimEnd(string source, string value)
        {
            return !source.EndsWith(value: value)
                ? source
                : source.Remove(startIndex: source.LastIndexOf(value: value));
        }

        Logger.Debug(message: "Done");
    }

    private void splitContainerControl_Paint(object sender, PaintEventArgs e)
    {
        // https://stackoverflow.com/a/16006968
        splitContainerMain.Paint -= splitContainerControl_Paint;
        // Handle restoration here
        AppStartupApplyVisualStyleDefaults();
    }
}