Functions/GenXdev.Helpers/SecondScreen.ps1

#####################################################################
<#
.SYNOPSIS
Sets default second-monitor configuration.
 
.DESCRIPTION
Sets the default behavior for GenXdev window openings to be on the secondary monitor.
This is useful for users with a single monitor or those who prefer side-by-side window layouts.
See also cmdlet 'sidebyside' and 'restoredefaultmonitor'
 
.EXAMPLE
PS> secondscreen
 
Sets defaults for GenXdev window openings to be on the secondary monitor
 
#>

function secondscreen {

    [CmdletBinding()]
    [System.Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidGlobalVars", "")]

    param()

    begin {

        Microsoft.PowerShell.Utility\Write-Verbose `
            'Initializing default secondary monitor configuration'
    }

    process {

        # establish monitor 0 as the system-wide secondary display designation
        $Global:OriginalDefaultSecondaryMonitor = $Global:LastOriginalDefaultSecondaryMonitor -ne "secondscreen" -and
            $Global:LastOriginalDefaultSecondaryMonitor -ne "sidebyside" ?
            $Global:DefaultSecondaryMonitor :
            $Global:OriginalDefaultSecondaryMonitor;

        $Global:LastOriginalDefaultSecondaryMonitor = "secondscreen"
        $Global:DefaultSecondaryMonitor = -2

        Microsoft.PowerShell.Utility\Write-Verbose `
            "Secondary monitor set to display index: ${Global:DefaultSecondaryMonitor}"
    }

    end {

        Microsoft.PowerShell.Utility\Write-Verbose `
            'Secondary monitor configuration completed successfully'
    }
}