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

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

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

---

nsAttachedProperties (NishySoftware.Wpf.AttachedProperties)

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

概要 (About)

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

インストール方法 (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 のマウスホイールイベントの処理モードを指定します。

    public enum MouseWheelHandlingMode
    {
        Normal,
        OnlyVisible,
        OnlyScrollable,
    }

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

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

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

この添付プロパティを使用すると、ScrollViewerが入れ子(ネスト)で使用されている場合に、内側のScrollViewerが常にマウスホイールイベントを処理するのを防ぐことができます。
この添付プロパティは、主にDataGrid/ListView/ListBoxなどの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の日本語トップページへ戻る