Giá trị trả về là một giá trị mà một hàm trả về tập lệnh gọi hoặc hàm khi nó hoàn thành nhiệm vụ của mình. Giá trị trả về có thể là bất kỳ một trong bốn loại biến. xử lý, số nguyên, đối tượng hoặc chuỗi. Loại giá trị mà hàm của bạn trả về phụ thuộc phần lớn vào tác vụ mà nó thực hiện
Bạn sử dụng hộp tổ hợp chỉnh sửa Hàm trả về trong trang Chung của hộp thoại Tập lệnh mới để cho JAWS biết loại giá trị mà hàm trả về. Bạn cũng nhập mô tả hàng trả lại vào hộp chỉnh sửa Mô tả hàng trả lại. Việc thêm mô tả cho kết quả trả về sẽ giúp bạn và bất kỳ ai khác đang sử dụng hàm của bạn xác định chính xác giá trị sẽ được sử dụng cho mục đích nào trong tập lệnh gọi hoặc hàm
Khi bạn tạo một hàm mới trả về một giá trị chuỗi, Trình quản lý Tập lệnh sẽ đặt dòng bắt đầu của hàm sau vào tệp tập lệnh của bạn
Hàm chuỗi MyFunction[]
Từ khóa "chuỗi" đứng trước từ khóa "hàm" cho bạn biết rằng hàm MyFunction trả về một giá trị chuỗi cho tập lệnh gọi hoặc hàm do người dùng xác định
Tuyên bố trở lại
Bạn sử dụng câu lệnh return để gửi lại giá trị cho tập lệnh gọi hoặc hàm do người dùng xác định. Từ khóa này yêu cầu JAWS trả lại giá trị đã chỉ định cho tập lệnh hoặc hàm gọi. Bạn có thể trả về giá trị dưới dạng giá trị bằng chữ hoặc trong một biến. Cú pháp của một câu lệnh trả về sẽ gửi một giá trị chuỗi được lưu trữ trong một biến có tên là sText trở lại tập lệnh gọi hoặc hàm do người dùng xác định theo sau
Trả lại sText
Một câu lệnh trả về trả về một chuỗi văn bản, "Đây là một chuỗi", theo nghĩa đen
Trả về "đây là một chuỗi"
Khi một hàm trả về một giá trị cho tập lệnh gọi hoặc hàm do người dùng xác định, bạn phải lưu trữ giá trị đó trong biến cục bộ hoặc biến toàn cục. Sau đó, bạn có thể sử dụng biến đó để đưa ra quyết định về việc tập lệnh gọi hoặc hàm do người dùng xác định sẽ thực hiện tiếp theo. Một ví dụ về lưu trữ một giá trị chuỗi được trả về bởi một hàm gọi là MyFunction trong một biến cục bộ như sau
ví dụ 1. Gán đầu ra của hàm cho một biến
Tập lệnh MyScript []
Var
Chuỗi sText
Let sText = MyFunction []; . = "" Sau đó;
If sText != "" Then; the function actually returned a value other than null or nothing
SayFormattedMessage [OT_MESSAGE, sText]
EndIf
EndScript
Bạn cũng có thể sử dụng giá trị trả về của một hàm làm tham số cho một hàm khác. Sử dụng ví dụ trước, giá trị trả về từ MyFunction có thể được chuyển trực tiếp đến hàm SayFormattedMessage mà không cần lưu trữ nó trong biến cục bộ trước. Nhược điểm duy nhất của phương pháp này là chức năng MyFunction có thể không truy xuất bất kỳ văn bản nào. Do đó, chức năng SayFormattedMessage sẽ không khiến JAWS nói bất cứ điều gì. Ví dụ được làm lại để sử dụng giá trị trả về của MyFunction làm tham số cho SayFormattedMessage như sau
ví dụ 2. Sử dụng một hàm làm tham số cho một hàm khác
Tập lệnh MyScript []
SayFormattedMessage [OT_MESSAGE, MyFunction[]];
EndScript
Một ví dụ khác về hàm do người dùng định nghĩa trả về một giá trị như sau
hàm chuỗi VerbosityLevelToggle[int iRetCurVal]
Var
int Verbosity
nếu không phải iRetCurVal thì
; update it
VerbosityLevel []
endIf
let Verbosity = GetVerbosity []
if Verbosity == 0 then
return cmsg12_L; Beginner
elif Verbosity == 1 then
return cmsg13_L; Intermediate
elif Verbosity == 2 then
return cmsg14_L; Advanced
endIf
EndFunction
Bạn có thể tìm thấy chức năng hiển thị ở trên trong tệp tập lệnh mặc định. JAWS thực hiện chức năng này mỗi khi bạn nhấn phím cách trên mục nhập "Độ chi tiết của người dùng" trong hộp thoại Điều chỉnh tùy chọn JAWS. Chức năng bắt đầu bằng cách xác định giá trị của tham số iRetCurVal. Nếu giá trị của tham số là 0 hoặc sai, thì JAWS sẽ thực hiện hàm VerbosityLevel để thay đổi mức độ chi tiết từ giá trị hiện tại sang giá trị tiếp theo. Ví dụ: nếu bạn đang sử dụng mức độ chi tiết dành cho người mới bắt đầu, thì hàm VerbosityLevel sẽ thay đổi mức độ chi tiết của bạn thành trung cấp. Tiếp theo, hàm GetVerbosity truy xuất cài đặt độ chi tiết hiện đang được sử dụng và lưu trữ nó trong biến cục bộ Độ chi tiết. Câu lệnh If sau đó xác định giá trị được lưu trữ trong biến Độ chi tiết và trả về chuỗi văn bản thích hợp để biểu thị mức độ chi tiết mới. Văn bản thực tế được lưu trữ trong Common. tệp tin nhắn jsm JAWS được tìm thấy trong thư mục cài đặt JAWS của bạn
Sẽ rất hữu ích nếu có một chức năng thực hiện một số công việc cho bạn và trả lại cho bạn kết quả của công việc đó. Sau đó, bạn có thể sử dụng kết quả theo cách bạn muốn. Trong danh sách 5. 6 bạn đã thấy hàm showSum hiển thị tổng của hai số trên bảng điều khiển. Có thể tốt hơn nếu có một chức năng thêm chỉ cần thêm các số và trả về kết quả. Trong khi showSum luôn hiển thị kết quả trên bảng điều khiển, với add, bạn có thể hiển thị kết quả mà hàm trả về nếu bạn chọn, sử dụng nó trong các phép tính tiếp theo, gửi qua mạng hoặc lưu vào cơ sở dữ liệu