Displays a Windows Save File dialog and returns the selected file path.
Takes title (String), defaultPath (String), and window (Int).
Returns full path as string.
BGI GUI
Parameters & Returns
Parameters
titleString
defaultPathString
windowInt
Returns
String
Quick Summary
Displays a Windows Save File dialog and returns the selected file path.
Takes title (String), defaultPath (String), and window (Int).
Returns full path as string.
Technical Exegesis...
Displays a Windows Save File dialog and returns the selected file path. Searches gizmoMap for window ID to get parent HWND. Creates OPENFILENAME structure with title, defaultPath (initial directory), szFile buffer (260 chars), flags OFN_PATHMUSTEXIST | OFN_FILEMUSTEXIST. Calls GetSaveFileName() to show dialog. If user enters filename and clicks Save, returns full path as string. Returns empty string if user cancels or window not found.
This function shows the standard Windows file picker for saving files.
Displays a Windows Save File dialog and returns the selected file path. Searches gizmoMap for window ID to get parent HWND. Creates OPENFILENAME structure with title, defaultPath (initial directory), szFile buffer (260 chars), flags OFN_PATHMUSTEXIST | OFN_FILEMUSTEXIST. Calls GetSaveFileName() to show dialog. If user enters filename and clicks Save, returns full path as string. Returns empty string if user cancels or window not found.
This function shows the standard Windows file picker for saving files. The defaultPath parameter sets the initial directory shown. No file filter is applied (lpstrFilter=NULL). Dialog allows user to type new filename or overwrite existing. Flags ensure path exists and file exists (may need adjustment for new files - typically save dialogs use OFN_OVERWRITEPROMPT instead). Dialog is modal - blocks until user saves or cancels. Use for letting users specify save locations for export, save, or write operations.