blob: 2bb9b7fcbdf16e127bdcc733b9cca9dbfd9ab083 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<apiPackage id="spark.layouts"><apiName>spark.layouts</apiName><apiDetail/><apiClassifier id="spark.layouts:ViewMenuLayout"><apiName>ViewMenuLayout</apiName><shortdesc>
Die ViewMenuLayout-Klasse definiert das Layout des ViewMenu-Containers.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="2.5"/><apiTool description="" name="Flex" version="4.5"/></apiVersion></asMetadata><asCustoms><mxml><![CDATA[
<p>The <code>&lt;s:ViewMenuLayout&gt;</code> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:</p>
<pre>
&lt;s:ViewMenuLayout
<strong>Properties</strong>
horizontalGap="2"
requestedMaxColumnCount="3"
verticalGap="2"
/&gt;
</pre>
]]></mxml></asCustoms></prolog><apiClassifierDetail><apiClassifierDef><apiAccess value="public"/><apiStatic/><apiBaseClassifier>spark.layouts.supportClasses:LayoutBase</apiBaseClassifier></apiClassifierDef><apiDesc>
Die ViewMenuLayout-Klasse definiert das Layout des ViewMenu-Containers. Das Menü kann, je nach Anzahl der Menüelemente, mehrere Zeilen haben.
<p>Die <codeph>requestedMaxColumnCount</codeph>-Eigenschaft definiert die maximale Anzahl von Menüelementen in einer Zeile. Die Eigenschaft ist standardmäßig auf drei festgelegt.</p>
<p>Die ViewMenuLayout-Klasse definiert das Layout wie folgt: </p>
<ul>
<li>Wenn Sie drei oder weniger Menüelemente definieren, bei denen die <codeph>requestedMaxColumnCount</codeph>-Eigenschaft den Standardwert drei enthält, werden die Menüelemente in einer einzelnen Zeile angezeigt. Alle Menüelemente haben die gleiche Größe.
<p>Wenn Sie vier oder mehr Menüelemente definieren, also mehr Menüelemente als von der <codeph>requestedMaxColumnCount</codeph>-Eigenschaft festgelegt, erstellt der ViewMenu-Container mehrere Zeilen.</p></li>
<li>Wenn die Anzahl der Menüelemente gleichmäßig teilbar ist durch die <codeph>requestedMaxColumnCount</codeph>-Eigenschaft, enthalten alle Zeilen die gleiche Anzahl an Menüelementen. Alle Menüelemente haben die gleiche Größe.
<p>Beispiel: Die <codeph>requestedMaxColumnCount</codeph>-Eigenschaft ist auf den Standardwert drei festgelegt und Sie definieren sechs Menüelemente. Das Menü zeigt zwei Zeilen mit jeweils drei Menüelementen an. </p></li>
<li>Wenn die Anzahl der Menüelemente nicht gleichmäßig durch die <codeph>requestedMaxColumnCount</codeph>-Eigenschaft teilbar ist, können die Zeilen unterschiedlich viele Menüelemente enthalten. Die Größe der Menüelemente hängt von der Anzahl der Menüelemente in der Zeile ab.
<p>Beispiel: Die <codeph>requestedMaxColumnCount</codeph>-Eigenschaft ist auf den Standardwert drei festgelegt und Sie definieren acht Menüelemente. Das Menü zeigt drei Zeilen an. Die erste Zeile enthält zwei Menüelemente. Die zweite und dritte Zeile enthalten jeweils drei Elemente. </p></li>
</ul>
<p>Sie können ein eigenes Layout für das Menü erstellen, indem Sie selbst eine Layoutklasse erstellen. Standardmäßig definiert die spark.skins.mobile.ViewMenuSkin-Klasse die Skin für den ViewMenu-Container. Definieren Sie zum Anwenden einer benutzerdefinierten ViewMenuLayout-Klasse auf den ViewMenu-Container eine neue Skinklasse für den ViewMenu-Container. </p>
<p>Die ViewMenuSkin-Klasse enthält eine Definition für einen Gruppencontainer mit dem Namen <codeph>contentGroup</codeph>, wie unten gezeigt:</p>
<pre>
&lt;s:Group id="contentGroup" left="0" right="0" top="3" bottom="2"
minWidth="0" minHeight="0">
&lt;s:layout>
&lt;s:ViewMenuLayout horizontalGap="2" verticalGap="2" id="contentGroupLayout"
requestedMaxColumnCount="3" requestedMaxColumnCount.landscapeGroup="6"/>
&lt;/s:layout>
&lt;/s:Group></pre>
<p>Um die benutzerdefinierte ViewMenuLayout-Klasse anzuwenden, sollte Ihre Skinklasse einen Container mit dem Namen <codeph>contentGroup</codeph> definieren. Dieser Container nutzt die <codeph>layout</codeph>-Eigenschaft zur Angabe der benutzerdefinierten Layoutklasse. </p>
</apiDesc></apiClassifierDetail><related-links><link href="spark.components.xml#ViewMenu"><linktext>spark.components.ViewMenu</linktext></link><link href="spark.components.xml#ViewMenuItem"><linktext>spark.components.ViewMenuItem</linktext></link><link href="" invalidHref="spark.skins.mobile.ViewMenuSkin.xml"><linktext>spark.skins.mobile.ViewMenuSkin</linktext></link></related-links><apiConstructor id="spark.layouts:ViewMenuLayout:ViewMenuLayout"><apiName>ViewMenuLayout</apiName><shortdesc>
Konstruktor.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="2.5"/><apiTool description="" name="Flex" version="4.5"/></apiVersion></asMetadata></prolog><apiConstructorDetail><apiConstructorDef><apiAccess value="public"/></apiConstructorDef><apiDesc>
Konstruktor.
</apiDesc></apiConstructorDetail></apiConstructor><apiValue id="spark.layouts:ViewMenuLayout:horizontalGap:get"><apiName>horizontalGap</apiName><shortdesc>
Der horizontale Raum (in Pixeln) zwischen Spalten.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="2.5"/><apiTool description="" name="Flex" version="4.5"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true" name="propertyChange"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Number"/><apiDefaultValue>2
</apiDefaultValue></apiValueDef><apiDesc>
Der horizontale Raum (in Pixeln) zwischen Spalten.
</apiDesc></apiValueDetail><related-links><link href="spark.layouts.xml#ViewMenuLayout/verticalGap"><linktext>verticalGap</linktext></link></related-links></apiValue><apiValue id="spark.layouts:ViewMenuLayout:requestedMaxColumnCount:get"><apiName>requestedMaxColumnCount</apiName><shortdesc>
Die maximale Anzahl der Spalten, die in einer Zeile angezeigt werden sollen.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.5"/><apiTool description="" name="Flex" version="4"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="int"/><apiDefaultValue>3
</apiDefaultValue></apiValueDef><apiDesc>
Die maximale Anzahl der Spalten, die in einer Zeile angezeigt werden sollen.
</apiDesc></apiValueDetail></apiValue><apiValue id="spark.layouts:ViewMenuLayout:verticalGap:get"><apiName>verticalGap</apiName><shortdesc>
Der vertikale Raum (in Pixeln) zwischen Zeilen.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="2.5"/><apiTool description="" name="Flex" version="4.5"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true" name="propertyChange"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Number"/><apiDefaultValue>2
</apiDefaultValue></apiValueDef><apiDesc>
Der vertikale Raum (in Pixeln) zwischen Zeilen.
</apiDesc></apiValueDetail><related-links><link href="spark.layouts.xml#ViewMenuLayout/horizontalGap"><linktext>horizontalGap</linktext></link></related-links></apiValue></apiClassifier></apiPackage>