このページは、github.comに登録されているnsAttachedPropertiesのREADME.mdを日本語化したものです。英語版の最新版はgithub.comを参照してください。

このページの内容は、nsAttachedProperties 1.0.0 相当の内容が翻訳されています。

nsAttachedPropertiesの日本語トップページへ戻る

---

nsAttachedProperties (NishySoftware.Wpf.AttachedProperties)

開発のステータス (Development status)

概要 (About)

nsAttachedProperties (NishySoftware.Wpf.AttachedProperties) は、既存のWPFコントロールの機能を拡張したり、動作を変更するために使用できる添付プロパティのライブラリです。

License

このライブラリーは、Apache-2.0 ライセンスで提供されいます。

インストール方法 (Installation)

NuGetパッケージをインストールします。

PM> Install-Package NishySoftware.Wpf.AttachedProperties

• NishySoftware.Wpf.AttachedProperties – nsAttachedProperties library.

機能 / 使い方 (Features / How to use)

本ライブラリが提供する添付プロパティは、既存のWPFコントロールの機能拡張や動作変更に利用することができます。
xaml で名前空間を指定するときには、xmlns:nsAttachedProps="http://schemas.nishy-software.com/xaml/attached-properties" または xmlns:nsXaml="http://schemas.nishy-software.com/xaml" を使用します。

<Window
  xmlns:nsAttachedProps="http://schemas.nishy-software.com/xaml/attached-properties"
  ...
  >
...
</Window>

ScrollViewerProperties クラス (ScrollViewerProperties class)

Namespace: NishySoftware.Wpf.AttachedProperties
Assembly: nsAttachedProperties.Wpf.dll

ScrollViewerPropertiesクラスが提供する添付プロパティは、ScrollViewer コントロールの機能拡張や動作変更を行うために使用することができます。

• MouseWheelHandlingMode

MouseWheelHandlingMode enum

スクロール可能なコンテンツに対して利用される ScrollViewer のマウスホイールイベントの処理モードを指定します。

この列挙型の値は、ScrollViewerProperties.MouseWheelHandlingModeの添付プロパティで使用されます。

    public enum MouseWheelHandlingMode
    {
        Inherit,
        Normal,
        OnlyVisible,
        OnlyScrollable,
    }

値	振舞
Inherit	親の値を継承します。この値は既定値です。
Normal	マウスホイールイベントを常に処理します。ScrollViewer の本来の動作です。
OnlyVisible	垂直スクロールバーが表示されているときのみ、マウスホイールイベントを処理します。
OnlyScrollable	垂直スクロールバーがマウスホイールの回転方向にスクロールできるときのみ、マウスホイールイベントを処理します。

MouseWheelHandlingMode 添付プロパティ (MouseWheelHandlingMode attached property)

この添付プロパティは、入れ子になった(ネストされた)ScrollViewerのマウスホイール回転によるスクロール動作を改善するために使用することができます。

具体的な動作として、この添付プロパティを使用すると、ScrollViewerが入れ子(ネスト)で使用されている場合に、内側のScrollViewerが常にマウスホイールイベントを処理するのを防ぐことができます。

この添付プロパティは、主にDataGrid/ListView/ListBoxなどのScrollViewerを使用してコンテンツを表示するコントロールに使用します。しかしながらWindow、Grid、GroupBoxなどにも設定可能です。

この添付プロパティが ScrollViewer 以外の FrameworkEelement に設定された場合、その値はその FrameworkEelement の子の ScrollViewer に継承されます。
値が継承されるScrollViewerは、MouseWheelHandlingMode 添付プロパティを持たないか、MouseWheelHandlingMode 添付プロパティがInheritに設定されているかのどちらかのScrollViewerです。

この添付プロパティがScrollViewerに設定されている場合、そのScrollViewerの値は子のScrollViewerには継承されません。

例 (Examples)

nsAttachedProps:ScrollViewerProperties.MouseWheelHandlingMode の使用例です。

<Window
  ...
  xmlns:nsAttachedProps="http://schemas.nishy-software.com/xaml/attached-properties">
    <ScrollViewer Grid.Row="1"
                  Width="300"
                  Height="300">
...
        <DataGrid Grid.Row="1"
                  ItemsSource="{Binding Source={StaticResource SmallDataItemsView1}}"
                  nsAttachedProps:ScrollViewerProperties.MouseWheelHandlingMode="OnlyScrollable"/>
        </DataGrid>
...

---

nsAttachedPropertiesの日本語トップページへ戻る