Changeset 48257 in vbox for trunk/doc/manual

Timestamp:

Sep 4, 2013 9:27:51 AM (11 years ago)

Author:

vboxsync

Message:

doc/manual: document GUI/RestrictedVisualStates

File:

• trunk/doc/manual/en_US/user_AdvancedTopics.xml (modified) (10 diffs)

trunk/doc/manual/en_US/user_AdvancedTopics.xml

@@ -2001 +2001 @@
           </glossdef>
         </glossentry>
-      
+
         <glossentry>
           <glossterm><computeroutput>Input</computeroutput></glossterm>
@@ -2008 +2008 @@
           </glossdef>
         </glossentry>
-      
+
         <glossentry>
           <glossterm><computeroutput>Update</computeroutput></glossterm>
@@ -2015 +2015 @@
           </glossdef>
         </glossentry>
-      
+
         <glossentry>
           <glossterm><computeroutput>Language</computeroutput></glossterm>
@@ -2022 +2022 @@
           </glossdef>
         </glossentry>
-      
+
         <glossentry>
           <glossterm><computeroutput>Display</computeroutput></glossterm>
@@ -2029 +2029 @@
           </glossdef>
         </glossentry>
-      
+
         <glossentry>
           <glossterm><computeroutput>Network</computeroutput></glossterm>
@@ -2036 +2036 @@
           </glossdef>
         </glossentry>
-      
+
         <glossentry>
           <glossterm><computeroutput>Extensions</computeroutput></glossterm>
@@ -2043 +2043 @@
           </glossdef>
         </glossentry>
-      
+
         <glossentry>
           <glossterm><computeroutput>Proxy</computeroutput></glossterm>
@@ -2058 +2058 @@
 
     </sect2>
-      
 
     <sect2>
@@ -2214 +2213 @@
       <screen>VBoxManage setextradata "VM name" GUI/RestrictedStatusBarIndicators</screen>
 
-  </sect2>
+    </sect2>
+
+    <sect2>
+      <title>Configure VM window visual modes</title>
+
+      <para>You can disable (i.e. black-list) certain VM visual modes:</para>
+      <screen>VBoxManage setextradata "VM name" GUI/RestrictedVisualStates OPTION[,OPTION...]</screen>
+
+      <para>where <computeroutput>OPTION</computeroutput> is one of the
+        following keywords:</para><glosslist>
+        <glossentry>
+          <glossterm><computeroutput>Fullscreen</computeroutput></glossterm>
+          <glossdef>
+            <para>Don't allow to switch the VM into fullscreen mode.</para>
+          </glossdef>
+        </glossentry>
+
+        <glossentry>
+          <glossterm><computeroutput>Seamless</computeroutput></glossterm>
+          <glossdef>
+            <para>Don't allow to switch the VM into seamless mode.</para>
+          </glossdef>
+        </glossentry>
+
+        <glossentry>
+          <glossterm><computeroutput>Scale</computeroutput></glossterm>
+          <glossdef>
+            <para>Don't allow to switch the VM into scale mode.</para>
+          </glossdef>
+        </glossentry>
+      
+      </glosslist>
+
+      <para>This is a per-VM setting. Any combination of the above is allowed. To restore
+        the default behavior, use</para>
+
+      <screen>VBoxManage setextradata "VM name" GUI/RestrictedVisualStates</screen>
+
+      </sect2>
 
       <sect2>
@@ -2358 +2395 @@
 
       </sect2>
+
       <sect2>
         <title>Action when terminating the VM</title>