github.com/AlpineAIO/wails/v2@v2.0.0-beta.32.0.20240505041856-1047a8fa5fef/internal/go-common-file-dialog/README.md (about)

     1  # Common File Dialog bindings for Golang
     2  
     3  [Project Home](https://github.com/harry1453/go-common-file-dialog)
     4  
     5  This library contains bindings for Windows Vista and
     6  newer's [Common File Dialogs](https://docs.microsoft.com/en-us/windows/win32/shell/common-file-dialog), which is the
     7  standard system dialog for selecting files or folders to open or save.
     8  
     9  The Common File Dialogs have to be accessed via
    10  the [COM Interface](https://en.wikipedia.org/wiki/Component_Object_Model), normally via C++ or via bindings (like in C#)
    11  .
    12  
    13  This library contains bindings for Golang. **It does not require CGO**, and contains empty stubs for non-windows
    14  platforms (so is safe to compile and run on platforms other than windows, but will just return errors at runtime).
    15  
    16  This can be very useful if you want to quickly get a file selector in your Golang application. The `cfdutil` package
    17  contains utility functions with a single call to open and configure a dialog, and then get the result from it. Examples
    18  for this are in [`_examples/usingutil`](_examples/usingutil). Or, if you want finer control over the dialog's operation,
    19  you can use the base package. Examples for this are in [`_examples/notusingutil`](_examples/notusingutil).
    20  
    21  This library is available under the MIT license.
    22  
    23  Currently supported features:
    24  
    25  * Open File Dialog (to open a single file)
    26  * Open Multiple Files Dialog (to open multiple files)
    27  * Open Folder Dialog
    28  * Save File Dialog
    29  * Dialog "roles" to allow Windows to remember different "last locations" for different types of dialog
    30  * Set dialog Title, Default Folder and Initial Folder
    31  * Set dialog File Filters