MAXScript Language Reference > 3ds Max Objects > Interfaces > Core Interfaces > Core Interfaces Documentation > I,J,K >

# Interface: IsolateSelection

Interfaces > Core Interfaces > IsolateSelection

| Viewport Shading - Quick Navigation | Core Interfaces - Quick Navigation

This Core Interface exposes the Isolate Selection feature to MAXScript.

In versions prior to 3ds Max 2013 the Isolate Selection was implemented using MAXScript.

In 3ds Max 2013, the functionality was reimplemented as integral part of the User Interface.

Methods:

    <boolean>IsolateSelection.EnterIsolateSelectionMode()

Enters Isolate Selection mode.

Returns True on success, False if already in Isolate Selection mode.

    <boolean>IsolateSelection.ExitIsolateSelectionMode()

Exits Isolate Selection mode.

Returns True on success, False if not in Isolate Selection mode.

    <boolean>IsolateSelection.IsolateSelectionModeActive()

Returns True if in Isolate Selection mode, False if not.

    <boolean>IsolateSelection.IsNodeIsolated <node>node

Returns True if the specified node is isolated (3ds Max is in Isolate Selection mode and the specified node was selected when the mode was invoked).

Returns False if the Isolate Selection mode is not active or the node was not selected and was thus hidden in the Isolate Selection process.

    <void>IsolateSelection.SuppressIsolateSelectionWarningDialogue <boolean>bSuppress

When the argument is True, the Isolate Selection warning will be suppressed.

When the argument is False, the Isolate Selection warning will be issued when opening a scene with isolated objects.

EXAMPLE:
    s = Sphere() --create a sphere
    -->$Sphere:Sphere001 @ [0.000000,0.000000,0.000000]
    b = Box pos:[50,0,0] --create a box
    -->$Box:Box001 @ [50.000000,0.000000,0.000000]
    c = Cone pos:[-50,0,0] --create a cone
    -->$Cone:Cone001 @ [-50.000000,0.000000,0.000000]
    select s --select the sphere
    -->OK
    IsolateSelection.EnterIsolateSelectionMode() --isolate it - it works!
    -->true
    IsolateSelection.EnterIsolateSelectionMode() --cannot isolate again
    -->false
    IsolateSelection.IsolateSelectionModeActive() --check if in Isolate Mode
    -->true
    IsolateSelection.IsNodeIsolated s --check if the sphere is isolated
    -->true
    IsolateSelection.IsNodeIsolated b --check if the box is isolated
    -->false
    IsolateSelection.IsNodeIsolated c --check if the cone is isolated
    -->false
    holdMaxFile() --hold the scene
    -->OK
    IsolateSelection.SuppressIsolateSelectionWarningDialogue false --enable warning
    -->OK
    fetchMaxFile() --fetch, answer prompt with Yes - an Isolation warning will follow
    -->OK
    --NOTE that 'fetchMaxFile quiet:true' will suppress both the prompt and the warning
    IsolateSelection.SuppressIsolateSelectionWarningDialogue true --suppress the warning
    -->OK
    fetchMaxFile() --fetch, answer prompt with Yes - no Isolation warning will follow.
    -->OK
    IsolateSelection.ExitIsolateSelectionMode() --exist the Isolate Mode
    -->true
    IsolateSelection.ExitIsolateSelectionMode() --can't exit again, already off
    -->false