DocumentInfoData Struct Reference

#include <c4d_baselist.h>

Detailed Description

Message struct for the MSG_DOCUMENTINFO message.

Public Attributes
Int32	type
Int32	fileformat
BaseDocument *	doc
Filename	filename
BaseList2D *	bl
Bool	gui_allowed
void *	data
Bool	logUsage

Member Data Documentation

type

Int32 type

The message type: MSG_DOCUMENTINFO_TYPE.

fileformat

Int32 fileformat

The file format: (Set for load, merge and before/after save only. Otherwise NOTOK.) FORMAT_FILES.

doc

BaseDocument* doc

The current document. Cinema 4D owns the pointed document.

filename

Filename filename

The document filename. Note This is not always the same as the filename returned by BaseDocument::GetDocumentPath().
e.g. for MSG_DOCUMENTINFO_TYPE_SAVE_BEFORE BaseDocument::GetDocumentPath() still contains the old path whereas filename designates the real file.

bl

BaseList2D* bl

The object/tag/material that got inserted. It is used if type is of one of the following values:

• MSG_DOCUMENTINFO_TYPE_OBJECT_INSERT
• MSG_DOCUMENTINFO_TYPE_TAG_INSERT
• MSG_DOCUMENTINFO_TYPE_MATERIAL_INSERT

gui_allowed

Bool gui_allowed

It is set to true if a GUI (dialog) is allowed.

Note

NET for instance sets it to false, in which case no dialogs should be shown. For example if a Morph/XRef is not found it will inform the user, under NET this dialog should not display.

data

void* data

A pointer to message data structure. Depends on type.

logUsage

Bool logUsage

If set to true the import format of loaded files is logged into the analytics.

Since

2024.300