Futurebasic/語言/參考/滾動按鈕

滾動按鈕

語法

SCROLL BUTTON [#]idExpr ¬
  [,[current][,[min][,[max][,[page][,[rect][,type]]]]]]

描述

SCROLL BUTTON 語句在當前輸出視窗中放置一個新的捲軸，或更改現有捲軸的特性。引數解釋如下

"影像在此處"

建立新的捲軸

• 選擇一個 idExpr 值，使得 ABS(idExpr) 與視窗中所有現有按鈕和捲軸的 ID 不同。如果您使用負數 idExpr，並且視窗包含一個多樣式非靜態編輯欄位，其 ID 號為 ABS(idExpr)，那麼捲軸的動作將連結到該編輯欄位（下面解釋）。
• 為 current、min、max 和 page 選擇初始值。所有這些引數都是可選的；任何被省略的引數都將具有以下預設初始值
  • current = 0
  • min = 0
  • max = 255
  • page = 16
• 如果建立 _scrollOther 捲軸，請指定 rect 引數。如果您建立的是 _scrollVert 或 _scrollHorz 捲軸，則此引數是可選的。
• 指定型別。此引數是可選的；它的預設值為 _scrollOther。

修改現有捲軸

• 將 idExpr 設定為視窗中現有捲軸的 ID 號。
• 如果您要更改任何 current、min、max 或 page 值，請指定相應的引數。任何被省略的引數都不會更改其值。
• 如果您要更改 _scrollOther 捲軸的矩形，請在 rect 引數中指定新的矩形。如果您省略此引數，矩形將不會更改。注意：當您更改 _scrollVert 或 _scrollHorz 捲軸時，rect 引數將被忽略。
• 您無法更改現有捲軸的型別。如果捲軸已經存在，則此引數將被忽略。

啟用或停用捲軸

您可以使用 BUTTON 語句啟用（突出顯示）或停用（變暗）現有捲軸。

• 要啟用它，請使用：BUTTON scrollbarID, _activeBtn
• 要停用它，請使用：BUTTON scrollbarID, _grayBtn

將捲軸的操作連結到編輯欄位

如果您在建立新捲軸時指定了負數 idExpr 值，FB 會在當前視窗中查詢一個 ID 號等於 ABS(idExpr) 的多樣式編輯欄位（可以是靜態的）。如果找到這樣的欄位，則捲軸和編輯欄位的行為將連結在一起，如下所示

• 當用戶（或您的程式）移動捲軸滑塊時，編輯欄位中的文字會垂直滾動；
• 當用戶（或您的程式）更改欄位中的文字，或垂直拖動它時，捲軸滑塊會相應地移動。

將捲軸連結到編輯欄位時，建議使用垂直捲軸。水平捲軸不會水平滾動文字，它的動作可能看起來很奇怪。

您無法更改連結到編輯欄位的捲軸的 current、min 或 max 引數。這些值會隨著欄位中文字內容和位置的改變而動態地自動更改。此外，您不能使用 BUTTON 語句來啟用或停用這種捲軸；當編輯欄位包含比檢視矩形中可容納的更多的行時，捲軸處於活動狀態，否則處於非活動狀態。

注意：要將捲軸連結到編輯欄位，您必須先建立編輯欄位，然後建立捲軸。

注意：您只能將捲軸連結到多樣式編輯欄位（使用負數 idExpr 值建立的欄位）。

使用捲軸

為了使捲軸可以使用，您的程式必須定期呼叫 HANDLEEVENTS。除了其他事情之外，HANDLEEVENTS 會跟蹤捲軸中滑鼠的運動和點選，並響應這些使用者操作移動滑塊。您的程式還可以透過在 SCROLL BUTTON 語句中設定 current 引數來顯式地移動滑塊。

每當使用者移動滑塊時，都會生成一個型別為 _btnClick 的對話方塊事件。此事件的“id”值等於捲軸的 ID。您可以使用 BUTTON 函式確定滑塊的當前位置

thumbPosition = BUTTON(scrollBarID)

注意

要刪除捲軸，請使用 BUTTON CLOSE 語句

BUTTON CLOSE scrollBarID

要了解有關捲軸的資訊，請使用 BUTTON& 函式獲取捲軸的控制記錄。

另見

BUTTON& BUTTON 函式；BUTTON 語句；EDIT FIELD；DIALOG 函式