ManagedServices::abstract Class Reference


Detailed Description

Exposes native MaxSDK utility functions to managed code.

Application preferences for spinners.

Exposes native Max Path SDK utility functions to managed code.

Exposes native Maxscript SDK utility functions to managed code.

A static class helper that provides managed access to certain codes declared in notify.h in the MaxSDK.

Managed wrapper base class intended for exposing a native Max controls to WPF.

<exclude>

This class exposes a set of static methods for resolving actions in 3ds Max.

Exposes 3ds Max color management properties.

For internal use only.

List of all members.

Public Types

enum   MaxCustomCursors { PAN_CURSOR, DRAG_OK_CURSOR, DRAG_NO_CURSOR }
 

The managed enum type for MaxCustomCusor.

More...
enum   AppFlavor { k3dsMax, k3dsMaxDesign, kUnknown }
 

The managed enum type for AppFlavor.

More...
enum   MaxActionContexts {
  MainUi = kActionMainUIContext, TrackView = kActionTrackViewContext, MaterialEditor = kActionMaterialEditorContext, VideoPost = kActionVideoPostContext,
  SchematicView = kActionSchematicViewContext, IReshade = kActionIReshadeContext
}
 

Enum of common contexts (Groups in the UI) that are exposed in the Max SDK.

More...
enum   ColorTheme { Dark = 0, Light = 1 }
enum   DirectoryID {
  Font = APP_FONT_DIR, Scene = APP_SCENE_DIR, Import = APP_IMPORT_DIR, Export = APP_EXPORT_DIR,
  Help = APP_HELP_DIR, Expression = APP_EXPRESSION_DIR, Preview = APP_PREVIEW_DIR, Image = APP_IMAGE_DIR,
  Sound = APP_SOUND_DIR, PlugInConfig = APP_PLUGCFG_DIR, MaxStart = APP_MAXSTART_DIR, VideoPost = kActionVideoPostContext,
  Drivers = APP_DRIVERS_DIR, Autoback = APP_AUTOBACK_DIR, MaterialLibrary = APP_MATLIB_DIR, Scripts = APP_SCRIPTS_DIR,
  StartupScripts = APP_STARTUPSCRIPTS_DIR, MarketDefaults = APP_MARKETDEFAULTS_DIR, RenderPresets = APP_RENDER_PRESETS_DIR, UI = APP_UI_DIR,
  MaxSystemRoot = APP_MAX_SYS_ROOT_DIR, RenderOutput = APP_RENDER_OUTPUT_DIR, Animation = APP_ANIMATION_DIR, Archives = APP_ARCHIVES_DIR,
  Photometric = APP_PHOTOMETRIC_DIR, RenderAssets = APP_RENDER_ASSETS_DIR, UserScripts = APP_USER_SCRIPTS_DIR, UserMacros = APP_USER_MACROS_DIR,
  UserStartupScripts = APP_USER_STARTUPSCRIPTS_DIR, Temp = APP_TEMP_DIR, UserIcons = APP_USER_ICONS_DIR, MaxData = APP_MAXDATA_DIR,
  ProjectFolder = APP_PROJECT_FOLDER_DIR, Download = APP_DOWNLOAD_DIR, Proxies = APP_PROXIES_DIR, ManagedAssemblies = APP_MANAGED_ASSEMBLIES_DIR
}
 

These directory IDs correspond to the IDs declared in maxapi.h of the SDK.

More...

Public Member Functions

  MaxNativeControl ()
void  DestroyControl ()

Static Public Member Functions

static bool  IsHolding ()
  Is the undo system currently actively registering actions?
static void  BeginHold ()
  Have the undo system start actively registering actions as one undo stack entry.
static void  AcceptHold (System::String^_name)
  Place an undo entry on the stack.
static void  DisableAccelerators ()
  Disable accelerators (keyboard shortcuts) in the main Max UI.
static void  EnableAccelerators ()
  Enabled accelerators (keyboard shortcuts) in the main Max UI.
static bool  AcceleratorsEnabled ()
  Are accelerators (keyboard shortcuts) enabled in the main Max UI?
static bool  IsSelectionLocked ()
  Is the scene selection currently locked, preventing the user from changing the current selection?
static bool  TranslateAndDispatchMessageToApplication (System::Windows::Forms::Message%message)
  Send a windows message to the main application.
static bool  TranslateAndDispatchMessageToApplication (CSharpUtilities::RoutedKeyEventArgs::KeyEvent aEvent, System::IntPtr lParam, System::IntPtr wParam)
  Send a windows message to the main application.
static bool  TranslateAndDispatchMessageToApplication (MSG &message)
  Send a windows message to the main application.
static System::IntPtr  GetMaxHWND ()
  Get the window handle for the main application window.
static System::IntPtr  GetPanCursorHandle ()
  Get the cursor handle for the pan cursor (hand cursor).
static System::Drawing::Icon  GetMainApplicationIcon ()
  Retrieves the current application icon.
static void  ConfigureWindowForMax (System::Windows::Window^aWindow)
  Decorates a WPF Window to make it behave like other Max windows, both modal and modeless.
static System::IntPtr  GetMaxCustomCursor (MaxCustomCursors curIdx)
  Get the cursor handle for the Max custom cursor.
static void  MakeExtendedViewportActive (System::IntPtr handle)
  Activate an extended viewport.
static void  PutUpViewMenu (System::IntPtr handle, int X, int Y)
  Pop up the "View Menu" of extended viewport.
static bool  IsExtendedViewport (System::IntPtr handle)
  Check whether the specified Explorer window is in extended viewport.
static bool  SetApplicationSettingInt (System::String^aSection, System::String^aKey, int value)
  Sets an integer value in the application config file.
static int  GetApplicationSettingInt (System::String^aSection, System::String^aKey, int defaultValue)
  Looks up an integer value in the application config file.
static bool  SetApplicationSettingString (System::String^aSection, System::String^aKey, System::String^value)
  Sets a string value in the application config file.
static System::String  GetApplicationSettingString (System::String^aSection, System::String^aKey, System::String^defaultValue)
  Looks up a string value in the application config file.
static AppFlavor  GetAppFlavor ()
  Get the app flavor of current application.
static bool  LaunchHsvColorDialogModal (IManagedHsvCallback^aManagedCallback, System::IntPtr aDialogParent, System::String^aDialogTitle, System::Windows::Media::Color anInitialColor, System::Windows::Point aStartPosition)
  Launches the standard Win32-based application modal color picker.
static System::Windows::Rect  GetMainWindowCurrentScreenPosition ()
  Gets current main window screen position and size.
static int  GetCurrentSubObjectLevel ()
  Get the current selected object's active sub-object selection level.
static void  SetCurrentSubObjectLevel (int level)
  Set the current selected object's active sub-object selection level.
static bool  IsQuietMode ()
  Checks to see if the application is in 'quiet-mode' (usually means running a command-line job or acting as a render slave.)
static bool  CheckForSave ()
  Checks if the scene is dirty and if necessary, prompts the user to save, continue without saving, or cancel the current operation.
static bool  IsSaveRequired ()
  Is the scene dirty?
static void  SetSaveRequired (bool required)
  Override the scene's dirty flag.
static bool  LoadFile (System::String^path)
  Load the specified Max scene file.
static MaxActionItem  ResolveMacroItem (System::String^aMacroName, System::String^aMacroCategory)
  Given an macroscript name and category, resolves and returns a MaxActionItem wrapper for the SDK unmanaged ActionItem object.
static MaxActionItem  ResolveNativeItem (System::UInt32 aActionID, System::UInt32 aTableID)
  Given an action id and an action table id, resolves and returns a MaxActionItem wrapper for the SDK unmanaged ActionItem object.
static MaxActionItem  ResolveNativeItem (System::String^aActionName, System::String^aCategoryName)
  Given an action name and category name, resolves and returns a MaxActionItem wrapper for the SDK unmanaged ActionItem object.
static array< System::String^>  GetContexts ()
  Returns an array of all available context names.
static unsigned int  GetContextId (System::String^aContextName)
  Given a context name, returns the associated context id.
static System::String  GetContextName (unsigned int contextId)
  Given a context id, returns the associated context name.
static System::String  GetContextName (MaxActionItemResolver::MaxActionContexts context)
  Given a context id, returns the associated context name.
static array< System::String^>  GenerateCategoryList (unsigned int contextId)
  Gets the list of valid categories given a context id.
static
System::Collections::Generic::List
< MaxActionItem^> 
GetActionList (unsigned int aContextId, System::String^aCategory)
  Gets the action list that corresponds to the passed context id and category string.
static System::String  GetAllCommandsCategoryName ()
  Gets the localized name of the 'All Commands' category (as seen in the customization UI).
static void  ExecuteMaxscriptCommand (System::String^aCommand)
  Executes the passed in argument as a Maxscript command.
static bool  ExecuteBooleanMaxscriptQuery (System::String^aCommand)
  Executes the passed in argument as a Maxscript query.
static System::String  ExecuteStringMaxscriptQuery (System::String^aCommand)
  Executes the passed in argument as a Maxscript query.
static int  ExecuteIntMaxscriptQuery (System::String^aCommand)
  Executes the passed in argument as a Maxscript query.
static float  ExecuteFloatMaxscriptQuery (System::String^aCommand)
  Executes the passed in argument as a Maxscript query.
static COLORREF  ExecuteColorMaxscriptQuery (System::String^aCommand)
  Executes the passed in argument as a Maxscript query.
static
System::Windows::Media::Color 
ConvertColorRefToColor (COLORREF^aColorRef)
  Converts a COLORREF value type to a Color struct.
static System::String  AssembleScript (System::String^aScriptFormat,...array< System::Object^>^aScriptParameters)
  Creates the normalized maxscript string that uses the invariant number format.
static void  CompileUsedMacroEntries ()
  Compile MacroEntries marked as used.
static void  DisableMacroEntryCompiles ()
  Disable MacroEntry compiles.
static void  EnableMacroEntryCompiles ()
  Enable MacroEntry compiles.
static System::String  GetDirectoryPath (DirectoryID aID)
  Retrieves the application path associated with the passed in directory ID.
static System::String  GetTooltipPath ()
  Retrieves the application path where dynamically loaded tooltip files are kept.
static System::String  GetRibbonConfigPath ()
  Retrieves the application path where the main application Ribbon is defined.
static System::String  GetWriteRibbonConfigPath ()
  Retrieves the application path where Ribbon info is written to.
static System::String  GetUiWritePath ()
  Retrieves the CUI write-safe location path.
static System::String  GetUiResourcesRoot ()
  Retrieves the root path for UI resources.
static System::String  GetUiThemePath ()
  Retrieves the current theme's resource path.
static bool  DoMaxOpenDialog (System::IntPtr parentWnd, System::String^title, System::String^%filename, System::String^%initialDir, FileDialogFilterList^filters)
  Opens a max-style Open dialog for generic file types.
static System::String  BrowseForMaxFile ()
  Open the File Open browse dialog for the Max scene file, returning the selected file path or null if the user canceled the dialog.
static bool  DoMaxSaveAsDialog (System::IntPtr parentWnd, System::String^title, System::String^%filename, System::String^%initialDir, FileDialogFilterList^filters)
  Opens a max-style File Save As dialog for generic file types.
static bool  IsSingleEditablePolyObjectSelected ()
  Is the current scene selection a single Editable Poly object?
static bool  IsSingleEditPolyModifierSelected ()
  Is the current scene selection a single EditPoly modifier?
static int  GetPrecision ()
  Get the number of decimal places to display in spinners.
static bool  IsGlobalScaleEnabled ()
  Is the application-wide spinner scale enabled?
static float  GetGlobalScale ()
  Get the current application-wide spinner scale.
static bool  IsNearWrapEnabled ()
  Should spinners in free-spin wrap the mouse close to the spinner?
static int  GetNearWrapDistance ()
  The distance from the spinner at which the mouse cursor should wrap during free spin when Near Wrap is enabled.

Static Public Attributes

static const int  SceneSelectionChanged = NOTIFY_SELECTIONSET_CHANGED
  <brief> Sent after the selection set has changed </brief>
static const int  SceneSelectionLocked = NOTIFY_SELECTION_LOCK
static const int  SceneSelectionUnlocked = NOTIFY_SELECTION_UNLOCK
static const int  ModifyPanelSelectionChanged = NOTIFY_MODPANEL_SEL_CHANGED
static const int  PostModifierAdded = NOTIFY_POST_MODIFIER_ADDED
static const int  PostModifierDeleted = NOTIFY_POST_MODIFIER_DELETED

Protected Member Functions

virtual void  CreateSpecificControl (HWND hostHwnd) override
virtual void  DestroySpecificControl () override

Static Protected Member Functions

static MaxNativeControl  GetValidMaxNativeControl (HWND hostHwnd)

Properties

IMaxValueCtrlWndMsg  MessageHandler

Member Enumeration Documentation

The managed enum type for MaxCustomCusor.

For internal use only.

Enumerator:
PAN_CURSOR 
DRAG_OK_CURSOR 
DRAG_NO_CURSOR 

The managed enum type for AppFlavor.

For internal use only.

Enumerator:
k3dsMax 
k3dsMaxDesign 
kUnknown 

Enum of common contexts (Groups in the UI) that are exposed in the Max SDK.

Enumerator:
MainUi 
TrackView 
MaterialEditor 
VideoPost 
SchematicView 
IReshade 
Enumerator:
Dark 
Light 

These directory IDs correspond to the IDs declared in maxapi.h of the SDK.

Each ID represents a system path used by Max.

Enumerator:
Font 
Scene 
Import 
Export 
Help 
Expression 
Preview 
Image 
Sound 
PlugInConfig 
MaxStart 
VideoPost 
Drivers 
Autoback 
MaterialLibrary 
Scripts 
StartupScripts 
MarketDefaults 
RenderPresets 
UI 
MaxSystemRoot 
RenderOutput 
Animation 
Archives 
Photometric 
RenderAssets 
UserScripts 
UserMacros 
UserStartupScripts 
Temp 
UserIcons 
MaxData 
ProjectFolder 
Download 
Proxies 
ManagedAssemblies 

Member Function Documentation

static bool ManagedServices::abstract::IsHolding ( ) [static]

Is the undo system currently actively registering actions?

Returns:
true if undo is currently active, false otherwise.
static void ManagedServices::abstract::BeginHold ( ) [static]

Have the undo system start actively registering actions as one undo stack entry.

static void ManagedServices::abstract::AcceptHold ( System::String^  _name ) [static]

Place an undo entry on the stack.

Parameters:
_name Entry name displayed in the undo menu.
static void ManagedServices::abstract::DisableAccelerators ( ) [static]

Disable accelerators (keyboard shortcuts) in the main Max UI.

static void ManagedServices::abstract::EnableAccelerators ( ) [static]

Enabled accelerators (keyboard shortcuts) in the main Max UI.

static bool ManagedServices::abstract::AcceleratorsEnabled ( ) [static]

Are accelerators (keyboard shortcuts) enabled in the main Max UI?

Returns:
true if accelerators are currently enabled, false otherwise.
static bool ManagedServices::abstract::IsSelectionLocked ( ) [static]

Is the scene selection currently locked, preventing the user from changing the current selection?

Returns:
true if the scene selection is locked, false otherwise.
static bool ManagedServices::abstract::TranslateAndDispatchMessageToApplication ( System::Windows::Forms::Message%  message ) [static]

Send a windows message to the main application.

Parameters:
message The message to be translated and sent, packaged as a Windows Forms Message.
Returns:
true if the message is handled by the application, false if not.
static bool ManagedServices::abstract::TranslateAndDispatchMessageToApplication ( CSharpUtilities::RoutedKeyEventArgs::KeyEvent  aEvent,
System::IntPtr  lParam,
System::IntPtr  wParam 
) [static]

Send a windows message to the main application.

This version translates a routed key event into a windows message. This is generally used for sending keyboard accelerators to the main UI.

Parameters:
aEvent RoutedKeyEventArgs containing details about the managed key event to be translated into a native windows message.
lParam lParam argument to send with the key event. See the native windows message documentation for more information on lParam and wParam.
wParam wParam argument to send with the key event.See the native windows message documentation for more information on lParam and wParam.
Returns:
true if the message is handled by the application, false if not.
static bool ManagedServices::abstract::TranslateAndDispatchMessageToApplication ( MSG &  message ) [static]

Send a windows message to the main application.

Parameters:
message The native windows message to send to the application.
Returns:
true if the message is handled by the application, false if not.
static System::IntPtr ManagedServices::abstract::GetMaxHWND ( ) [static]

Get the window handle for the main application window.

Returns:
The window handle for the main application window.
static System::IntPtr ManagedServices::abstract::GetPanCursorHandle ( ) [static]

Get the cursor handle for the pan cursor (hand cursor).

Returns:
The cursor handle for the pan cursor (hand cursor).
static System::Drawing::Icon ManagedServices::abstract::GetMainApplicationIcon ( ) [static]

Retrieves the current application icon.

This is the icon shown in the application title bar.

Returns:
An Icon object representing the application icon.
static void ManagedServices::abstract::ConfigureWindowForMax ( System::Windows::Window^  aWindow ) [static]

Decorates a WPF Window to make it behave like other Max windows, both modal and modeless.

Parameters:
aWindow A WPF Window to configure for use in Max
static System::IntPtr ManagedServices::abstract::GetMaxCustomCursor ( MaxCustomCursors  curIdx ) [static]

Get the cursor handle for the Max custom cursor.

For internal use only.

Parameters:
curIdx Refer to enum MaxCustomCursor.
Returns:
The cursor handle.
static void ManagedServices::abstract::MakeExtendedViewportActive ( System::IntPtr  handle ) [static]

Activate an extended viewport.

For internal use only.

Parameters:
handle HWND of the Explorer window which is registered as an extended viewport
static void ManagedServices::abstract::PutUpViewMenu ( System::IntPtr  handle,
int  X,
int  Y 
) [static]

Pop up the "View Menu" of extended viewport.

For internal use only.

Parameters:
handle HWND of the Explorer window which is registered as an extended viewport
X X position of the popup menu
Y Y position of the popup menu
static bool ManagedServices::abstract::IsExtendedViewport ( System::IntPtr  handle ) [static]

Check whether the specified Explorer window is in extended viewport.

For internal use only.

Parameters:
handle HWND of the Explorer window to be tested
Returns:
Whether the Explorer window is currently an extended viewport
static bool ManagedServices::abstract::SetApplicationSettingInt ( System::String^  aSection,
System::String^  aKey,
int  value 
) [static]

Sets an integer value in the application config file.

For internal use only.

Parameters:
aSection The sub-section in which the default value should be set
aKey The key in which the value should be set
value The value to set as a default
Returns:
true if the default was correctly set, false otherwise
static int ManagedServices::abstract::GetApplicationSettingInt ( System::String^  aSection,
System::String^  aKey,
int  defaultValue 
) [static]

Looks up an integer value in the application config file.

For internal use only.

Parameters:
aSection The sub-section in which to look for the default value
aKey The key in which the value exists
defaultValue A default value to return if the key / value pair is not found
Returns:
Returns the recorded default value, or the default specified in the function if no value is found
static bool ManagedServices::abstract::SetApplicationSettingString ( System::String^  aSection,
System::String^  aKey,
System::String^  value 
) [static]

Sets a string value in the application config file.

For internal use only.

Parameters:
aSection The sub-section in which the default value should be set
aKey The key in which the value should be set
value The value to set as a default
Returns:
true if the default was correctly set, false otherwise
static System::String ManagedServices::abstract::GetApplicationSettingString ( System::String^  aSection,
System::String^  aKey,
System::String^  defaultValue 
) [static]

Looks up a string value in the application config file.

For internal use only.

Parameters:
aSection The sub-section in which to look for the default value
aKey The key in which the value exists
defaultValue A default value to return if the key / value pair is not found
Returns:
Returns the recorded default value, or the default specified in the function if no value is found
static AppFlavor ManagedServices::abstract::GetAppFlavor ( ) [static]

Get the app flavor of current application.

For internal use only.

static bool ManagedServices::abstract::LaunchHsvColorDialogModal ( IManagedHsvCallback aManagedCallback,
System::IntPtr  aDialogParent,
System::String^  aDialogTitle,
System::Windows::Media::Color  anInitialColor,
System::Windows::Point  aStartPosition 
) [static]

Launches the standard Win32-based application modal color picker.

Parameters:
aManagedCallback A callback object that is informed of the main callback events supplied by this dialog.
aDialogParent The parent handle for this dialog. If null is passed, then the parent becomes the handle of the main application.
aDialogTitle The dialog title.
anInitialColor The starting point color of the dialog.
aStartPosition The starting location of the dialog, in screen coordinates. The location of the dialog can be tracked via the callback object.
Returns:
Returns true if the user clicks OK, or false if the user cancels the dialog
static System::Windows::Rect ManagedServices::abstract::GetMainWindowCurrentScreenPosition ( ) [static]

Gets current main window screen position and size.

static int ManagedServices::abstract::GetCurrentSubObjectLevel ( ) [static]

Get the current selected object's active sub-object selection level.

<return>The currently selected sub-object level.</return>

static void ManagedServices::abstract::SetCurrentSubObjectLevel ( int  level ) [static]

Set the current selected object's active sub-object selection level.

Parameters:
level The currently selected sub-object level.
static bool ManagedServices::abstract::IsQuietMode ( ) [static]

Checks to see if the application is in 'quiet-mode' (usually means running a command-line job or acting as a render slave.)

Returns:
true if in quiet mode
static bool ManagedServices::abstract::CheckForSave ( ) [static]

Checks if the scene is dirty and if necessary, prompts the user to save, continue without saving, or cancel the current operation.

Returns:
true if the user chose to save or continue without saving, false if the user chose to cancel.
static bool ManagedServices::abstract::IsSaveRequired ( ) [static]

Is the scene dirty?

Returns:
true if the scene is considered dirty and needs to be saved, false otherwise
static void ManagedServices::abstract::SetSaveRequired ( bool  required ) [static]

Override the scene's dirty flag.

Parameters:
required New value for the save required flag.
static bool ManagedServices::abstract::LoadFile ( System::String^  path ) [static]

Load the specified Max scene file.

Parameters:
path Path to the file to load
Returns:
true if the file was loaded, false otherwise.
static MaxActionItem ManagedServices::abstract::ResolveMacroItem ( System::String^  aMacroName,
System::String^  aMacroCategory 
) [static]

Given an macroscript name and category, resolves and returns a MaxActionItem wrapper for the SDK unmanaged ActionItem object.

Parameters:
aMacroName The localized name of the macroscript name.
aMacroCategory The localized name of the macroscript category that the desired action item belongs to.
Returns:
A resolved MaxActionItem managed wrapper object.
static MaxActionItem ManagedServices::abstract::ResolveNativeItem ( System::UInt32  aActionID,
System::UInt32  aTableID 
) [static]

Given an action id and an action table id, resolves and returns a MaxActionItem wrapper for the SDK unmanaged ActionItem object.

Parameters:
aActionID The action item id to lookup.
aTableID The action table id to find the action item in.
Returns:
A resolved MaxActionItem managed wrapper object.
static MaxActionItem ManagedServices::abstract::ResolveNativeItem ( System::String^  aActionName,
System::String^  aCategoryName 
) [static]

Given an action name and category name, resolves and returns a MaxActionItem wrapper for the SDK unmanaged ActionItem object.

Parameters:
aActionName The localized name of an action to resolve. This should correspond to the result of ActionItem::GetDescriptionText(TSTR);
aCategoryName The localized name of the action table that the desired action item belongs to.
Returns:
A resolved MaxActionItem managed wrapper object.
static array<System::String^> ManagedServices::abstract::GetContexts ( ) [static]

Returns an array of all available context names.

Returns:
All context names.
static unsigned int ManagedServices::abstract::GetContextId ( System::String^  aContextName ) [static]

Given a context name, returns the associated context id.

Parameters:
aContextName A context name.
Returns:
The corresponding context id. Note that this method throws an ArgumentException if no context has the name passed in.
static System::String ManagedServices::abstract::GetContextName ( unsigned int  contextId ) [static]

Given a context id, returns the associated context name.

Parameters:
contextId A context id.
Returns:
The corresponding context name, or nullptr if a matching context does not exist.
static System::String ManagedServices::abstract::GetContextName ( MaxActionItemResolver::MaxActionContexts  context ) [static]

Given a context id, returns the associated context name.

Parameters:
context A context id.
Returns:
The corresponding context name, or nullptr if a matching context does not exist.
static array<System::String^> ManagedServices::abstract::GenerateCategoryList ( unsigned int  contextId ) [static]

Gets the list of valid categories given a context id.

Parameters:
contextId A context Id to filter on.
Returns:
An array of Category names.
static System::Collections::Generic::List<MaxActionItem^> ManagedServices::abstract::GetActionList ( unsigned int  aContextId,
System::String^  aCategory 
) [static]

Gets the action list that corresponds to the passed context id and category string.

Parameters:
aContextId A context Id to filter on.
aCategory A category string to filter on.
Returns:
A List of actions.
static System::String ManagedServices::abstract::GetAllCommandsCategoryName ( ) [static]

Gets the localized name of the 'All Commands' category (as seen in the customization UI).

Returns:
The localized name of the 'All Commands' category.
ManagedServices::abstract::MaxNativeControl ( )

For internal use only.

void ManagedServices::abstract::DestroyControl ( )

For internal use only.For internal use only.

virtual void ManagedServices::abstract::CreateSpecificControl ( HWND  hostHwnd ) [protected, pure virtual]

For internal use only.

virtual void ManagedServices::abstract::DestroySpecificControl ( ) [protected, pure virtual]

For internal use only.

static MaxNativeControl ManagedServices::abstract::GetValidMaxNativeControl ( HWND  hostHwnd ) [static, protected]

For internal use only.For internal use only.

static void ManagedServices::abstract::ExecuteMaxscriptCommand ( System::String^  aCommand ) [static]

Executes the passed in argument as a Maxscript command.

Parameters:
aCommand A command to execute. The string will literally be passed to the Maxscript engine, and must follow all the established formating rules for Maxscript commands.
static bool ManagedServices::abstract::ExecuteBooleanMaxscriptQuery ( System::String^  aCommand ) [static]

Executes the passed in argument as a Maxscript query.

The boolean return value of the query is returned.

Parameters:
aCommand A command to execute. The string will literally be passed to the Maxscript engine, and must follow all the established formating rules for Maxscript commands.
Returns:
Returns the result of a boolean Maxscript query. If the query is not boolean in nature or the command fails, then the result is false.
static System::String ManagedServices::abstract::ExecuteStringMaxscriptQuery ( System::String^  aCommand ) [static]

Executes the passed in argument as a Maxscript query.

The String return value of the query is returned.

Parameters:
aCommand A command to execute. The string will literally be passed to the Maxscript engine, and must follow all the established formating rules for Maxscript commands.
Returns:
Returns the result of a Maxscript query as String. If the query result is not a string, then the result is null.
static int ManagedServices::abstract::ExecuteIntMaxscriptQuery ( System::String^  aCommand ) [static]

Executes the passed in argument as a Maxscript query.

The String return value of the query is returned.

Parameters:
aCommand A command to execute. The string will literally be passed to the Maxscript engine, and must follow all the established formating rules for Maxscript commands.
Returns:
Returns the result of a Maxscript query as Integer. If the query result is not a integer, then the result is -1.
static float ManagedServices::abstract::ExecuteFloatMaxscriptQuery ( System::String^  aCommand ) [static]

Executes the passed in argument as a Maxscript query.

The String return value of the query is returned.

Parameters:
aCommand A command to execute. The string will literally be passed to the Maxscript engine, and must follow all the established formating rules for Maxscript commands.
Returns:
Returns the result of a Maxscript query as float. If the query result is not a float, then the bool value is false.
static COLORREF ManagedServices::abstract::ExecuteColorMaxscriptQuery ( System::String^  aCommand ) [static]

Executes the passed in argument as a Maxscript query.

The String return value of the query is returned.

Parameters:
aCommand A command to execute. The string will literally be passed to the Maxscript engine, and must follow all the established formating rules for Maxscript commands.
Returns:
Returns the result of a Maxscript query as color(RGBA). If the query result is not a color(RGBA), then bool value is false.
static System::Windows::Media::Color ManagedServices::abstract::ConvertColorRefToColor ( COLORREF^  aColorRef ) [static]

Converts a COLORREF value type to a Color struct.

Parameters:
aColorRef The COLORREF GDI value to convert. Value can be null.
Returns:
The equivalent .NET Color struct, or null if the value passed is null.
static System::String ManagedServices::abstract::AssembleScript ( System::String^  aScriptFormat,
...array< System::Object^>^  aScriptParameters 
) [static]

Creates the normalized maxscript string that uses the invariant number format.

It is recommended that you use this function to assemble your string rather than String::Format().

Parameters:
aScriptFormat A string format string that follows the formatting rules, as specified in String::Format().
aScriptParameters The parameter list that would normally be fed to the String::Format() method, in the order specified by the format string.
Returns:
A formatted string that uses maxscript-approved invariant number formats.
static void ManagedServices::abstract::CompileUsedMacroEntries ( ) [static]

Compile MacroEntries marked as used.

A MacroEntry can be explicitly marked as used, or implicitly marked as used if an attempt is made to compile it while MacroEntry compiles are disabled. This method causes the MacroEntries marked as used to be batch compiled. The batch compile may be multithreaded, so this can be faster than compiling the MacroEntries individually.

static void ManagedServices::abstract::DisableMacroEntryCompiles ( ) [static]

Disable MacroEntry compiles.

A MacroEntry is implicitly marked as used if an attempt is made to compile it while MacroEntry compiles are disabled. Calls to this method must be paired with a call to EnableMacroEntryCompiles. The used MacroEntries are then batch compiled with a call to CompileUsedMacroEntries. Nested calls to DisableMacroEntryCompiles are allowed, with MacroEntry compiles disabled until the call to outermost EnableMacroEntryCompiles occurs.

static void ManagedServices::abstract::EnableMacroEntryCompiles ( ) [static]

Enable MacroEntry compiles.

A MacroEntry is implicitly marked as used if an attempt is made to compile it while MacroEntry compiles are disabled. Calls to DisableMacroEntryCompiles must be paired with a call to this method. The used MacroEntries are then batch compiled with a call to CompileUsedMacroEntries. Nested calls to DisableMacroEntryCompiles are allowed, with MacroEntry compiles disabled until the call to outermost EnableMacroEntryCompiles occurs.

static System::String ManagedServices::abstract::GetDirectoryPath ( DirectoryID  aID ) [static]

Retrieves the application path associated with the passed in directory ID.

Parameters:
aID The ID of the directory to lookup.
Returns:
The directory path that corresponds to the passed in ID.
static System::String ManagedServices::abstract::GetTooltipPath ( ) [static]

Retrieves the application path where dynamically loaded tooltip files are kept.

Returns:
The directory path that contains tooltip files that are dynamically loaded.
static System::String ManagedServices::abstract::GetRibbonConfigPath ( ) [static]

Retrieves the application path where the main application Ribbon is defined.

Returns:
The directory path that contains the XAML-based Ribbon definition files.
static System::String ManagedServices::abstract::GetWriteRibbonConfigPath ( ) [static]

Retrieves the application path where Ribbon info is written to.

Returns:
The directory path that contains the active XAML-based Ribbon definition files.
static System::String ManagedServices::abstract::GetUiWritePath ( ) [static]

Retrieves the CUI write-safe location path.

Returns:
The current CUI write-safe directory.
static System::String ManagedServices::abstract::GetUiResourcesRoot ( ) [static]

Retrieves the root path for UI resources.

Returns:
The root path for UI resources.
static System::String ManagedServices::abstract::GetUiThemePath ( ) [static]

Retrieves the current theme's resource path.

Returns:
The current theme's resource path.
static bool ManagedServices::abstract::DoMaxOpenDialog ( System::IntPtr  parentWnd,
System::String^  title,
System::String^%  filename,
System::String^%  initialDir,
FileDialogFilterList filters 
) [static]

Opens a max-style Open dialog for generic file types.

Parameters:
parentWnd The window handle which should be this dialog's parent window.
title The string to be set as the title of this dialog.
filename As an in parameter, can contain the long or short name of the file that should be default selection of the dialog. As an out parameter, filename contains the long name of the file selected by the user, if this function returns true.
initialDir As an in parameter, contains the initial dialog directory. If the user clicks OK, then this parameter contains the user selected directory path.
filters A list of extensions supported by this dialog.
Returns:
True if the user makes an acceptable choice, false if canceled.
static System::String ManagedServices::abstract::BrowseForMaxFile ( ) [static]

Open the File Open browse dialog for the Max scene file, returning the selected file path or null if the user canceled the dialog.

Unlike PathSDK.DoMaxOpenDialog, which allows a feature to maintain its own initial directory, and specify its own title and filters, PathSDK.BrowseForMaxFile uses the same initial directory, title and filters, as the File Open action item used for opening the scene file.

Returns:
If the user selects a file, returns the file path. If the user cancels the dialog, returns null.
static bool ManagedServices::abstract::DoMaxSaveAsDialog ( System::IntPtr  parentWnd,
System::String^  title,
System::String^%  filename,
System::String^%  initialDir,
FileDialogFilterList filters 
) [static]

Opens a max-style File Save As dialog for generic file types.

Parameters:
parentWnd The window handle which should be this dialog's parent window.
title The string to be set as the title of this dialog.
filename As an in parameter, can contain the long or short name of the file that should be default selection of the dialog. As an out parameter, filename contains the long name of the file selected by the user, if this function returns true.
initialDir As an in parameter, contains the initial dialog directory. If the user clicks OK, then this parameter contains the user selected directory path.
filters A list of extensions supported by this dialog.
Returns:
True if the user makes an acceptable choice, false if canceled.
static bool ManagedServices::abstract::IsSingleEditablePolyObjectSelected ( ) [static]

Is the current scene selection a single Editable Poly object?

For internal use only.

Returns:
true if a single Editable Poly object is selected, false otherwise
static bool ManagedServices::abstract::IsSingleEditPolyModifierSelected ( ) [static]

Is the current scene selection a single EditPoly modifier?

For internal use only.

Returns:
true if a single EditPoly modifier is selected, false otherwise
static int ManagedServices::abstract::GetPrecision ( ) [static]

Get the number of decimal places to display in spinners.

static bool ManagedServices::abstract::IsGlobalScaleEnabled ( ) [static]

Is the application-wide spinner scale enabled?

This setting is exposed in the UI as spinner "snap."

static float ManagedServices::abstract::GetGlobalScale ( ) [static]

Get the current application-wide spinner scale.

This scale is only used when clicking the spinner buttons.

This setting is exposed in the UI as the spinner "snap" value.

static bool ManagedServices::abstract::IsNearWrapEnabled ( ) [static]

Should spinners in free-spin wrap the mouse close to the spinner?

static int ManagedServices::abstract::GetNearWrapDistance ( ) [static]

The distance from the spinner at which the mouse cursor should wrap during free spin when Near Wrap is enabled.


Member Data Documentation

const int ManagedServices::abstract::SceneSelectionChanged = NOTIFY_SELECTIONSET_CHANGED [static]

<brief> Sent after the selection set has changed </brief>

const int ManagedServices::abstract::SceneSelectionLocked = NOTIFY_SELECTION_LOCK [static]
const int ManagedServices::abstract::SceneSelectionUnlocked = NOTIFY_SELECTION_UNLOCK [static]
const int ManagedServices::abstract::ModifyPanelSelectionChanged = NOTIFY_MODPANEL_SEL_CHANGED [static]
const int ManagedServices::abstract::PostModifierAdded = NOTIFY_POST_MODIFIER_ADDED [static]
const int ManagedServices::abstract::PostModifierDeleted = NOTIFY_POST_MODIFIER_DELETED [static]

Property Documentation

IMaxValueCtrlWndMsg ManagedServices::abstract::MessageHandler

For internal use only.


ManagedServices::abstract ManagedServices::abstract ManagedServices::abstract ManagedServices::abstract ManagedServices::abstract ManagedServices::abstract ManagedServices::abstract ManagedServices::abstract ManagedServices::abstract ManagedServices::abstract
ManagedServices::abstract ManagedServices::abstract ManagedServices::abstract ManagedServices::abstract ManagedServices::abstract ManagedServices::abstract ManagedServices::abstract ManagedServices::abstract ManagedServices::abstract ManagedServices::abstract