ProgressBar クラス

定義

名前空間:

Microsoft.UI.Xaml.Controls

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

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

/// [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

[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

継承

RangeBase

ProgressBar

属性

MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

例

ヒント

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

WinUI 2 ギャラリー アプリを開き、ProgressBar の動作を確認します。

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 の外観を決定します。

• 繰り返しパターンを表示するには、 IsIndeterminate を true に設定します。 不確定な進行状況に使用する別のコントロールは 、ProgressRing です。
• 値に基づいてバーを塗りつぶすには、 IsIndeterminate を false に設定します。 (これが既定値です)。 IsIndeterminate が false の場合は、 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 アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

プロパティ

IsIndeterminate	進行状況バーが繰り返しパターンで一般的な進行状況を報告するか、 Value プロパティに基づいて進行状況を報告するかを示す値を取得または設定します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
IsIndeterminateProperty	IsIndeterminate 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
ShowError	ユーザーに Error 状態を伝えるビジュアル状態を進行状況バーで使用するかどうかを示す値を取得または設定します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
ShowErrorProperty	ShowError 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
ShowPaused	一 時停止 状態をユーザーに伝えるビジュアル状態を進行状況バーで使用するかどうかを示す値を取得または設定します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
ShowPausedProperty	ShowPaused 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
TemplateSettings	ProgressBar コントロールのテンプレートを定義するときに TemplateBinding ソースとして参照できる計算値を提供する オブジェクトを取得します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

こちらもご覧ください

• ProgressRing
• プログレス コントロール