add readme

Author: lsq

.github/workflows/build-release.yml

@@ -0,0 +1,102 @@
+name: Build and Release DLLs
+
+on:
+  # 手动触发或在创建新 tag 时自动发布
+  push:
+    branches:
+      - '**'
+    tags:
+      - '**'
+  workflow_dispatch:
+
+jobs:
+  build-windows:
+    name: Build on ${{ matrix.config.name }}
+    runs-on: windows-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        config:
+          - name: MSVC x86
+            arch: x86
+            compiler: msvc
+            artifact-name: getselected-x86.dll
+          - name: MSVC x64
+            arch: x64
+            compiler: msvc
+            artifact-name: getselected-x64.dll
+          - name: MSYS2 UCRT64
+            arch: ucrt64
+            compiler: msys2
+            artifact-name: getselected-ucrt64.dll
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup MSVC (for MSVC builds)
+        if: matrix.config.compiler == 'msvc'
+        uses: ilammy/msvc-dev-cmd@v1
+        with:
+          arch: ${{ matrix.config.arch }}
+
+      - name: Setup MSYS2 (for MSYS2 builds)
+        if: matrix.config.compiler == 'msys2'
+        uses: msys2/setup-msys2@v2
+        with:
+          msystem: UCRT64
+          install: git mingw-w64-${{ matrix.config.arch }}-toolchain base-devel binutils
+
+      - name: Build with MSVC
+        if: matrix.config.compiler == 'msvc'
+        run: cd src && .\build.bat
+        shell: cmd
+
+      - name: Build with MSYS2
+        if: matrix.config.compiler == 'msys2'
+        run: |
+          cd src
+          ming32-make
+        shell: msys2 {0}
+
+      - name: Locate and rename DLL
+        id: find-dll
+        run: |
+          $dll = Get-ChildItem -Path . -Recurse -Include "*.dll" | Select-Object -First 1
+          if (-not $dll) {
+            Write-Error "No DLL found after build!"
+            exit 1
+          }
+          Copy-Item $dll.FullName -Destination "${{ matrix.config.artifact-name }}"
+          echo "dll_path=${{ matrix.config.artifact-name }}" >> $env:GITHUB_OUTPUT
+        shell: pwsh
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.config.artifact-name }}
+          path: ${{ steps.find-dll.outputs.dll_path }}
+
+  release:
+    name: Create Release
+    needs: build-windows
+    runs-on: ubuntu-latest
+    if: github.ref_type == 'tag' && startsWith(github.ref_name, 'v')
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: release-assets
+
+      - name: Flatten directory structure
+        run: |
+          mkdir -p release
+          find release-assets -type f -name "*.dll" -exec mv {} release/ \;
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: release/*.dll
+          prerelease: false
+          draft: false
+          fail_on_unmatched_files: true

readme.md

@@ -0,0 +1,29 @@
+## Overview
+
+This project is a Windows DLL library that enables multithreadd file and folder selection dialogs with support for unlimited file selections.
+
+The library solves the limitations of the standard Windows `GetOpenFileNameW` or `IFileOpenDialog ` API, which restricts simultaneous multi-selection of both files and folders(click Ok not close and return when selection mixed with folder) and multi-select results to a fixed-size buffer (lpstrFile).
+
+## Usage
+
+### How to use
+1. Import `src/GetSelected.c` and `GetSelected.h` to your project.
+2. Decalre points to store your selected path.
+
+see example `src/test_multithread-static.c`.
+
+### Example
+
+#### Use Windows `cl.exe`
+
+```bat
+cd src
+.\build.bat
+```
+
+#### Use MINGW `make`
+
+```sh
+cd src
+make
+```