派生元: UIView
定義: IGProgressView.h

概要

IGProgressView は、規格、ラジアル、またはカスタム progress 図形を描画する progress コントロールです。また、IGProgressView をスタイル設定してカスタマイズできます。progressTintColor および progressTrackTintColor などのプロパティを使用して IGProgressView の色を変更できます。詳細なカスタマイズのため、progressShapeLayerprogressTrackShapeLayer、および radialInsertShapeLayer が公開され、ストロークなどの progress の外観をカスタマイズできます。progressAnimationDuration および progressAnimationTimingFunction のプロパティを使用すると、progress の値が変更するときに再生するアニメーションもカスタマイズできます。

タスク

初期化と構成

進行状況のスタイル設定

  •   progressTintColor

    塗りつぶした progress の部分で表示される UIColor。タイプ: UIColor デフォルト値: colorWithRed:0.0 green:174/255.0 blue:239/255.0 alpha:1.0

    プロパティ
  •   progressTrackTintColor

    塗りつぶされない progress の部分で表示される UIColor。タイプ: UIColor デフォルト値: colorWithRed:88/255.0 green:89/255.0 blue:91/255.0 alpha:1.0

    プロパティ
  •   radialContentView

    IGProgressViewStyleRadial および IGProgressViewStyleRadialIndeterminate progress スタイルの中央に配置される UIView。タイプ: UIView デフォルト値: nil

    プロパティ
  •   radialInsertScale

    IGProgressViewStyleRadial および IGProgressViewStyleRadialIndeterminate progress スタイルの挿入サイズ。タイプ: CGFloat デフォルト値: 0.80

    プロパティ
  •   radialInsertTintColor

    IGProgressViewStyleRadial および IGProgressViewStyleRadialIndeterminate progress スタイルの挿入部分で表示される UIColor。タイプ: UIColor デフォルト値: whiteColor

    プロパティ
  •   radialStartAngle

    スケールの度数の開始角度。タイプ: CGFloat デフォルト値: 270.0

    プロパティ
  •   radialEndAngle

    スケールの度数の終了角度。タイプ: CGFloat デフォルト値: 270.0

    プロパティ
  •   standardCornerRadius

    IGProgressViewStyleStandard および IGProgressViewStyleStandardIndeterminate progress スタイルの丸み角度を描画するときに使用する半径。タイプ: CGFloat デフォルト値: 8.0

    プロパティ

進行状況の図形レイヤー

プロパティ

progress

IGProgressView に表示される現在の進行状況。

@property (nonatomic, assign) CGFloat progress

注記

現在の進行状況は、0.0 ~ 1.0 の浮動小数点値によって表されます。1.0 の値は、タスクの完了を示します。デフォルト値は 0.0 です。0.0 より小さい値は 0.0 になります。1.0 より大きい値は 1.0 になります。

定義:

IGProgressView.h

progressAnimationDuration

progress を新しい値にアニメーションを再生するときのアニメーション期間。タイプ: CGFloat デフォルト値: 0.25

@property (nonatomic, assign) CGFloat progressAnimationDuration

注記

アニメーションは秒で測定されます。このプロパティは IGProgressViewStyleRadial および IGProgressViewStyleStandard progress スタイルで使用されます。

定義:

IGProgressView.h

progressAnimationTimingFunction

定義済みコア アニメーションのタイミング関数を指定するために使用される定数。タイプ: NSString * デフォルト値: kCAMediaTimingFunctionDefault

@property (nonatomic, assign) NSString *progressAnimationTimingFunction

注記

このプロパティは IGProgressViewStyleRadial および IGProgressViewStyleStandard progress スタイルで使用されます。

定義:

IGProgressView.h

progressShapeLayer

塗りつぶした progress CAShapeLayer を返します。(読み取り専用)

@property (nonatomic, readonly) CAShapeLayer *progressShapeLayer

定義:

IGProgressView.h

progressTintColor

塗りつぶした progress の部分で表示される UIColor。タイプ: UIColor デフォルト値: colorWithRed:0.0 green:174/255.0 blue:239/255.0 alpha:1.0

@property (nonatomic, retain) UIColor *progressTintColor

定義:

IGProgressView.h

progressTrackShapeLayer

塗りつぶされない progress CAShapeLayer を返します。(読み取り専用)

@property (nonatomic, readonly) CAShapeLayer *progressTrackShapeLayer

定義:

IGProgressView.h

progressTrackTintColor

塗りつぶされない progress の部分で表示される UIColor。タイプ: UIColor デフォルト値: colorWithRed:88/255.0 green:89/255.0 blue:91/255.0 alpha:1.0

@property (nonatomic, retain) UIColor *progressTrackTintColor

定義:

IGProgressView.h

progressViewStyle

IGProgressView のスタイルを返します。(読み取り専用)

@property (nonatomic, readonly) IGProgressViewStyle progressViewStyle

注記

サポートされるスタイル:

  • IGProgressViewStyleStandardIndeterminate
  • IGProgressViewStyleStandard
  • IGProgressViewStyleRadialIndeterminate
  • IGProgressViewStyleRadial
  • IGProgressViewStyleCustom

定義:

IGProgressView.h

radialContentView

IGProgressViewStyleRadial および IGProgressViewStyleRadialIndeterminate progress スタイルの中央に配置される UIView。タイプ: UIView デフォルト値: nil

@property (nonatomic, retain) UIView *radialContentView

注記

IGProgressView が描画されたとき、UIView はラジアルの挿入に合わせるためにサイズ変更されます。

定義:

IGProgressView.h

radialEndAngle

スケールの度数の終了角度。タイプ: CGFloat デフォルト値: 270.0

@property (nonatomic, assign) CGFloat radialEndAngle

注記

0 角度に開始し、時計回りに 360 角度を一括処理する角度システム。0.0 より小さい値および 360.0 より大きい値はラップされます。

定義:

IGProgressView.h

radialInsertScale

IGProgressViewStyleRadial および IGProgressViewStyleRadialIndeterminate progress スタイルの挿入のサイズ。タイプ: CGFloat デフォルト値: 0.80

@property (nonatomic, assign) CGFloat radialInsertScale

注記

radialInsertScale は、0.0 ~ 1.0 の浮動小数点値によって表されます。1.0 の値は、基になるラジアル progress を完全に非表示します。0.0 より小さい値は 0.0 になります。1.0 より大きい値は 1.0 になります。

定義:

IGProgressView.h

radialInsertShapeLayer

IGProgressViewStyleRadial および IGProgressViewStyleRadialIndeterminate progress スタイルの挿入の CAShapeLayer を返します。(読み取り専用)

@property (nonatomic, readonly) CAShapeLayer *radialInsertShapeLayer

定義:

IGProgressView.h

radialInsertTintColor

IGProgressViewStyleRadial および IGProgressViewStyleRadialIndeterminate progress スタイルの挿入部分で表示される UIColor。タイプ: UIColor デフォルト値: whiteColor

@property (nonatomic, retain) UIColor *radialInsertTintColor

定義:

IGProgressView.h

radialStartAngle

スケールの度数の開始角度。タイプ: CGFloat デフォルト値: 270.0

@property (nonatomic, assign) CGFloat radialStartAngle

注記

0 角度に開始し、時計回りに 360 角度を一括処理する角度システム。0.0 より小さい値および 360.0 より大きい値はラップされます。

定義:

IGProgressView.h

standardCornerRadius

IGProgressViewStyleStandard および IGProgressViewStyleStandardIndeterminate progress スタイルの丸み角度を描画するときに使用する半径。タイプ: CGFloat デフォルト値: 8.0

@property (nonatomic, assign) CGFloat standardCornerRadius

定義:

IGProgressView.h

インスタンス メソッド

initWithCustomShape:

IGProgressView オブジェクトを初期化して返します。

- (id)initWithCustomShape:(CGPathRef)customShape

パラメーター

customShape

カスタム progress 図形として使用する CGPathRef。

戻り値

初期化された IGProgressView オブジェクト。オブジェクトが作成できなかった場合は nil

注記

初期化された IGProgressView のフレームは CGRectZero です。frame プロパティを設定する必要があります。

定義:

IGProgressView.h

initWithFrame:customShape:

IGProgressView オブジェクトを初期化して返します。

- (id)initWithFrame:(CGRect)frame customShape:(CGPathRef)customShape

パラメーター

frame

ビューのポイントで測定されるフレーム矩形。フレームの基点は、追加するスーパビューに相対します。このメソッドは、中央および境界線を設定するためにフレーム矩形を使用します。

customShape

カスタム progress 図形として使用する CGPathRef。

戻り値

初期化された IGProgressView オブジェクト。オブジェクトが作成できなかった場合は nil

定義:

IGProgressView.h

initWithFrame:viewStyle:

IGProgressView オブジェクトを初期化して返します。

- (id)initWithFrame:(CGRect)frame viewStyle:(IGProgressViewStyle)progressStyle

パラメーター

frame

ビューのポイントで測定されるフレーム矩形。フレームの基点は、追加するスーパビューに相対します。このメソッドは、中央および境界線を設定するためにフレーム矩形を使用します。

progressStyle

作成する progress のスタイルを指定する IGProgressViewStyle の列挙値。

戻り値

初期化された IGProgressView オブジェクト。オブジェクトが作成できなかった場合は nil

注記

サポートされるスタイル:

  • IGProgressViewStyleStandardIndeterminate
  • IGProgressViewStyleStandard
  • IGProgressViewStyleRadialIndeterminate
  • IGProgressViewStyleRadial

定義:

IGProgressView.h

initWithStyle:

IGProgressView オブジェクトを初期化して返します。

- (id)initWithStyle:(IGProgressViewStyle)progressStyle

パラメーター

progressStyle

作成する progress のスタイルを指定する IGProgressViewStyle の列挙値。

戻り値

初期化された IGProgressView オブジェクト。オブジェクトが作成できなかった場合は nil

注記

初期化された IGProgressView のフレームは CGRectZero です。frame プロパティを設定する必要があります。

サポートされるスタイル:

  • IGProgressViewStyleStandardIndeterminate
  • IGProgressViewStyleStandard
  • IGProgressViewStyleRadialIndeterminate
  • IGProgressViewStyleRadial

定義:

IGProgressView.h

setProgress:animated:

IGProgressView で表示されている progress を変更します。変更でアニメーションを再生するオプションがあります。

- (void)setProgress:(CGFloat)progress animated:(BOOL)animated

パラメーター

progress

新しい progress 値。

animated

変更でアニメーションを再生するには YES に設定します。変更をすぐに表示するには NO に設定します。

注記

現在の progress は、0.0 ~ 1.0 の浮動小数点値によって表されます。1.0 の値は、タスクの完了を示します。デフォルト値は 0.0 です。0.0 より小さい値は 0.0 になります。1.0 より大きい値は 1.0 になります。

定義:

IGProgressView.h