Dialog

https://github.com/sqweek/dialog
Admin
A simple, cross-platform API for Go-lang that provides message boxes, file selection, and directory...
Tokens:20,541
Snippets:275
Trust Score:7.8
License:ISC
Update:2 months ago
Show doc for...
Tokens:
Raw
### Configure File Dialog

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/configuration.md

Example of setting up a file dialog with a title, start directory, default filename, and filters.

```go
fb := dialog.File()
fb = fb.Title("Select Files")
fb = fb.SetStartDir("/home/user/Documents")
fb = fb.SetStartFile("default.txt")
fb = fb.Filter("Text Files", "txt", "md")
fb = fb.Filter("All Files", "*")
// Launch with:
// fb.Load()
// fb.Save()
```

--------------------------------

### Configure and open a directory dialog

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/types.md

Example of using the builder pattern to set a title and starting directory before opening the dialog.

```go
directory, err := dialog.Directory().
    Title("Select Output Folder").
    SetStartDir("/home/user/Documents").
    Browse()
```

--------------------------------

### Directory Selection with Initial Path

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/usage-examples.md

Configures the starting directory for the browser dialog using SetStartDir.

```go
package main

import (
    "fmt"
    "os"
    "github.com/sqweek/dialog"
)

func main() {
    homeDir, _ := os.UserHomeDir()

    directory, err := dialog.Directory().
        Title("Select Images Folder").
        SetStartDir(homeDir + "/Pictures").
        Browse()

    if err != nil {
        fmt.Printf("Error: %v\n", err)
        return
    }

    fmt.Printf("Selected directory: %s\n", directory)
}
```

--------------------------------

### Set Start Directory with User Home

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/configuration.md

Use os.UserHomeDir to resolve the home directory before setting the start path.

```go
import "os"

homeDir, _ := os.UserHomeDir()
dialog.File().
    SetStartDir(homeDir).
    Load()
```

--------------------------------

### Set Initial Directory

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/api-reference.md

Defines the starting directory path when the dialog opens.

```go
dialog.File().SetStartDir("/home/user/Documents").Load()
```

--------------------------------

### Install Dependencies

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/platform-details.md

Commands to install necessary development libraries on various platforms.

```bash
# Debian/Ubuntu
sudo apt-get install libgtk-3-dev

# RHEL/CentOS
sudo yum install gtk3-devel

# macOS
brew install gtk+3
```

--------------------------------

### Implement Image Selection Workflow in Go

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/usage-examples.md

Illustrates setting a default starting directory and applying multiple specific file type filters for image selection.

```go
package main

import (
    "fmt"
    "os"
    "github.com/sqweek/dialog"
)

func selectImages() ([]string, error) {
    homeDir, _ := os.UserHomeDir()

    filename, err := dialog.File().
        Title("Select Image").
        SetStartDir(homeDir + "/Pictures").
        Filter("Images", "jpg", "jpeg", "png", "gif", "bmp").
        Filter("JPEG Images", "jpg", "jpeg").
        Filter("PNG Images", "png").
        Filter("All Files", "*").
        Load()

    if err == dialog.ErrCancelled {
        return nil, dialog.ErrCancelled
    } else if err != nil {
        return nil, err
    }

    return []string{filename}, nil
}

func main() {
    images, err := selectImages()
    if err == dialog.ErrCancelled {
        println("User cancelled")
        return
    } else if err != nil {
        fmt.Printf("Error: %v\n", err)
        return
    }

    for _, img := range images {
        fmt.Printf("Selected: %s\n", img)
    }
}
```

--------------------------------

### Configure Directory Dialog

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/configuration.md

Demonstrates setting a title and starting directory for a directory selection dialog.

```go
db := dialog.Directory()
db = db.Title("Select Output Directory")
db = db.SetStartDir("/home/user")
// Launch with:
// db.Browse()
```

--------------------------------

### Construct a file dialog with FileBuilder

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/types.md

Example of chaining configuration methods to open a file selection dialog.

```go
filename, err := dialog.File().
    Title("Open Audio File").
    Filter("MP3 Files", "mp3").
    Filter("OGG Files", "ogg").
    Filter("All Files", "*").
    SetStartDir("/home/user/Music").
    Load()
```

--------------------------------

### Open a File Dialog with Initial Directory

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/usage-examples.md

Sets a starting directory for the file picker and applies specific file filters.

```go
package main

import (
    "fmt"
    "os"
    "github.com/sqweek/dialog"
)

func main() {
    homeDir, _ := os.UserHomeDir()

    filename, err := dialog.File().
        Title("Open Document").
        SetStartDir(homeDir + "/Documents").
        Filter("Text Files", "txt", "md").
        Filter("All Files", "*").
        Load()

    if err != nil {
        fmt.Printf("Error: %v\n", err)
        return
    }

    fmt.Printf("Selected: %s\n", filename)
}
```

--------------------------------

### Complete Dialog Configuration in Go

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/configuration.md

Demonstrates initializing a file dialog with custom filters, starting directories, and handling user cancellation or errors.

```go
package main

import (
    "fmt"
    "log"
    "os"

    "github.com/sqweek/dialog"
)

func main() {
    // 1. Get user's home directory
    homeDir, err := os.UserHomeDir()
    if err != nil {
        log.Fatal(err)
    }

    // 2. Show message with formatted text
    if !dialog.Message("Do you want to open a file?").
        Title("File Manager").
        YesNo() {
        return
    }

    // 3. Open file with full configuration
    filename, err := dialog.File().
        Title("Select an Audio File").
        SetStartDir(homeDir).
        SetStartFile("song.mp3").
        Filter("Audio Files", "mp3", "ogg", "flac", "wav").
        Filter("All Files", "*").
        Load()

    if err == dialog.ErrCancelled {
        fmt.Println("User cancelled")
        return
    } else if err != nil {
        fmt.Printf("Error: %v\n", err)
        return
    }

    fmt.Printf("Selected: %s\n", filename)

    // 4. Browse directory
    directory, err := dialog.Directory().
        Title("Select Output Directory").
        SetStartDir(homeDir).
        Browse()

    if err == dialog.ErrCancelled {
        fmt.Println("User cancelled directory selection")
    } else if err != nil {
        fmt.Printf("Error: %v\n", err)
    } else {
        fmt.Printf("Selected directory: %s\n", directory)
    }
}
```

--------------------------------

### Message Formatting Examples

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/configuration.md

Demonstrates creating dialogs with formatted strings using standard Go verbs.

```go
dialog.Message("Hello %s", name).Title("Greeting").Info()
dialog.Message("Count: %d", count).Title("Statistics").Info()
dialog.Message("File: %s (size: %d bytes)", file, size).Title("Info").Info()
```

--------------------------------

### Set Absolute Start Directory

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/configuration.md

Absolute paths are used as-is on all platforms.

```go
dialog.File().SetStartDir("/home/user/Documents").Load()
// On all platforms, uses the absolute path as-is
```

--------------------------------

### Configure and display message dialogs

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/types.md

Examples of using the MsgBuilder to chain configuration methods and display dialogs.

```go
dialog.Message("Are you sure?").Title("Confirm").YesNo()
dialog.Message("Status: %s", status).Title("Update").Info()
```

--------------------------------

### List project source files

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/MANIFEST.md

Displays the file structure of the project including platform-specific implementations and examples.

```text
dlgs.go                 Public API definitions
dlgs_windows.go         Windows implementation  
dlgs_linux.go           Linux GTK implementation
dlgs_darwin.go          macOS implementation
cocoa/dlg_darwin.go     Cocoa bindings
cocoa/dlg.h             Cocoa C header
cocoa/dlg.m             Cocoa Objective-C (reference)
util.go                 Utility functions
example/*/main.go       Example programs
```

--------------------------------

### Set Relative Start Directory

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/configuration.md

Relative paths are resolved against the current working directory.

```go
dialog.File().SetStartDir("./files").Load()
// Relative to the current working directory
```

--------------------------------

### macOS Build Configuration

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/configuration.md

Requires Xcode command line tools to be installed before building.

```bash
# Xcode command line tools required
xcode-select --install

# Build
go build
```

--------------------------------

### dialog.File

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/README.md

Creates a file dialog builder for loading or saving files, supporting filters and starting directories.

```APIDOC
## dialog.File() *FileBuilder

### Description
Initializes a file dialog builder for file selection operations.

### Methods
- **Title(string) *FileBuilder**: Sets the dialog window title.
- **Filter(desc string, extensions ...string) *FileBuilder**: Adds a file extension filter.
- **SetStartDir(string) *FileBuilder**: Sets the initial directory.
- **SetStartFile(string) *FileBuilder**: Sets the initial filename.
- **Load() (string, error)**: Opens a file selection dialog to load a file.
- **Save() (string, error)**: Opens a file selection dialog to save a file.
```

--------------------------------

### Handle Windows-specific dialog errors

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/types.md

Example of type-asserting a Windows error to access extended error information.

```go
filename, err := dialog.File().Load()
if err != nil {
    if winErr, ok := err.(WinDlgError); ok {
        log.Printf("Windows error: %v\n", winErr)
    } else if err == dialog.ErrCancelled {
        log.Println("User cancelled")
    }
}
```

--------------------------------

### Implement File Selection Workflow in Go

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/usage-examples.md

Demonstrates a multi-step process involving user confirmation, file selection with filters, and displaying file metadata.

```go
package main

import (
    "fmt"
    "os"
    "path/filepath"
    "github.com/sqweek/dialog"
)

func main() {
    // Step 1: Confirm intention
    if !dialog.Message("Do you want to open a file?").
        Title("File Manager").
        YesNo() {
        println("Cancelled by user")
        return
    }

    // Step 2: Select file
    filename, err := dialog.File().
        Title("Select a File").
        Filter("All Files", "*").
        Load()
    if err != nil {
        fmt.Printf("Error selecting file: %v\n", err)
        return
    }

    // Step 3: Get file info
    fileInfo, _ := os.Stat(filename)
    dialog.Message("File: %s\nSize: %d bytes", 
        filepath.Base(filename), 
        fileInfo.Size()).
        Title("File Info").
        Info()

    // Step 4: Confirm action
    if dialog.Message("Open this file?").
        Title("Confirm").
        YesNo() {
        fmt.Printf("Opening: %s\n", filename)
    }
}
```

--------------------------------

### Build the project

Source: https://github.com/sqweek/dialog/blob/master/README.md

Standard commands to download dependencies and compile the project.

```bash
go mod download
go build
```

--------------------------------

### Windows Build Configuration

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/configuration.md

Standard Go build process utilizing the w32 package.

```bash
# Standard Go build with w32 package
go build
```

--------------------------------

### Initialize Directory Builder

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/api-reference.md

Creates a new directory selection builder instance.

```go
db := dialog.Directory()
db.Title("Select a folder").Browse()
```

--------------------------------

### File Selection and I/O in Go

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/usage-examples.md

Demonstrates opening a file dialog with a filter and reading the selected file's content.

```go
package main

import (
    "fmt"
    "io/ioutil"
    "github.com/sqweek/dialog"
)

func main() {
    // Select file
    filename, err := dialog.File().
        Title("Open Text File").
        Filter("Text", "txt").
        Load()
    if err != nil {
        fmt.Printf("Error: %v\n", err)
        return
    }

    // Read file
    content, err := ioutil.ReadFile(filename)
    if err != nil {
        dialog.Message("Cannot read file: %v", err).Title("Error").Error()
        return
    }

    dialog.Message("Read %d bytes", len(content)).Title("Success").Info()
}
```

--------------------------------

### Basic Dialog Usage in Go

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/README.md

Demonstrates implementing yes/no confirmations, file loading, and directory browsing using the builder API.

```go
package main

import "github.com/sqweek/dialog"

func main() {
    // Simple yes/no dialog
    if dialog.Message("Continue?").Title("Confirm").YesNo() {
        // User clicked Yes
    }

    // File selection
    filename, err := dialog.File().
        Title("Open File").
        Filter("Text Files", "txt").
        Load()
    
    // Directory selection
    directory, err := dialog.Directory().
        Title("Select Folder").
        Browse()
}
```

--------------------------------

### Initialize FileBuilder

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/api-reference.md

Creates a new instance of the file selection dialog builder.

```go
fb := dialog.File()
fb.Title("Open File").Filter("Text", "txt").Load()
```

--------------------------------

### Configure Dialogs Step-by-Step

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/usage-examples.md

Assign configuration methods to a builder variable incrementally before calling Load.

```go
package main

import "github.com/sqweek/dialog"

func main() {
    // Step-by-step configuration
    fileBuilder := dialog.File()
    fileBuilder = fileBuilder.Title("Select Audio")
    fileBuilder = fileBuilder.SetStartDir("/home/user/Music")
    fileBuilder = fileBuilder.Filter("MP3", "mp3")
    fileBuilder = fileBuilder.Filter("OGG", "ogg")

    filename, err := fileBuilder.Load()
    if err != nil {
        println("Error:", err)
    }
}
```

--------------------------------

### Implement File and Directory Dialogs in Go

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/platform-details.md

Go wrappers for file selection and directory selection dialogs.

```go
func FileDlg(save bool, title string, exts []string, relaxExt bool, startDir string, filename string) (string, error) {
    mode := C.LOADDLG
    if save {
        mode = C.SAVEDLG
    }
    return fileDlg(mode, title, exts, relaxExt, startDir, filename)
}

func DirDlg(title string, startDir string) (string, error) {
    return fileDlg(C.DIRDLG, title, nil, false, startDir, "")
}
```

--------------------------------

### Initialize GTK Environment

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/platform-details.md

Initializes GTK threads and checks for availability at package startup.

```go
func init() {
    C.XInitThreads()
    initSuccess = (C.gtk_init_check(nil, nil) == C.TRUE)
}
```

--------------------------------

### (b *FileBuilder) SetStartDir(startDir string)

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/api-reference.md

Specifies the initial directory to display when the dialog opens.

```APIDOC
## func (b *FileBuilder) SetStartDir(startDir string) *FileBuilder

### Description
Specifies the initial directory to display when the dialog opens.

### Parameters
- **startDir** (string) - Required - Absolute or relative path to the initial directory

### Returns
- `*FileBuilder`: The builder itself for method chaining.
```

--------------------------------

### Configure Message Dialog

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/configuration.md

Demonstrates initializing a message dialog and setting a custom title.

```go
msg := dialog.Message("Your message here")
msg = msg.Title("Custom Title")
// Launch with:
// msg.YesNo()
// msg.Info()
// msg.Error()
```

--------------------------------

### Implement Export Workflow in Go

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/usage-examples.md

Shows how to prompt for a save location with multiple file format filters and handle cancellation errors.

```go
package main

import (
    "fmt"
    "github.com/sqweek/dialog"
)

func main() {
    // Step 1: Choose export format
    if !dialog.Message("Export data?").
        Title("Export").
        YesNo() {
        return
    }

    // Step 2: Select save location
    filename, err := dialog.File().
        Title("Save As").
        SetStartFile("export.json").
        Filter("JSON Files", "json").
        Filter("CSV Files", "csv").
        Filter("XML Files", "xml").
        Save()

    if err == dialog.ErrCancelled {
        println("Export cancelled")
        return
    } else if err != nil {
        dialog.Message("Error: %v", err).Title("Error").Error()
        return
    }

    // Step 3: Confirm operation
    dialog.Message("Data will be saved to:\n%s", filename).
        Title("Confirm").
        Info()

    fmt.Printf("Exporting to: %s\n", filename)
}
```

--------------------------------

### Verify platform-specific files

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/modules.md

Commands to list Go files included in the build for the current or specific target platforms.

```bash
# List platform-specific files
go list -f '{{.GoFiles}}' github.com/sqweek/dialog

# Check available files for a specific platform
GOOS=windows go list -f '{{.GoFiles}}' github.com/sqweek/dialog
GOOS=darwin go list -f '{{.GoFiles}}' github.com/sqweek/dialog
GOOS=linux go list -f '{{.GoFiles}}' github.com/sqweek/dialog
```

--------------------------------

### Browse for a directory

Source: https://github.com/sqweek/dialog/blob/master/README.md

Opens a directory selection dialog.

```go
directory, err := dialog.Directory().Title("Load images").Browse()
```

--------------------------------

### (b *FileBuilder) SetStartFile(startFile string)

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/api-reference.md

Specifies the initial filename to suggest in the dialog.

```APIDOC
## func (b *FileBuilder) SetStartFile(startFile string) *FileBuilder

### Description
Specifies the initial filename to suggest in the dialog.

### Parameters
- **startFile** (string) - Required - Initial filename to populate the dialog with

### Returns
- `*FileBuilder`: The builder itself for method chaining.
```

--------------------------------

### File Selection with Configuration in Go

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/usage-examples.md

Shows how to persist the last opened directory path within an application configuration struct.

```go
package main

import (
    "github.com/sqweek/dialog"
)

type AppConfig struct {
    LastOpenPath string
}

func selectFile(config *AppConfig) error {
    filename, err := dialog.File().
        Title("Open File").
        SetStartDir(config.LastOpenPath).
        Load()

    if err != nil {
        return err
    }

    // Update config with last used path
    config.LastOpenPath = filename

    return nil
}
```

--------------------------------

### Handle Windows Paths

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/usage-examples.md

Demonstrates support for both forward slashes and backslashes, as well as UNC paths on Windows.

```go
package main

import (
    "github.com/sqweek/dialog"
)

func main() {
    // Windows accepts both / and \
    filename, err := dialog.File().
        SetStartDir("C:/Users/Username/Documents").
        Load()

    // UNC paths are supported
    unc, err := dialog.File().
        SetStartDir("\\\\server\\share\\folder").
        Load()
}
```

--------------------------------

### Method Chaining with MsgBuilder

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/types.md

Demonstrates the fluent interface pattern where builder methods return the receiver to allow sequential configuration.

```go
dialog.
    Message("Continue?").
    Title("Confirm").
    YesNo()
```

--------------------------------

### Direct Dependencies

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/modules.md

Lists the required external Go package for Windows platform support.

```text
github.com/TheTitanrain/w32
  └─ (Windows only, for W32 API access)
```

--------------------------------

### Implement Directory Dialog Wrapper

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/platform-details.md

Specific Go implementation for triggering a directory selection dialog.

```go
func DirDlg(title string, startDir string) (string, error) {
    return fileDlg(C.DIRDLG, title, nil, false, startDir, "")
}
```

--------------------------------

### Initialize Message Builder

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/api-reference.md

Creates a new message dialog builder using a Printf-style format string.

```go
dialog.Message("Do you want to continue?").Title("Confirm").YesNo()
dialog.Message("User ID: %d", userID).Title("Info").Info()
```

--------------------------------

### Directory()

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/api-reference.md

Initializes a new directory selection builder.

```APIDOC
## func Directory() *DirectoryBuilder

### Description
Initializes a new directory selection builder with default settings.

### Returns
- ***DirectoryBuilder**: A configured directory builder instance.
```

--------------------------------

### Construct Portable Paths

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/usage-examples.md

Use standard library functions like os.UserHomeDir and filepath.Join to ensure path compatibility across operating systems.

```go
package main

import (
    "fmt"
    "os"
    "path/filepath"
    "github.com/sqweek/dialog"
)

func main() {
    // Use os.UserHomeDir() for portable home directory
    homeDir, err := os.UserHomeDir()
    if err != nil {
        fmt.Printf("Error: %v\n", err)
        return
    }

    // Use filepath.Join() for portable path construction
    docsDir := filepath.Join(homeDir, "Documents")

    filename, err := dialog.File().
        SetStartDir(docsDir).
        Load()

    if err != nil {
        fmt.Printf("Error: %v\n", err)
    }
}
```

--------------------------------

### Set Initial Filename

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/api-reference.md

Suggests a default filename for the dialog.

```go
dialog.File().SetStartFile("document.txt").Title("Save As").Save()
```

--------------------------------

### Linux Mitigation Strategies

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/errors.md

Suggested approaches for handling missing X11 environments in Linux applications.

```go
// For applications that need to handle missing X11 gracefully:
// - Run in a separate goroutine and recover from panic
// - Check for X11 before initializing dialogs
// - Run tests in environments with X11 forwarding
// - Use -headless flags for CI/CD environments
```

--------------------------------

### Configure FileFilter via builder

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/types.md

Demonstrates how filters are added to a dialog using the builder pattern.

```go
// Internally created by:
dialog.File().
    Filter("Audio Files", "mp3", "ogg", "wav").
    Filter("Video Files", "mp4", "mkv").
    Filter("All Files", "*")
```

--------------------------------

### Open a File Selection Dialog

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/usage-examples.md

Prompts the user to select a file. Handles cancellation and errors explicitly.

```go
package main

import (
    "fmt"
    "github.com/sqweek/dialog"
)

func main() {
    filename, err := dialog.File().
        Title("Open File").
        Load()

    if err == dialog.ErrCancelled {
        println("User cancelled")
        return
    } else if err != nil {
        fmt.Printf("Error: %v\n", err)
        return
    }

    fmt.Printf("Selected: %s\n", filename)
}
```

--------------------------------

### Handle Directory Dialog Callbacks

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/platform-details.md

Callback function to initialize the directory dialog and set the initial selection.

```go
func callbackDefaultDir(hwnd w32.HWND, msg uint, lParam, lpData uintptr) int {
    if msg == bffm_INITIALIZED {
        _ = w32.SendMessage(hwnd, bffm_SETSELECTION, w32.TRUE, lpData)
    }
    return 0
}
```

--------------------------------

### Implement File Dialogs

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/platform-details.md

Methods for loading and saving files using GTK file chooser actions.

```go
func (b *FileBuilder) load() (string, error) {
    return chooseFile("Open File", "Open", C.GTK_FILE_CHOOSER_ACTION_OPEN, b)
}

func (b *FileBuilder) save() (string, error) {
    f, err := chooseFile("Save File", "Save", C.GTK_FILE_CHOOSER_ACTION_SAVE, b)
    if err != nil {
        return "", err
    }
    return f, nil
}
```

--------------------------------

### Implement Directory Dialogs

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/platform-details.md

Method for browsing directories using the folder selection action.

```go
func (b *DirectoryBuilder) browse() (string, error) {
    return chooseFile("Open Folder", "Open", C.GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER, &FileBuilder{Dlg: b.Dlg})
}
```

--------------------------------

### Configure Dialogs with Method Chaining

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/usage-examples.md

Use method chaining to configure and load a file dialog in a single expression.

```go
package main

import "github.com/sqweek/dialog"

func main() {
    // Chained configuration
    filename, err := dialog.File().
        Title("Select Document").
        SetStartDir("/home/user/Documents").
        Filter("PDFs", "pdf").
        Filter("All Files", "*").
        Load()

    if err != nil {
        println("Error:", err)
    }
}
```

--------------------------------

### Linux Build Configuration

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/configuration.md

Requires GTK-3 development headers and CGO enabled for building on Linux.

```bash
# Install required development packages
sudo apt-get install libgtk-3-dev  # Debian/Ubuntu
# or
sudo yum install gtk3-devel         # RHEL/CentOS

# Build
CGO_ENABLED=1 go build
```

--------------------------------

### CGO Build Configuration

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/platform-details.md

Required CGO flags for linking against GTK3 and X11.

```c
// #cgo pkg-config: gtk+-3.0
// #cgo LDFLAGS: -lX11
```

--------------------------------

### Dialog API Entry Points

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/README.md

Builder methods for creating message, file, and directory dialogs.

```go
// Message dialogs
dialog.Message(format string, args ...interface{}) *MsgBuilder
  → .Title(string) *MsgBuilder
  → .YesNo() bool
  → .Info()
  → .Error()

// File dialogs
dialog.File() *FileBuilder
  → .Title(string) *FileBuilder
  → .Filter(desc string, extensions ...string) *FileBuilder
  → .SetStartDir(string) *FileBuilder
  → .SetStartFile(string) *FileBuilder
  → .Load() (string, error)
  → .Save() (string, error)

// Directory dialogs
dialog.Directory() *DirectoryBuilder
  → .Title(string) *DirectoryBuilder
  → .SetStartDir(string) *DirectoryBuilder
  → .Browse() (string, error)
```

--------------------------------

### Load File Dialog

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/api-reference.md

Displays the dialog and handles the selection result or potential errors.

```go
filename, err := dialog.File().
    Title("Open File").
    Filter("Text Files", "txt").
    Filter("All Files", "*").
    Load()
if err == dialog.ErrCancelled {
    fmt.Println("User cancelled")
} else if err != nil {
    fmt.Println("Error:", err)
} else {
    fmt.Println("Selected:", filename)
}
```

--------------------------------

### Open a File Dialog with Multiple Categories

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/usage-examples.md

Demonstrates providing a wide range of file type filters for data export scenarios.

```go
package main

import (
    "fmt"
    "github.com/sqweek/dialog"
)

func main() {
    filename, err := dialog.File().
        Title("Export Data").
        Filter("Excel Spreadsheets", "xlsx", "xls").
        Filter("CSV Files", "csv").
        Filter("JSON Files", "json").
        Filter("XML Files", "xml").
        Filter("All Files", "*").
        Load()

    if err != nil {
        fmt.Printf("Error: %v\n", err)
        return
    }

    fmt.Printf("Export from: %s\n", filename)
}
```

--------------------------------

### DirectoryBuilder.SetStartDir()

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/api-reference.md

Sets the initial directory displayed when the dialog opens.

```APIDOC
## func (b *DirectoryBuilder) SetStartDir(dir string) *DirectoryBuilder

### Parameters
- **dir** (string) - Required - Absolute or relative path to the initial directory.

### Returns
- ***DirectoryBuilder**: The builder instance for method chaining.
```

--------------------------------

### dialog.File()

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/api-reference.md

Initializes a new file selection dialog builder.

```APIDOC
## func File() *FileBuilder

### Description
Initializes a new file selection dialog builder.

### Returns
- `*FileBuilder`: A file builder configured with default settings.
```

--------------------------------

### (b *FileBuilder) Load()

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/api-reference.md

Displays the file selection dialog.

```APIDOC
## func (b *FileBuilder) Load() (string, error)

### Description
Displays the file selection dialog, allowing the user to select a single file to open.

### Returns
- **string**: The absolute path of the selected file. Empty string if user cancels.
- **error**: ErrCancelled if the user cancels or closes the dialog without selecting a file.
```

--------------------------------

### Basic Directory Selection

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/usage-examples.md

Opens a standard directory selection dialog and handles user cancellation or errors.

```go
package main

import (
    "fmt"
    "github.com/sqweek/dialog"
)

func main() {
    directory, err := dialog.Directory().
        Title("Select Folder").
        Browse()

    if err == dialog.ErrCancelled {
        println("User cancelled")
        return
    } else if err != nil {
        fmt.Printf("Error: %v\n", err)
        return
    }

    fmt.Printf("Selected directory: %s\n", directory)
}
```

--------------------------------

### Configure File Dialog Filters

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/configuration.md

Shows how to add multiple file type filters to a file dialog using the Filter method.

```go
dialog.File().
    Filter("Audio Files", "mp3", "ogg", "wav").
    Filter("Video Files", "mp4", "mkv").
    Filter("All Files", "*")
```

--------------------------------

### Create a Formatted Message Dialog

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/usage-examples.md

Supports printf-style formatting for dynamic message content.

```go
package main

import (
    "fmt"
    "github.com/sqweek/dialog"
)

func main() {
    filename := "report.pdf"
    size := 2048576

    dialog.Message("File: %s\nSize: %d bytes", filename, size).
        Title("File Info").
        Info()
}
```

--------------------------------

### GolangCI Linting Configuration

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/configuration.md

Placeholder for the project's linting configuration file.

```yaml
# Project includes linting configuration
# See .golangci.yml in the repository
```

--------------------------------

### Implement File Dialogs with Win32 API

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/platform-details.md

Methods for loading and saving files using GetOpenFileName and GetSaveFileName.

```go
func (b *FileBuilder) load() (string, error) {
    d := openfile(w32.OFN_FILEMUSTEXIST|w32.OFN_NOCHANGEDIR, b)
    if w32.GetOpenFileName(d.opf) {
        return d.Filename(), nil
    }
    return "", err()
}

func (b *FileBuilder) save() (string, error) {
    d := openfile(w32.OFN_OVERWRITEPROMPT|w32.OFN_NOCHANGEDIR, b)
    if w32.GetSaveFileName(d.opf) {
        return d.Filename(), nil
    }
    return "", err()
}
```

--------------------------------

### Import package paths

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/modules.md

Standard import paths for the main dialog package and the internal cocoa subpackage.

```go
import "github.com/sqweek/dialog"
```

```go
import "github.com/sqweek/dialog/cocoa"
```

--------------------------------

### Implement Message Dialogs

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/platform-details.md

Methods for displaying question, information, and error dialogs using GTK message types.

```go
func (b *MsgBuilder) yesNo() bool {
    return runMsgDlg("Confirm?", 0, C.GTK_MESSAGE_QUESTION, C.GTK_BUTTONS_YES_NO, b) == C.GTK_RESPONSE_YES
}

func (b *MsgBuilder) info() {
    runMsgDlg("Information", 0, C.GTK_MESSAGE_INFO, C.GTK_BUTTONS_OK, b)
}

func (b *MsgBuilder) error() {
    runMsgDlg("Error", 0, C.GTK_MESSAGE_ERROR, C.GTK_BUTTONS_OK, b)
}
```

--------------------------------

### Comprehensive Error Handling

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/usage-examples.md

Demonstrates how to distinguish between user cancellation and platform-specific dialog errors.

```go
package main

import (
    "errors"
    "fmt"
    "github.com/sqweek/dialog"
)

func loadFile() error {
    filename, err := dialog.File().
        Title("Open File").
        Filter("Text Files", "txt").
        Load()

    if err != nil {
        if errors.Is(err, dialog.ErrCancelled) {
            return errors.New("user cancelled file selection")
        }

        // Windows-specific errors
        if winErr, ok := err.(dialog.WinDlgError); ok {
            return fmt.Errorf("windows dialog error: %v", winErr)
        }

        return fmt.Errorf("unexpected error: %w", err)
    }

    fmt.Printf("Loading file: %s\n", filename)
    return nil
}

func main() {
    if err := loadFile(); err != nil {
        fmt.Printf("Failed: %v\n", err)
    }
}
```

--------------------------------

### Display Information Dialog

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/api-reference.md

Shows an information icon dialog with an Ok button.

```go
dialog.Message("Operation completed successfully").Title("Success").Info()
```

--------------------------------

### Library Data Structures

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/README.md

Core structs used for dialog configuration and builder state.

```go
type Dlg struct {
    Title string
}

type MsgBuilder struct {
    Dlg
    Msg string
}

type FileFilter struct {
    Desc       string
    Extensions []string
}

type FileBuilder struct {
    Dlg
    StartDir  string
    StartFile string
    Filters   []FileFilter
}

type DirectoryBuilder struct {
    Dlg
    StartDir string
}
```

--------------------------------

### Create an Informational Message Dialog

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/usage-examples.md

Displays a standard informational message box with an OK button.

```go
package main

import "github.com/sqweek/dialog"

func main() {
    dialog.Message("Operation completed successfully").
        Title("Success").
        Info()
}
```

--------------------------------

### DirectoryBuilder.Browse()

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/api-reference.md

Displays the directory selection dialog and returns the selected path.

```APIDOC
## func (b *DirectoryBuilder) Browse() (string, error)

### Description
Displays the directory selection dialog, allowing the user to select a single folder.

### Returns
- **string**: The absolute path of the selected directory.
- **error**: ErrCancelled if the user cancels or closes the dialog.
```

--------------------------------

### dialog.Directory

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/README.md

Creates a directory selection dialog builder.

```APIDOC
## dialog.Directory() *DirectoryBuilder

### Description
Initializes a directory selection dialog builder.

### Methods
- **Title(string) *DirectoryBuilder**: Sets the dialog window title.
- **SetStartDir(string) *DirectoryBuilder**: Sets the initial directory.
- **Browse() (string, error)**: Opens a directory selection dialog and returns the selected path.
```

--------------------------------

### Implement Directory Browsing

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/platform-details.md

Function to browse for directories using SHBrowseForFolder.

```go
func (b *DirectoryBuilder) browse() (string, error) {
    d := selectdir(b)
    res := w32.SHBrowseForFolder(d.bi)
    if res == 0 {
        return "", ErrCancelled
    }
    return w32.SHGetPathFromIDList(res), nil
}
```

--------------------------------

### Implement Message Dialogs with Win32 API

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/platform-details.md

Functions for displaying Yes/No, Information, and Error message boxes using w32.MessageBox.

```go
func (b *MsgBuilder) yesNo() bool {
    r := w32.MessageBox(w32.HWND(0), b.Msg, firstOf(b.Dlg.Title, "Confirm?"), w32.MB_YESNO)
    return r == w32.IDYES
}

func (b *MsgBuilder) info() {
    w32.MessageBox(w32.HWND(0), b.Msg, firstOf(b.Dlg.Title, "Information"), w32.MB_OK|w32.MB_ICONINFORMATION)
}

func (b *MsgBuilder) error() {
    w32.MessageBox(w32.HWND(0), b.Msg, firstOf(b.Dlg.Title, "Error"), w32.MB_OK|w32.MB_ICONERROR)
}
```

--------------------------------

### Use firstOf utility function

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/modules.md

Selects the first non-empty string from the provided arguments, typically used for setting default values.

```go
title := firstOf(b.Dlg.Title, "Default Title")
```

--------------------------------

### Package Structure Overview

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/modules.md

The directory layout of the sqweek/dialog repository, showing the separation between the public API and platform-specific implementations.

```text
github.com/sqweek/dialog/
├── dlgs.go                  # Main public API
├── dlgs_windows.go          # Windows implementation
├── dlgs_linux.go            # Linux implementation (GTK)
├── dlgs_darwin.go           # macOS implementation
├── cocoa/
│   ├── dlg_darwin.go        # Cocoa bindings (internal)
│   ├── dlg.h                # Cocoa C header
│   └── dlg.m                # Cocoa Objective-C implementation
├── util.go                  # Utility functions
└── example/
    ├── simple/main.go       # Simple example
    └── wde/main.go          # WDE integration example
```

--------------------------------

### File Dialog Helper

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/platform-details.md

Internal helper function to configure and execute GTK file chooser dialogs.

```go
func chooseFile(title string, buttonText string, action C.GtkFileChooserAction, b *FileBuilder) (string, error) {
    // Create GTK file chooser dialog
    // Configure filters
    // Set initial directory and filename
    // Enable overwrite confirmation
    // Run and return result
}
```

--------------------------------

### File Selection with Retry Logic

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/usage-examples.md

Implements a retry loop that prompts the user to try again if a file selection is cancelled.

```go
package main

import (
    "fmt"
    "github.com/sqweek/dialog"
)

func selectFileWithRetry(maxAttempts int) (string, error) {
    for attempt := 1; attempt <= maxAttempts; attempt++ {
        filename, err := dialog.File().
            Title("Open File").
            Load()

        if err == dialog.ErrCancelled {
            if attempt < maxAttempts {
                if !dialog.Message("Try again?").
                    Title("File Selection").
                    YesNo() {
                    return "", dialog.ErrCancelled
                }
                continue
            }
            return "", dialog.ErrCancelled
        }

        if err != nil {
            return "", fmt.Errorf("error on attempt %d: %w", attempt, err)
        }

        return filename, nil
    }

    return "", fmt.Errorf("max attempts (%d) exceeded", maxAttempts)
}

func main() {
    filename, err := selectFileWithRetry(3)
    if err != nil {
        fmt.Printf("Failed: %v\n", err)
    } else {
        fmt.Printf("Selected: %s\n", filename)
    }
}
```

--------------------------------

### Load a file via dialog

Source: https://github.com/sqweek/dialog/blob/master/README.md

Opens a file selection dialog filtered for specific file types. Returns the absolute path or an error if cancelled.

```go
filename, err := dialog.File().Filter("Mp3 audio file", "mp3").Load()
```

--------------------------------

### Linux GTK Initialization Panic Check

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/errors.md

The checkStatus function triggers a panic if GTK fails to initialize, typically due to a missing X server.

```go
func checkStatus() {
    if !initSuccess {
        panic("gtk initialisation failed; presumably no X server is available")
    }
}
```

--------------------------------

### Create Reusable Dialog Builders

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/usage-examples.md

Define functions that return a pre-configured dialog builder for reuse across the application.

```go
package main

import (
    "github.com/sqweek/dialog"
)

func makeAudioFileDialog() *dialog.FileBuilder {
    return dialog.File().
        Title("Select Audio File").
        Filter("Audio", "mp3", "ogg", "flac", "wav").
        Filter("All Files", "*")
}

func main() {
    audioDialog := makeAudioFileDialog()

    filename, err := audioDialog.Load()
    if err != nil {
        println("Error:", err)
    }
}
```

--------------------------------

### Implement Message Dialogs in Go

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/platform-details.md

Functions for displaying Yes/No, Info, and Error dialogs using Cocoa alert parameters.

```go
func YesNoDlg(msg, title string) bool {
    a := mkAlertParams(msg, title, C.MSG_YESNO)
    defer a.free()
    return a.run() == C.DLG_OK
}

func InfoDlg(msg, title string) {
    a := mkAlertParams(msg, title, C.MSG_INFO)
    defer a.free()
    a.run()
}

func ErrorDlg(msg, title string) {
    a := mkAlertParams(msg, title, C.MSG_ERROR)
    defer a.free()
    a.run()
}
```

--------------------------------

### Set Dialog Title

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/api-reference.md

Configures the window title text for the file dialog.

```go
dialog.File().Title("Select a music file").Filter("MP3", "mp3").Load()
```

--------------------------------

### Set Directory Dialog Title

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/api-reference.md

Configures the window title for the directory selection dialog.

```go
dialog.Directory().Title("Select Output Directory").Browse()
```

--------------------------------

### Open a File Dialog with Type Filters

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/usage-examples.md

Restricts file selection to specific file extensions using multiple filter calls.

```go
package main

import (
    "fmt"
    "github.com/sqweek/dialog"
)

func main() {
    filename, err := dialog.File().
        Title("Select Audio File").
        Filter("MP3 Files", "mp3").
        Filter("OGG Files", "ogg").
        Filter("WAV Files", "wav").
        Filter("All Files", "*").
        Load()

    if err != nil {
        fmt.Printf("Error: %v\n", err)
        return
    }

    fmt.Printf("Selected audio file: %s\n", filename)
}
```

--------------------------------

### (b *MsgBuilder) Info

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/api-reference.md

Displays a message dialog with an information icon and an 'Ok' button.

```APIDOC
## func (b *MsgBuilder) Info()

### Description
Displays a message dialog with an information icon and an 'Ok' button.
```

--------------------------------

### Handle dialog cancellation

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/types.md

Demonstrates checking for cancellation using direct comparison or errors.Is.

```go
// Direct comparison
if err == dialog.ErrCancelled {
    log.Println("User cancelled")
}

// Using errors.Is (recommended for Go 1.13+)
if errors.Is(err, dialog.ErrCancelled) {
    log.Println("User cancelled")
}
```

--------------------------------

### dialog.Directory

Source: https://github.com/sqweek/dialog/blob/master/README.md

Displays a directory selection dialog.

```APIDOC
## dialog.Directory().Title(title string).Browse()

### Description
Asks the user to select a directory.

### Returns
- **directory** (string): The path of the selected directory.
- **err** (error): Returns an error if the operation fails or is cancelled.
```

--------------------------------

### Configure CGO Build Flags

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/platform-details.md

Required build flag to link the Cocoa framework on macOS.

```c
// #cgo darwin LDFLAGS: -framework Cocoa
```

--------------------------------

### dialog.File

Source: https://github.com/sqweek/dialog/blob/master/README.md

Displays a file selection dialog for loading or saving files.

```APIDOC
## dialog.File().Filter(description string, ext string).Title(title string).Load()

### Description
Opens a file selection dialog to select an existing file.

### Returns
- **filename** (string): The absolute path of the selected file.
- **err** (error): Returns dialog.Cancelled if the user cancels or closes the dialog.

## dialog.File().Filter(description string, ext string).Title(title string).Save()

### Description
Opens a file selection dialog to choose a filename for saving data. If the file exists, it prompts for overwrite confirmation.

### Returns
- **filename** (string): The path selected by the user.
- **err** (error): Returns dialog.Cancelled if the user cancels or closes the dialog.
```

--------------------------------

### Add File Filters

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/api-reference.md

Applies file type filters to the dialog. Multiple calls are cumulative.

```go
dialog.File().
    Filter("Audio Files", "mp3", "ogg", "wav").
    Filter("Video Files", "mp4", "mkv").
    Filter("All Files", "*").
    Load()
```

--------------------------------

### Save File Dialog

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/api-reference.md

Displays a file selection dialog in save mode. Returns the selected path or an error if cancelled.

```go
filename, err := dialog.File().
    Title("Export to XML").
    Filter("XML Files", "xml").
    Save()
if err != nil {
    fmt.Println("Error or cancelled:", err)
} else {
    fmt.Println("Will save to:", filename)
}
```

--------------------------------

### Define FileBuilder structure

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/types.md

Builder structure for constructing and configuring file selection dialogs.

```go
type FileBuilder struct {
    Dlg
    StartDir  string
    StartFile string
    Filters   []FileFilter
}
```

--------------------------------

### Define DirectoryBuilder structure

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/types.md

The base structure for configuring directory selection dialogs.

```go
type DirectoryBuilder struct {
    Dlg
    StartDir string
}
```

--------------------------------

### Architecture Diagram

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/modules.md

Visual representation of the public API, builder implementation, and platform-specific layers.

```text
┌─────────────────────────────────────────┐
│   Public API (dlgs.go)                  │
│  - Message(), File(), Directory()       │
│  - MsgBuilder, FileBuilder, etc.        │
└────────┬────────────────────────────────┘
         │
    ┌────┴────────────────────┐
    │                         │
┌───▼──────────┐  ┌──────────▼────┐
│ Builder impl │  │ Error handling │
│ methods      │  │ (ErrCancelled) │
└───┬──────────┘  └─────────────┬──┘
    │                           │
┌───┴──────────────────────────▼────┐
│  Platform Layer Selection          │
│  (Build tags: windows/darwin/linux)│
└─┬─────────────────────────┬────────┘
  │                         │
  ├─ dlgs_windows.go        │
  │   └─ Win32 API          │
  │                         │
  ├─ dlgs_darwin.go         │
  │   └─ cocoa/ subpackage
  │       └─ Objective-C
  │           └─ Cocoa
  │                         │
  └─ dlgs_linux.go          │
      └─ GTK3 (CGO)
```

--------------------------------

### Display file size distribution

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/MANIFEST.md

A text-based table showing the word count and percentage distribution of documentation files.

```text
overview.md           306 words  (2.5%) — Quick reference
types.md           1,167 words  (9.6%) — Type details
README.md          1,283 words (10.6%) — Master index
errors.md          1,337 words (11.0%) — Error reference
configuration.md   1,356 words (11.2%) — Configuration
usage-examples.md  1,370 words (11.3%) — Code examples
modules.md         1,648 words (13.6%) — Architecture
platform-details.md 1,763 words (14.6%) — Implementation
api-reference.md   1,879 words (15.5%) — Function reference
─────────────────────────────────────
TOTAL             12,109 words (100%)
```

--------------------------------

### Define File Dialog Structure

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/platform-details.md

Internal structure for managing file dialog state, including UTF-16 buffers and Win32 API structures.

```go
type filedlg struct {
    buf     []uint16           // UTF-16 encoded filename buffer
    filters []uint16           // UTF-16 encoded filter strings
    opf     *w32.OPENFILENAME  // Win32 API structure
}
```

--------------------------------

### Define Cocoa File Dialog Structures

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/platform-details.md

C constants and structures for configuring file and directory dialog panels.

```c
#define LOADDLG 0   // NSOpenPanel
#define SAVEDLG 1   // NSSavePanel
#define DIRDLG 2    // NSOpenPanel for directories

typedef struct {
    int mode;              // Dialog type (LOADDLG, SAVEDLG, DIRDLG)
    char* buf;             // Buffer for selected path
    int nbuf;              // Buffer size (PATH_MAX)
    char* title;           // Dialog title
    void** exts;           // NSString* array of allowed extensions
    int numext;            // Number of extensions
    int relaxext;          // Allow other file types
    char* startDir;        // Initial directory
    char* filename;        // Default filename
} FileDlgParams;
```

--------------------------------

### Migrating from Cancelled to ErrCancelled

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/errors.md

Shows the syntax change required to migrate from the deprecated Cancelled variable to the preferred ErrCancelled.

```go
// Old
if err == dialog.Cancelled {

// New
if err == dialog.ErrCancelled {
```

--------------------------------

### Message Constructor Signature

Source: https://github.com/sqweek/dialog/blob/master/_autodocs/configuration.md

Defines the function signature for creating a new message builder.

```go
func Message(format string, args ...interface{}) *MsgBuilder
```
Tokens:
Raw