SplashScreenSubApplet (クラス)
public SplashScreenSubApplet {inherits SplashScreenRemoteInterface}
パッケージ: CURL.ENGINE.BROWSER

SplashScreenのUIの実装です。

導入: バージョン 7.0

コンストラクタ
default:SplashScreenSubApplet オブジェクトを作成します。
コンストラクタ public {SplashScreenSubApplet.default}

プロパティ
footer-frame:スプラッシュスクリーンのフッターを含むFrame
フィールド protected SplashScreenSubApplet.footer-frame:Frame
image-frame:スプラッシュスクリーンのイメージを含むFrame
フィールド protected SplashScreenSubApplet.image-frame:Frame
progress-bar:スプラッシュスクリーンに関連付けられたProgressBar
フィールド protected SplashScreenSubApplet.progress-bar:#ProgressBar
progress-bar-frame:スプラッシュスクリーンのProgressBarを含むFrame
フィールド protected SplashScreenSubApplet.progress-bar-frame:Frame
title-frame:スプラッシュスクリーンのタイトルを含むFrame
フィールド protected SplashScreenSubApplet.title-frame:Frame
view:スプラッシュスクリーンView
フィールド protected SplashScreenSubApplet.view:#View

メソッド
create-main-body:このスプラッシュスクリーンView内に表示されるGraphicを作成します。
public {SplashScreenSubApplet.create-main-body}:Graphic
handle-message:SplashScreenオブジェクトからのメッセージを処理します。
public {SplashScreenSubApplet.handle-message
message:{HashTable-of String, any}
}:void
handle-parameter:1つのメッセージコンポーネントを表します。
public {SplashScreenSubApplet.handle-parameter
name:String,
value:any
}:void
set-footer:スプラッシュスクリーンのフッターを設定します。
public {SplashScreenSubApplet.set-footer
footer:String,
halign:any,
font-family:String,
font-size:Distance,
font-weight:any,
color:String
}:void
set-image:スプラッシュスクリーンUIに関連したイメージを設定します。
public {SplashScreenSubApplet.set-image
u:#Url,
width:Distance,
height:Distance
}:void
set-progress-bar:determinate状態のProgressBarを設定します。
public {SplashScreenSubApplet.set-progress-bar
min:double,
max:double,
value:double
}:void
set-progress-bar-indeterminate:indeterminate状態のProgressBarを設定します。
public {SplashScreenSubApplet.set-progress-bar-indeterminate
indeterminate?:bool
}:void
set-progress-bar-value:ProgressBarの値を設定します。
public {SplashScreenSubApplet.set-progress-bar-value value:double}:void
set-title:スプラッシュスクリーンのタイトルを設定します。
public {SplashScreenSubApplet.set-title
title:String,
halign:any,
font-family:String,
font-size:Distance,
font-weight:any,
color:String
}:void
show:スプラッシュスクリーンViewを表示します。
public {SplashScreenSubApplet.show}:void
show-after:指定された Time が経過した後に、スプラッシュスクリーンViewを表示する為に、SplashScreenSubAppletオブジェクトをセットアップします。
public {SplashScreenSubApplet.show-after delay:Time}:void
メソッド 継承 Object: object-describe, object-describe-for-debugging, object-serialize



コンストラクタ詳細
default (コンストラクタ)
public {SplashScreenSubApplet.default}

SplashScreenSubApplet オブジェクトを作成します。




プロパティ詳細
footer-frame (フィールド)
protected SplashScreenSubApplet.footer-frame:Frame

スプラッシュスクリーンのフッターを含むFrame



image-frame (フィールド)
protected SplashScreenSubApplet.image-frame:Frame

スプラッシュスクリーンのイメージを含むFrame



progress-bar (フィールド)
protected SplashScreenSubApplet.progress-bar:#ProgressBar

スプラッシュスクリーンに関連付けられたProgressBar



progress-bar-frame (フィールド)
protected SplashScreenSubApplet.progress-bar-frame:Frame

スプラッシュスクリーンのProgressBarを含むFrame



title-frame (フィールド)
protected SplashScreenSubApplet.title-frame:Frame

スプラッシュスクリーンのタイトルを含むFrame



view (フィールド)
protected SplashScreenSubApplet.view:#View

スプラッシュスクリーンView

注意事項

これは、SplashScreenSubApplet.showメソッドによって設定されます。





メソッド詳細
create-main-body (メソッド)
public {SplashScreenSubApplet.create-main-body}:Graphic

このスプラッシュスクリーンView内に表示されるGraphicを作成します。

戻り値

このメソッドは、スプラッシュスクリーンの様々なコンポーネントを配置し、それをGraphicとして返します。

注意事項

このメソッドは、SplashScreenSubApplet.showメソッドから呼び出されます。

オーバーライド

カスタムGraphicを表示する為にはオーバーライドしてください。

以下のコードは、スプラッシュスクリーンのユーザーインターフェースをどのようにカスタマイズできるかを示しています。

{import * from CURL.ENGINE.BROWSER}
{def applet-source:String =
    {stringify
        {curl 8.0 applet}
        {import * from CURL.ENGINE.BROWSER}

        
        {define-class public CustomSplashScreenSubApplet
          {inherits SplashScreenSubApplet}
          
          {constructor public {default}
            {construct-super}
          }

          {method public open {create-main-body}:Graphic
            {return
                {VBox
                    hstretch? = true,
                    framelike-stretch? = true,
                    self.title-frame,
                    {hrule},
                    self.image-frame,
                    self.progress-bar-frame,
                    {hrule},
                    self.footer-frame
                }
            }
          }
        }

        {after 0s do
            {CustomSplashScreenSubApplet}
        }
    }
}

{CommandButton
    label = "Custom Splash Screen",
    {on Action do
        {SplashScreen.setup
            splash-applet-url = {string-url applet-source},
            title = "アプレットのロード中 ...",
            footer = "テスト例 ..."
        }
        || indeterminateなプログレスバーを表示します。
        {SplashScreen.set-progress-bar-indeterminate}
        || 作業が終わるまで2秒必要と仮定しています。
        {sleep 2s}
        {SplashScreen.set-progress-bar  max = 10.0}
        {sleep 1s}
        
        || ループに入り、ループの中でスリープし、
        || なんらかの作業をしているような状態にします。
        let val:double = 0
        {for i = 0 below 50 do
            set val = val + 0.2
            {SplashScreen.set-progress-bar-value val}    
            {sleep 0.1s}
        }
        || 完了したので、スプラッシュスクリーンを破棄します。
        {SplashScreen.destroy}
    }
}


handle-message (メソッド)
public {SplashScreenSubApplet.handle-message
message:{HashTable-of String, any}
}:void

SplashScreenオブジェクトからのメッセージを処理します。

説明

メッセージはHashTableです。ハッシュテーブルへのキーは、Stringで、それはメッセージのコードを表し、対応するのはコードに関連した値を表すany型です。 any型は、シリアライズ可能でなければなりません。そうでない場合にはエラーが発生します。
このメッセージが呼び出された時、message内の各キーワードと値毎に、SplashScreenSubApplet.handle-parameterが呼び出されます。


handle-parameter (メソッド)
public {SplashScreenSubApplet.handle-parameter
name:String,
value:any
}:void

1つのメッセージコンポーネントを表します。

説明

これは、SplashScreenSubApplet.handle-messageメソッドから呼び出されます。

オーバーライド

カスタムメッセージを処理するには、このメッセージをオーバーライドしてください。
あらかじめ定義されたメッセージが処理されるように、オーバーライドしたメソッドでsuper.handle-messageを呼び出す必要があります。


set-footer (メソッド)
public {SplashScreenSubApplet.set-footer
footer:String,
halign:any,
font-family:String,
font-size:Distance,
font-weight:any,
color:String
}:void

スプラッシュスクリーンのフッターを設定します。

footer: スプラッシュスクリーンのフッターです。
halign: nullの場合、無視されます。そうでなければ、Frame.halignで説明されている値のうちの1つでなければなりません。
font-family:
空の場合、無視されます。そうでなければ、 フッターのテキストのフォントファミリーとして設定されます。
font-familyも参照してください。
font-size:
0mの場合、無視されます。そうでなければ、フッターのフォントのサイズとして使用されます。
font-sizeも参照してください。
font-weight: nullの場合無視されます。そうでなければ、サポートされるFontWeightのうちの一つでなければなりません。
color: 空の場合、無視されます。そうでなければ、Colorを表すStringでなければなりません。

注意事項

このメソッドは、SplashScreenSubApplet.handle-parameterメソッドから呼び出されます。


set-image (メソッド)
public {SplashScreenSubApplet.set-image
u:#Url,
width:Distance,
height:Distance
}:void

スプラッシュスクリーンUIに関連したイメージを設定します。

image-url:
イメージのUrl
nullの場合、規定のイメージが使用されます。
width, height:
イメージの幅と高さ。
widthまたは、heightのいずれかが0mの場合、イメージの既定の幅と高さが使用されます。

注意事項

このメソッドは、SplashScreenSubApplet.image-frameにイメージを追加します。
このメソッドは、SplashScreenSubApplet.handle-parameterメソッドによって呼び出されます。


set-progress-bar (メソッド)
public {SplashScreenSubApplet.set-progress-bar
min:double,
max:double,
value:double
}:void

determinate状態のProgressBarを設定します。

min, max: ProgressBar の範囲。
value: ProgressBar の現在値。

注意事項

このメソッドは、まだ追加されていない場合にSplashScreenSubApplet.progress-bar-frameProgressBarを追加します。
このメソッドは、SplashScreenSubApplet.handle-parameterメソッドによって呼び出されます。


set-progress-bar-indeterminate (メソッド)
public {SplashScreenSubApplet.set-progress-bar-indeterminate
indeterminate?:bool
}:void

indeterminate状態のProgressBarを設定します。

indeterminate?: trueの場合、 ProgressBarは、indeterminateの状態になります。そうでなければ、determinateの状態になります。

注意事項

このメソッドは、まだ追加されていない場合にSplashScreenSubApplet.progress-bar-frameProgressBarを追加します。
このメソッドは、SplashScreenSubApplet.handle-parameterメソッドによって呼び出されます。


set-progress-bar-value (メソッド)
public {SplashScreenSubApplet.set-progress-bar-value value:double}:void

ProgressBarの値を設定します。

注意事項

このメソッドは、SplashScreenSubApplet.set-progress-barまたはSplashScreenSubApplet.set-progress-bar-indeterminateメソッドのいずれかを呼び出す前に、呼び出されると何も行いません。
このメソッドは、SplashScreenSubApplet.handle-parameterメソッドから呼び出されます。


set-title (メソッド)
public {SplashScreenSubApplet.set-title
title:String,
halign:any,
font-family:String,
font-size:Distance,
font-weight:any,
color:String
}:void

スプラッシュスクリーンのタイトルを設定します。

title: スプラッシュスクリーンのタイトル
halign: nullの場合、無視されます。そうでなければ、Frame.halignで説明されている値のうちの1つでなければなりません。
font-family:
空の場合、無視されます。そうでなければ、タイトルテキストのフォントファミリーとして設定されます。
font-familyも参照してください。
font-size:
0mの場合、無視されます。そうでなければ、フォントのサイズとして使用されます。
font-sizeも参照してください。
font-weight: nullの場合無視されます。そうでなければ、サポートされるFontWeightのうちの一つでなければなりません。
color: 空の場合、無視されます。そうでなければ、Colorを表すStringでなければなりません。

注意事項

このメソッドは、SplashScreenSubApplet.handle-parameterメソッドから呼び出されます。


show (メソッド)
public {SplashScreenSubApplet.show}:void

スプラッシュスクリーンViewを表示します。

注意事項

このメソッドは、ユーザーインターフェース グラフィックを取得する為に、SplashScreenSubApplet.create-main-bodyを呼び出し、フォーカスを取らずデコレーションのないViewの中に、グラフィックを表示します。またこのViewは、最上位のViewとして作成されます。
このメソッドはSplashScreenSubApplet.handle-parameterメソッドから呼び出されます。


show-after (メソッド)
public {SplashScreenSubApplet.show-after delay:Time}:void

指定された Time が経過した後に、スプラッシュスクリーンViewを表示する為に、SplashScreenSubAppletオブジェクトをセットアップします。

delay: SplashScreenSubApplet.showメソッドを呼び出した後の遅延

注意事項

このメソッドは、SplashScreenSubApplet.handle-parameterメソッドから呼び出されます。