Open Search
    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.