<doc>
	<legacy_id>2026</legacy_id>
	<name>vScroll</name>
	<type>property</type>

	<syntax>
		<example>set the vScroll of {<i>field </i>| <i>group</i>} to <i>pixels</i></example>
		<example>get the scroll of <i>stack</i></example>
	</syntax>

	<synonyms>
		<synonym>scroll</synonym>
	</synonyms>

	<summary>Specifies the vertical scroll of a <keyword tag="field">field</keyword>, <command tag="group">group</command>, or <object tag="stack">stack</object>.</summary>

	<examples>
<example>set the vScroll of group "Thumbnails" to 20</example>
	</examples>

	<history>
		<introduced version="1.0">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		
		<experimental version=""></experimental>
		<nonexperimental version=""></nonexperimental>
	</history>

	<objects>
		<field/>
	</objects>

	<platforms>
		<mac/>
		<windows/>
		<linux/>
		<ios/>
		<android/>
	</platforms>

	<classes>
		<desktop/>
		<server/>
		<web/>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
		<category>Appearance &amp; Positioning</category>
	</classification>

	<references>
		<property tag="scrollbarWidth">scrollbarWidth Property</property>
	</references>

	<description>Use the <b>vScroll</b> <glossary tag="property">property</glossary> to scroll a <keyword tag="field">field</keyword> or <command tag="group">group</command>, or to check how far it's been scrolled.<p></p><p><b>Value:</b></p><p>The <b>vScroll</b> of a <keyword tag="field">field</keyword>, <command tag="group">group</command>, or <object tag="stack">stack</object> is a non-negative <keyword tag="integer">integer</keyword>.</p><p></p><p>By default, the <b>vScroll</b> <glossary tag="property">property</glossary> of newly created <glossary tag="object">objects</glossary> is set to zero.</p><p></p><p>For stacks, the <b>vScroll</b> <glossary tag="property">property</glossary> is read-only and cannot be set.</p><p></p><p><b>Comments:</b></p><p>The <b>vScroll</b> is the amount in <property tag="pixels">pixels</property> the <glossary tag="object">object</glossary> has been scrolled down. If the <b>vScroll</b> is zero, the <glossary tag="object">object</glossary> has not been scrolled.</p><p></p><p>Setting the <b>vScroll</b> of a <keyword tag="field">field</keyword> or <command tag="group">group</command> causes a <message tag="scrollbarDrag">scrollbarDrag</message> <keyword tag="message box">message</keyword> to be sent to the <keyword tag="field">field</keyword> or <command tag="group">group</command>.</p><p></p><p></p><cp_note>On <glossary tag="Mac OS">Mac OS</glossary> and <glossary tag="OS X">OS X systems</glossary>, the <glossary tag="menu bar">menu bar</glossary> appears at the top of the screen, rather than inside the stack window. If a <glossary tag="stack">stack's</glossary> <property tag="editMenus">editMenus</property> <glossary tag="property">property</glossary> is set to false and the <object tag="stack">stack</object> contains a <glossary tag="menu bar">menu bar</glossary>, the window is scrolled down and resized so that the <glossary tag="menu bar">menu bar</glossary> <command tag="group">group</command> is not visible in the window. Because of this, on <glossary tag="Mac OS">Mac OS</glossary> and <glossary tag="OS X">OS X systems</glossary>, the <b>vScroll</b> of a <object tag="stack">stack</object> reports the amount the <object tag="stack">stack</object> has been scrolled down to hide a <glossary tag="menu bar">menu bar</glossary> <command tag="group">group</command>.</cp_note></description>
</doc>