次の方法で共有


ProgressBar クラス

定義

操作の進行状況を示すコントロールを表します。

このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKWinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
class ProgressBar : RangeBase
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class ProgressBar : RangeBase
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
public class ProgressBar : RangeBase
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class ProgressBar : RangeBase
Public Class ProgressBar
Inherits RangeBase
継承
ProgressBar
属性
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContractVersionAttribute

ヒント

詳細、設計ガイダンス、およびコード例については、「 進行状況コントロール」を参照してください。

WinUI 2 ギャラリー アプリには、ほとんどの WinUI 2 コントロールと機能の対話型の例が含まれています。 Microsoft Store からアプリを入手するか、GitHub でソース コードを取得します。

次に示すのは、不確定な ProgressBar と、値が RepeatButton クリックに依存する基本的な確定 ProgressBar を設定する方法を示しています。

<!-- xmlns:muxc="using:Microsoft.UI.Xaml.Controls" -->

<StackPanel x:Name="LayoutRoot">
    <StackPanel BorderThickness="4" BorderBrush="Black" Padding="12">
        <TextBlock Text="Indeterminate Progress Bar"/>
        <muxc:ProgressBar IsIndeterminate="True" Margin="0,12"/>
    </StackPanel>
    <StackPanel BorderBrush="Black" BorderThickness="4" Padding="12">
        <TextBlock Text="Value-Based Progress Bar"/>
        <muxc:ProgressBar x:Name="progressBar1" Value="0" Maximum="200" Margin="0,12"/>
        <RepeatButton Content="Press and hold" Click="RepeatButton_Click"/>
    </StackPanel>
</StackPanel>
private static int _clicks = 0;

private void RepeatButton_Click(object sender, RoutedEventArgs e)
{
    _clicks += 1;
    progressBar1.Value = _clicks;
    if (_clicks >= progressBar1.Maximum) _clicks = 0;
}

注釈

ProgressBar コントロールは、繰り返しパターンを表示するバー、または値に基づいて塗りつぶされるバーの 2 つのスタイルのいずれかで、操作の進行状況を視覚的に示します。

進行状況バー コントロールの不確定と確定

IsIndeterminate プロパティは、ProgressBar の外観を決定します。

  • 繰り返しパターンを表示するには、 IsIndeterminatetrue に設定します。 不確定な進行状況に使用する別のコントロールは 、ProgressRing です
  • 値に基づいてバーを塗りつぶすには、 IsIndeterminatefalse に設定します。 (これが既定値です)。 IsIndeterminatefalse の場合は、 Minimum プロパティと Maximum プロパティを使用して範囲 指定します。 既定では 、最小 は 0、 最大値 は 100 です。 進行状況の値を指定するには、 Value プロパティを設定します。

コントロールのスタイルとテンプレート

既定の スタイルControlTemplate を変更して、コントロールに一意の外観を与えることができます。 コントロールのスタイルとテンプレートの変更については、「 XAML スタイル」を参照してください。 コントロールの外観を定義する既定のスタイル、テンプレート、およびリソースがファイルに generic.xaml 含まれます。 設計上の目的で、 generic.xaml は WinUI (Microsoft.UI.Xaml) NuGet パッケージと共にインストールされます。 既定では、この場所は \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml です。 WinUI の異なるバージョンのスタイルとリソースの値が異なる場合があります。

XAML には、コントロール テンプレートを変更せずに、さまざまなビジュアル状態のコントロールの色を変更するために使用できるリソースも含まれています。 これらのリソースを変更することは、 Background や Foreground などのプロパティを設定する場合に適 しています。 詳細については、XAML スタイルに関する記事の「軽量スタイル設定」セクションを参照してください。

コンストラクター

ProgressBar()

ProgressBar クラスの新しいインスタンスを初期化します。

このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKWinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

プロパティ

IsIndeterminate

進行状況バーが繰り返しパターンで一般的な進行状況を報告するか、 Value プロパティに基づいて進行状況を報告するかを示す値を取得または設定します。

このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKWinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

IsIndeterminateProperty

IsIndeterminate 依存関係プロパティを識別します。

このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKWinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

ShowError

ユーザーに Error 状態を伝えるビジュアル状態を進行状況バーで使用するかどうかを示す値を取得または設定します。

このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKWinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

ShowErrorProperty

ShowError 依存関係プロパティを識別します。

このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKWinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

ShowPaused

時停止 状態をユーザーに伝えるビジュアル状態を進行状況バーで使用するかどうかを示す値を取得または設定します。

このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKWinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

ShowPausedProperty

ShowPaused 依存関係プロパティを識別します。

このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKWinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

TemplateSettings

ProgressBar コントロールのテンプレートを定義するときに TemplateBinding ソースとして参照できる計算値を提供する オブジェクトを取得します。

このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKWinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

TemplateSettingsProperty

TemplateSettings 依存関係プロパティを識別します。

このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKWinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

適用対象

こちらもご覧ください