nsis-plugin-nsresize/README.md

nsResize NSIS Plugin

Personal modified version

---

Original Description

Author: Stuart 'Afrow UK' Welch Company: Afrow Soft Ltd Date: 13th April 2013 Version: 1.0.0.0

A small NSIS plug-in for moving or resizing windows/controls.

See Examples\nsResize*.

Macros

nsResize.nsh includes macros used by the LargeWindow example script.

Functions

nsResize::SetRTL

nsResize::SetRTL $(^RTL)

Sets right-to-left mode on or off. This is only needed when using the nsResize::Set function.

nsResize::Set

nsResize::Set control_HWND x y width height

Sets a control's new X and Y coordinates and a new width and height. You may use the same unit values as nsDialogs. An empty string for x or y will ensure the control is not moved. An empty string for width or height will ensure the control is not resized.

nsResize::Add

nsResize::Add control_HWND x y width height

Adds the given X, Y, width and height values. You may use the same unit values as nsDialogs. Note that special treatment must be done for right-to-left languages.

nsResize::Top

nsResize::Top control_HWND

Moves a control to the top of the Z-order.

nsResize::GetPos

nsResize::GetPos control_HWND
Pop $X
Pop $Y

Gets the control position in dialog units relative to its parent window.

nsResize::GetPosPx

nsResize::GetPosPx control_HWND
Pop $X
Pop $Y

Gets the control position in pixels relative to its parent window.

nsResize::GetSize

nsResize::GetSize control_HWND
Pop $Width
Pop $Height

Gets the control size in dialog units.

nsResize::GetSizePx

nsResize::GetSizePx control_HWND
Pop $Width
Pop $Height

Gets the control size in pixels.

License

This plug-in is provided 'as-is', without any express or implied warranty. In no event will the author be held liable for any damages arising from the use of this plug-in.

Permission is granted to anyone to use this plug-in for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:

1. The origin of this plug-in must not be misrepresented; you must not claim that you wrote the original plug-in. If you use this plug-in in a product, an acknowledgment in the product documentation would be appreciated but is not required.
2. Altered versions must be plainly marked as such, and must not be misrepresented as being the original plug-in.
3. This notice may not be removed or altered from any distribution.

---

⚠️ Differences in the Personal Version

This version includes the following changes from the original distribution:

New supported architecture: x64 (amd64-unicode)

The original supported only:

• x86-ansi
• x86-unicode

The personal version adds support for:

• amd64-unicode (x64)

Visual Studio Project

The original included:

• Contrib/nsResize/nsResize.sln - VS2012 Solution
• Contrib/nsResize/nsResize.vcxproj - VS2012 Project (x86 only)

The personal version updates to VS2022 with x64 support:

• Src/nsResize.sln - VS2022 Solution
• Src/nsResize.vcxproj - VS2022 Project (x86-ansi, x86-unicode, amd64-unicode)

Changed Folder Structure

Source files have been moved from Contrib/nsResize/ to Src/ for a cleaner structure.

Added Files

• build_plugin.py - Python script to compile the plugin for all architectures
• Src/api.h - NSIS API header
• Src/pluginapi.c / Src/pluginapi.h - NSIS plugin API
• Src/nsis_tchar.h - Header for TCHAR support
• Src/nsis_unicode/pluginapi_x64.lib - Plugin API library for x64
• Src/build_pluginapi_x64.cmd / Src/build_pluginapi_x86.cmd - Scripts to compile plugin API
• Examples/nsResize/*.exe - Compiled examples

Build

python build_plugin.py                  # Build all architectures
python build_plugin.py --config x86-unicode      # Single architecture (x86-ansi|x86-unicode|amd64-unicode|all)
python build_plugin.py --toolset 2026            # Specific toolset (2022|2026|auto)
python build_plugin.py --jobs 4                  # Number of parallel MSBuild jobs (default: CPU count)
python build_plugin.py --clean                   # Clean dist/ before build
python build_plugin.py --install-dir "C:\NSIS\Plugins"  # Copy to additional NSIS directory
python build_plugin.py --verbose                 # Extended MSBuild output
python build_plugin.py --version                 # Print version and exit

DLLs are copied to dist/{platform}/nsResize.dll.

Removed Files

Pre-compiled DLL files have been removed from the distribution:

• Plugins/nsResize.dll
• Unicode/Plugins/nsResize.dll

DLLs are generated by the build and copied to plugins/{platform}/.

---

See README_IT.md for the Italian version.