Class Browser

Trình duyệt

Lớp này cung cấp quyền truy cập vào các hộp thoại dành riêng cho Google Trang tính.

Bạn chỉ có thể sử dụng các phương thức trong lớp này trong bối cảnh của một Bảng tính Google. Thay vào đó, vui lòng sử dụng hộp thoại Google Workspace.

Xem thêm

Thuộc tính

Thuộc tínhLoạiMô tả
ButtonsButtonSet

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
inputBox(prompt)String|nullHiển thị một hộp thoại có hộp nhập văn bản trong trình duyệt của người dùng.
inputBox(prompt, buttons)String|nullHiển thị một hộp thoại có hộp nhập văn bản trong trình duyệt của người dùng.
inputBox(title, prompt, buttons)String|nullHiển thị một hộp thoại có hộp nhập văn bản trong trình duyệt của người dùng.
msgBox(prompt)String|nullHiển thị một hộp thoại có thông báo đã cho và nút OK trong trình duyệt của người dùng.
msgBox(prompt, buttons)String|nullMở một hộp thoại có thông báo đã cho và các nút được chỉ định trong trình duyệt của người dùng.
msgBox(title, prompt, buttons)String|nullHiển thị một hộp thoại có tiêu đề, thông báo và các nút đã chỉ định trong trình duyệt của người dùng.

Tài liệu chi tiết

inputBox(prompt)

Hiển thị một hộp thoại có hộp nhập văn bản trong trình duyệt của người dùng.

Phương thức inputBox sẽ tạo một hộp nhập liệu phía máy khách hiển thị lời nhắc đã cho cho người dùng. Xin lưu ý rằng hàm này khiến tập lệnh phía máy chủ bị tạm ngưng. Thao tác này sẽ tự động tiếp tục sau khi người dùng đóng hộp thoại, nhưng các kết nối JDBC sẽ không duy trì trong quá trình tạm ngưng.

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox('Enter your name');
Bạn không nên sử dụng phương thức này. Thay vào đó, hãy sử dụng lời nhắc trên giao diện người dùng.

Thông số

TênLoạiMô tả
promptStringVăn bản sẽ xuất hiện trong hộp thoại.

Cầu thủ trả bóng

String|null – Văn bản do người dùng nhập (hoặc "cancel" cho hộp thoại bị huỷ hoặc bị đóng).

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

inputBox(prompt, buttons)

Hiển thị một hộp thoại có hộp nhập văn bản trong trình duyệt của người dùng.

Phương thức inputBox sẽ tạo một hộp nhập liệu phía máy khách, hiển thị lời nhắc đã cho cho người dùng và cung cấp lựa chọn về các nút sẽ hiển thị. Xin lưu ý rằng hàm này khiến tập lệnh phía máy chủ bị tạm ngưng. Nó sẽ tự động tiếp tục sau khi người dùng đóng hộp thoại, nhưng các kết nối JDBC sẽ không duy trì trong suốt quá trình tạm ngưng.

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox('Enter your name', Browser.Buttons.OK_CANCEL);
Bạn không nên sử dụng phương thức này. Thay vào đó, hãy sử dụng lời nhắc trên giao diện người dùng.

Thông số

TênLoạiMô tả
promptStringVăn bản sẽ xuất hiện trong hộp thoại.
buttonsButtonSetLoại nút sẽ sử dụng.

Cầu thủ trả bóng

String|null – Văn bản do người dùng nhập (hoặc "cancel" cho hộp thoại bị huỷ hoặc bị đóng).

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

inputBox(title, prompt, buttons)

Hiển thị một hộp thoại có hộp nhập văn bản trong trình duyệt của người dùng.

Phương thức inputBox sẽ tạo một hộp nhập phía máy khách có tiêu đề đã cho, hiển thị lời nhắc đã cho cho người dùng và cung cấp lựa chọn về các nút sẽ hiển thị. Xin lưu ý rằng hàm này khiến tập lệnh phía máy chủ bị tạm ngưng. Nó sẽ tự động tiếp tục sau khi người dùng đóng hộp thoại, nhưng các kết nối JDBC sẽ không duy trì trong quá trình tạm ngưng.

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox(
    'ID Check',
    'Enter your name',
    Browser.Buttons.OK_CANCEL,
);
Bạn không nên sử dụng phương thức này. Thay vào đó, hãy sử dụng lời nhắc trên giao diện người dùng.

Thông số

TênLoạiMô tả
titleStringTiêu đề của hộp thoại.
promptStringVăn bản sẽ xuất hiện trong hộp thoại.
buttonsButtonSetLoại nút sẽ sử dụng.

Cầu thủ trả bóng

String|null – Văn bản do người dùng nhập (hoặc "cancel" cho hộp thoại bị huỷ hoặc bị đóng).

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

msgBox(prompt)

Hiển thị một hộp thoại có thông báo đã cho và nút OK trong trình duyệt của người dùng.

Phương thức msgBox tạo ra một hộp thông báo phía máy khách, hiển thị thông báo đã cho cho người dùng. Xin lưu ý rằng phương thức này khiến tập lệnh phía máy chủ bị tạm ngưng. Thao tác này sẽ tự động tiếp tục sau khi người dùng đóng hộp thoại, nhưng các kết nối JDBC sẽ không duy trì trong quá trình tạm ngưng.

// The code below displays "hello world" in a dialog box with an OK button
Browser.msgBox('hello world');
Bạn không nên sử dụng phương thức này. Thay vào đó, hãy dùng hộp thoại cảnh báo trên giao diện người dùng.

Thông số

TênLoạiMô tả
promptStringVăn bản sẽ xuất hiện trong hộp thoại.

Cầu thủ trả bóng

String|null – Văn bản chữ thường của nút mà người dùng nhấp vào (hoặc "cancel" cho hộp thoại bị đóng).

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

msgBox(prompt, buttons)

Mở một hộp thoại có thông báo đã cho và các nút được chỉ định trong trình duyệt của người dùng.

Phương thức msgBox tạo ra một hộp thông báo phía máy khách, hiển thị thông báo đã cho cho người dùng và cung cấp lựa chọn về các nút sẽ hiển thị. Xin lưu ý rằng phương pháp này khiến tập lệnh phía máy chủ bị tạm ngưng. Nó sẽ tự động tiếp tục sau khi người dùng đóng hộp thoại, nhưng các kết nối JDBC sẽ không duy trì trong suốt quá trình tạm ngưng.

// The code below displays "hello world" in a dialog box with OK and Cancel
// buttons.
Browser.msgBox('hello world', Browser.Buttons.OK_CANCEL);
Bạn không nên sử dụng phương thức này. Thay vào đó, hãy dùng hộp thoại cảnh báo trên giao diện người dùng.

Thông số

TênLoạiMô tả
promptStringVăn bản sẽ xuất hiện trong hộp thoại.
buttonsButtonSetLoại nút sẽ sử dụng.

Cầu thủ trả bóng

String|null – Văn bản chữ thường của nút mà người dùng nhấp vào (hoặc "cancel" cho hộp thoại bị đóng).

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

msgBox(title, prompt, buttons)

Hiển thị một hộp thoại có tiêu đề, thông báo và các nút đã chỉ định trong trình duyệt của người dùng.

Phương thức msgBox sẽ tạo một hộp thông báo phía máy khách có tiêu đề đã cho, hiển thị thông báo đã cho cho người dùng và cung cấp lựa chọn về các nút sẽ hiển thị. Xin lưu ý rằng phương thức này khiến tập lệnh phía máy chủ bị tạm ngưng. Nó sẽ tự động tiếp tục sau khi người dùng đóng hộp thoại, nhưng các kết nối JDBC sẽ không duy trì trong quá trình tạm ngưng.

// The code below displays "hello world" in a dialog box with a custom title and
// Yes and No buttons
Browser.msgBox('Greetings', 'hello world', Browser.Buttons.YES_NO);
Bạn không nên sử dụng phương thức này. Thay vào đó, hãy dùng hộp thoại cảnh báo trên giao diện người dùng.

Thông số

TênLoạiMô tả
titleStringTiêu đề của hộp thoại.
promptStringVăn bản sẽ xuất hiện trong hộp thoại.
buttonsButtonSetLoại nút sẽ sử dụng.

Cầu thủ trả bóng

String|null – Văn bản chữ thường của nút mà người dùng nhấp vào (hoặc "cancel" cho hộp thoại bị đóng).

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets