バージョン

CarouselViewSettings クラス

カルーセル表示を実装するコントロールをサポートする設定を含みます (XamCarouselPanel および XamCarouselListBox など)。
シンタックス
'宣言
 
Public Class CarouselViewSettings 
   Inherits ViewSettingsBase
public class CarouselViewSettings : ViewSettingsBase
解説

XamCarouselPanel および XamCarouselListBox はそれぞれ、CarouselViewSettings のタイプの ViewSettings プロパティ (XamCarouselPanel.ViewSettings および XamCarouselListBox.ViewSettings) を公開します。CarouselViewSettings オブジェクトのプロパティを操作することで、XamCarouselPanel がどのように項目を整理して効果を適用するかを制御できます。

レイアウトと親エフェクトに影響を及ぼすプロパティの部分的なリストには以下が含まれます。

  • ItemPath - 項目が配置されるパスを指定します
  • ItemPathRenderBrush - パスを満たすために使用されるブラシを指定します
  • ItemPathRenderPen - パスをアウトラインするために使用されるペンを指定します
  • ItemSize - 項目のサイズを指定します
  • ItemsPerPage - 一度に表示される項目の最大数を指定します
  • AutoScaleItemContentsToFit - 各項目に指定されたサイズ内に収めるために、各項目のコンテンツをスケールするかどうかを指定します
  • OpacityEffectStops - XamCarouselPanel の位置に基づき各項目に不透明度の効果をどのように適用するかを説明する EffectStops（すなわち、Offset+Value ペア）を指定します
  • ScalingEffectStops - XamCarouselPanel の位置に基づき各項目にスケールの効果をどのように適用するかを説明する EffectStops（すなわち、Offset+Value ペア）を指定します
  • SkewAngleXEffectStops - XamCarouselPanel の位置に基づき各項目に X 軸の Skewing の効果をどのように適用するかを説明する EffectStops（すなわち、Offset+Value ペア）を指定します
  • SkewAngleYEffectStops - XamCarouselPanel の位置に基づき各項目に Y 軸の Skewing の効果をどのように適用するかを説明する EffectStops（すなわち、Offset+Value ペア）を指定します
  • ZOrderEffectStops - XamCarouselPanel の位置に基づき各項目に Z オーダーの効果をどのように適用するかを説明する EffectStops（すなわち、Offset+Value ペア）を指定します
このクラスによってサポートされるプロパティの完全なリストおよび各プロパティによって有効にされる機能に含まれるマニュアルを参照してください。

どのようにカルーセル表示が機能するかの説明については、開発者ガイドの「カルーセル アーキテクチャの概要」を参照してください。

使用例
The following example demonstrates how to create a CarouselViewSettings object for a XamCarouselPanel and initialize some of its properties. For a description and example of each property, please check the documentation for that property.
<igWindows:XamCarouselPanel x:Name="XamCarouselPanel1">
    <igWindows:XamCarouselPanel.Resources>
        <Path Visibility="Hidden" 
                Fill="{x:Null}" 
                Stretch="Fill" 
                Stroke="#FF000000" 
                x:Key="ovalPath" 
                Data="M230,239 C230,239 254.00029,48.999465 420.00029,47.999465 586.00029,46.999465 629.00026,157.00004 618.00026,276.00004 607.00026,395.00004 538.91118,531.32446 425.00013,523.00028 164.99995,504.00048 189.99998,154.99988 189.99998,154.99988" 
                Opacity="0.5" 
                Margin="0,0,0,0"/>
    </igWindows:XamCarouselPanel.Resources>
    
    <igWindows:XamCarouselPanel.ViewSettings>
        
        <igWindows:CarouselViewSettings 
                IsListContinuous="True" 
                ItemPath="{Binding ElementName=ovalPath, Mode=OneWay}" 
                ItemPathAutoPad="False" 
                ItemPathPadding="251,50,260,170" 
                ItemSize="200,200" 
                ItemPathHorizontalAlignment="Stretch" 
                ItemPathVerticalAlignment="Stretch" 
                ItemsPerPage="8" 
                UseOpacity="True" 
                UseZOrder="True" >
            
            <igWindows:CarouselViewSettings.ScalingEffectStops>
                <igWindows:ScalingEffectStopCollection>
                    <igWindows:ScalingEffectStop Value="0.3"/>
                    <igWindows:ScalingEffectStop Offset="0.35" Value="0.7"/>
                    <igWindows:ScalingEffectStop Offset="0.44" Value="1.5"/>
                    <igWindows:ScalingEffectStop Offset="0.6" Value="0.4"/>
                    <igWindows:ScalingEffectStop Offset="0.8" Value="0.3"/>
                    <igWindows:ScalingEffectStop Offset="1"/>
                </igWindows:ScalingEffectStopCollection>
            </igWindows:CarouselViewSettings.ScalingEffectStops>
            
            <igWindows:CarouselViewSettings.OpacityEffectStops>
                <igWindows:OpacityEffectStopCollection>
                    <igWindows:OpacityEffectStop/>
                    <igWindows:OpacityEffectStop Offset="0.35" Value="0.5"/>
                    <igWindows:OpacityEffectStop Offset="0.44" Value="1"/>
                    <igWindows:OpacityEffectStop Offset="0.6" Value="0.5"/>
                    <igWindows:OpacityEffectStop Offset="0.8" Value="0.2"/>
                    <igWindows:OpacityEffectStop Offset="1"/>
                </igWindows:OpacityEffectStopCollection>
            </igWindows:CarouselViewSettings.OpacityEffectStops>
            
            <igWindows:CarouselViewSettings.ZOrderEffectStops>
                <igWindows:ZOrderEffectStopCollection>
                    <igWindows:ZOrderEffectStop/>
                    <igWindows:ZOrderEffectStop Offset="0.4" Value="1"/>
                    <igWindows:ZOrderEffectStop Offset="1"/>
                </igWindows:ZOrderEffectStopCollection>
            </igWindows:CarouselViewSettings.ZOrderEffectStops>
            
        </igWindows:CarouselViewSettings>
        
    </igWindows:XamCarouselPanel.ViewSettings>
    
    <Ellipse Width="50" Height="50" Stroke="Black" Fill="Red" />
    <Ellipse Width="100" Height="50" Stroke="Black" Fill="Green" />
    <Polygon Points="0, 25, 25, 0, 75, 0, 100, 25, 75, 50, 25, 50" Stroke="Black" Fill="Yellow" />
    <Rectangle Width="100" Height="50" Stroke="Black" Fill="Purple" />
    <Polyline Points="0, 25, 25, 0, 50, 25, 25, 50, 0, 25" Stroke="SlateGray" StrokeThickness="2" Fill="Blue"/>
    <Path Stroke="Black" Fill="Gray" Data="M 10,10 C 10,100 100,-100 100,10" />
    
</igWindows:XamCarouselPanel>
参照