ezEngine  Release 25.03
ezToolsProject Class Reference

Public Member Functions

ezStringBuilder GetPathForDocumentGuid (const ezUuid &guid)
 Resolve document GUID into an absolute path.
 
const ezStringGetProjectFile () const
 Returns the path to the 'ezProject' file.
 
const ezString GetProjectName (bool bSanitize) const
 Returns the short name of the project (extracted from the path). More...
 
ezString GetProjectDirectory () const
 Returns the path in which the 'ezProject' file is stored.
 
ezString GetProjectDataFolder () const
 Returns the directory path in which project settings etc. should be stored.
 
bool IsDocumentInAllowedRoot (ezStringView sDocumentPath, ezString *out_pRelativePath=nullptr) const
 
void AddAllowedDocumentRoot (ezStringView sPath)
 
void CreateSubFolder (ezStringView sFolder) const
 Makes sure the given sub-folder exists inside the project directory.
 

Static Public Member Functions

static bool IsProjectOpen ()
 
static bool IsProjectClosing ()
 
static void CloseProject ()
 
static void SaveProjectState ()
 
static bool CanCloseProject ()
 Returns true when the project can be closed. Uses ezToolsProjectRequest::Type::CanCloseProject event.
 
static bool CanCloseDocuments (ezArrayPtr< ezDocument * > documents)
 Returns true when the given list of documents can be closed. Uses ezToolsProjectRequest::Type::CanCloseDocuments event.
 
static ezInt32 SuggestContainerWindow (ezDocument *pDoc)
 Returns the unique ID of the container window this document should use for its window. Uses ezToolsProjectRequest::Type::SuggestContainerWindow event.
 
static ezStatus OpenProject (ezStringView sProjectPath)
 
static ezStatus CreateProject (ezStringView sProjectPath)
 
static void BroadcastSaveAll ()
 Broadcasts the SaveAll event, though otherwise has no direct effect.
 
static void BroadcastConfigChanged ()
 Sent when global project configuration data was changed and thus certain menus would need to update their content (or just deselect any item, forcing the user to reselect and thus update state)
 
static ezString FindProjectDirectoryForDocument (ezStringView sDocumentPath)
 Starts at the given document and then searches the tree upwards until it finds an ezProject file.
 

Static Public Attributes

static ezEvent< const ezToolsProjectEvent &, ezMutexs_Events
 
static ezEvent< ezToolsProjectRequest & > s_Requests
 

Member Function Documentation

◆ GetProjectName()

const ezString ezToolsProject::GetProjectName ( bool  bSanitize) const

Returns the short name of the project (extracted from the path).

Parameters
bSanitizeWhether to replace whitespace and other problematic characters, such that it can be used in code.

The documentation for this class was generated from the following files: