萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android ProgressBar 進度條完整指南:XML 屬性、程式控制、雙進度條與 Indeterminate 模式

XML 定義水平進度條

<ProgressBar
    android:id="@+id/progressbar_updown"
    android:layout_width="200dp"
    android:layout_height="wrap_content"
    style="?android:attr/progressBarStyleHorizontal"
    android:max="100"
    android:progress="50"
    android:secondaryProgress="70"
    android:layout_gravity="center_vertical" />
  • style="?android:attr/progressBarStyleHorizontal":水平條樣式(預設為圓形)。
  • android:max:最大值。
  • android:progress:主進度。
  • android:secondaryProgress:次進度(顯示於主進度後方,如緩衝進度)。

Java 控制 API

ProgressBar bar = findViewById(R.id.progressbar_updown);
bar.incrementProgressBy(5);           // +5
bar.incrementProgressBy(-5);          // -5
bar.incrementSecondaryProgressBy(10); // 次進度 +10
bar.setProgress(80);                  // 直接設定
bar.setSecondaryProgress(90);
bar.setMax(200);                      // 修改最大值
bar.setVisibility(View.VISIBLE);      // 顯示/隱藏
bar.setIndeterminate(true);           // 不確定模式(循環動畫)

常用方法速查

方法說明
getMax()取得最大值
getProgress()取得主進度
getSecondaryProgress()取得次進度
isIndeterminate()是否為不確定模式
setIndeterminate(boolean)設定不確定模式

雙進度條範例:下載進度 + 緩衝進度

// 模擬下載
new Thread(() -> {
    int progress = 0;
    while (progress <= 100) {
        runOnUiThread(() -> {
            bar.setProgress(progress);
            bar.setSecondaryProgress(Math.min(progress + 10, 100)); // 緩衝領先 10%
        });
        progress += 5;
        SystemClock.sleep(500);
    }
}).start();

Material Design 進度條

新專案建議使用 com.google.android.material.progressindicator.LinearProgressIndicator,支援動畫、顏色主題、圓角、追蹤模式等現代化樣式。

總結

ProgressBar 輕量易用,掌握主/次進度與 Indeterminate 模式即可涵蓋下載、上傳、載入等大多數場景。

copyright © 萬盛學電腦網 all rights reserved