BrowseVolumes Class Reference

#include <c4d_file.h>

Detailed Description

Helper to browse through volumes.

Note
Has to be created with Alloc() and destroyed with Free(). Use AutoAlloc to automate the allocation and destruction based on scope.

Public Member Functions

void Init ()
 
Bool GetNext ()
 
Filename GetFilename ()
 
String GetVolumeName (Int32 *out_flags)
 

Private Member Functions

 BrowseVolumes ()
 
 ~BrowseVolumes ()
 

Alloc/Free

static BrowseVolumesAlloc ()
 
static void Free (BrowseVolumes *&bf)
 

Constructor & Destructor Documentation

◆ BrowseVolumes()

BrowseVolumes ( )
private

◆ ~BrowseVolumes()

~BrowseVolumes ( )
private

Member Function Documentation

◆ Alloc()

static BrowseVolumes* Alloc ( )
static

Allocates a volume browser. Destroy the allocated volume browser with Free(). Use AutoAlloc to automate the allocation and destruction based on scope.

Returns
The allocated volume browser, or nullptr if the allocation failed.

◆ Free()

static void Free ( BrowseVolumes *&  bf)
static

Destructs volume browsers allocated with Alloc(). Use AutoAlloc to automate the allocation and destruction based on scope.

Parameters
[in,out]bfThe volume browser to destruct. If the pointer is nullptr nothing happens. The pointer is assigned nullptr afterwards.

◆ Init()

void Init ( )

Initializes the class to browse volumes.

◆ GetNext()

Bool GetNext ( )

Gets the next volume.

Returns
true if another volume was found, otherwise false.

◆ GetFilename()

Filename GetFilename ( )

Gets the filename of the current volume, retrieved with GetNext().

Returns
The filename of the current volume.

◆ GetVolumeName()

String GetVolumeName ( Int32 out_flags)

Gets the current volume name.

Parameters
[out]out_flagsThe flags to check: BROWSEVOLUMES
Returns
The current volume name.