Dock-PS.psm1

<#
.Synopsis
    Move the host into a docking position or undock the host.

.Description
    Depending on "Position" parameter, the host will either
    become a docked window (Application Desktop Toolbar) or
    be restored to a usual window.

    "dock" is an alias of this cmdlet.

    Notice: You MUST use "exit" command to quit the host if
    the host is docked, otherwise the docking position will
    not be reclaimed by the system immediately after the
    termination of the process.

.Parameter Position
    Default parameter, default value is "Right".

    Possible values are "Left", "Right", "Top", "Bottom" and
    "Center".

    If the value is "Center", the host will be undocked.
    Otherwise, the host is docked into "Position" of the
    primary screen.

.Example
    Move-Host Left

    If the host is not docked, this docks the host to the
    left of the screen. If the host is already docked, it
    is moved to the left of the screen if not already there.

.Example
    dock Center

    If the host is docked, this undocks the host. Otherwise,
    it does nothing.

    It is also possible to use "Pop-Host" cmdlet to undock
    the host.

#>

Function Move-Host
{
    [Alias('dock')]
    [CmdletBinding(HelpUri = 'https://github.com/GeeLaw/PowerShellThingies/tree/master/modules/Dock-PS')]
    Param
    (
        [ValidateSet('Left', 'Right', 'Top', 'Bottom', 'Center')]
        [string]$Position = 'Right'
    )
    Process
    {
        $Position = $Position.ToLower();
        If ($Position -eq 'center')
        {
            Pop-Host;
            Return;
        }
        [DockPSHelper.AppBarHelper]::AddAppBarWindow([System.Diagnostics.Process]::GetCurrentProcess().MainWindowHandle, $Position);
        [DockPSHelper.AppBarHelper]::MoveAppBarWindow([System.Diagnostics.Process]::GetCurrentProcess().MainWindowHandle, $Position);
    }
}

<#
.Synopsis
    Undock the host.

.Description
    If the host is docked, this undocks the host. Otherwise,
    it does nothing. Equivalent to "Move-Host -Position Center".

    "undock" is an alias of this cmdlet.

.Example
    Pop-Host

    If the host is docked, this undocks the host. Otherwise,
    it does nothing.

    It is also possible to use "Move-Host" cmdlet with Position
    being "Center" to undock the host.

#>

Function Pop-Host
{
    [Alias('undock')]
    [CmdletBinding(HelpUri = 'https://github.com/GeeLaw/PowerShellThingies/tree/master/modules/Dock-PS')]
    Param()
    Process
    {
        [DockPSHelper.AppBarHelper]::RemoveAppBarWindow([System.Diagnostics.Process]::GetCurrentProcess().MainWindowHandle);
    }
}

<#
.Synopsis
    Resize the docked host.

.Description
    If the host is docked, this resizes the dock. The size
    is in the percentage of the primary screen size.

    "resize" is an alias of this cmdlet.

    The input value(s) might be adjusted by the docking manager
    so that the window has reasonable size. However, if the
    input value(s) is/are 0, the corresponding size will not be
    modified.

.Parameter Both
    The percentage of either height or width, whichever applies
    to the docking position.

    Notice: The value is multiplied by 100.

.Parameter Height
    The height. This can be set while the host is in all four
    docking positions, but only exhibits immediate effect if
    the host is docked to the top/bottom of the screen.

.Parameter Width
    The width. This can be set while the host is in all four
    docking positions, but only exhibits immediate effect if
    the host is docked to the left/right of the screen.

.Example
    Resize-Host 30

    If the host is docked, this sets the height/width of the
    "free edge" of the host to 30% of the primary screen.
    Otherwise, it does nothing.

.Example
    Resize-Host -Height 30

    If the host is docked, this sets the height of of the
    host to 30% of the primary screen height, which is in
    effect when the host is docked top the top/bottom of
    the screen. Otherwise, it does nothing.

#>

Function Resize-Host
{
    [Alias('resize')]
    [CmdletBinding(HelpUri = 'https://github.com/GeeLaw/PowerShellThingies/tree/master/modules/Dock-PS', DefaultParameterSetName = 'Both', PositionalBinding = $false)]
    Param
    (
        [Parameter(Mandatory = $true, ParameterSetName = 'Both', Position = 0)]
        [ValidateRange(0, 100)]
        [int]$Both,
        [Parameter(ParameterSetName = 'Separate', Position = 0)]
        [ValidateRange(0, 100)]
        [int]$Width = 0,
        [Parameter(ParameterSetName = 'Separate', Position = 1)]
        [ValidateRange(0, 100)]
        [int]$Height = 0
    )
    Process
    {
        If ($PSCmdlet.ParameterSetName -eq 'Both')
        {
            [DockPSHelper.AppBarHelper]::ResizeAppBarWindow([System.Diagnostics.Process]::GetCurrentProcess().MainWindowHandle, $Both / 100.0, $Both / 100.0);
        }
        Else
        {
            [DockPSHelper.AppBarHelper]::ResizeAppBarWindow([System.Diagnostics.Process]::GetCurrentProcess().MainWindowHandle, $Width / 100.0, $Height / 100.0);
        }
    }
}

Export-ModuleMember -Function @('Move-Host', 'Pop-Host', 'Resize-Host') -Alias @('dock', 'undock', 'resize') -Cmdlet @() -Variable @();