Điều khiển (Tài liệu tham khảo về API máy khách)

Trong các ứng dụng dựa trên mô hình, điều khiển đại diện cho một phần tử HTML trên biểu mẫu. Một số điều khiển được liên kết với một cột cụ thể, trong khi các điều khiển khác biểu thị các điều khiển không liên kết, chẳng hạn như IFRAME, tài nguyên web hoặc lưới con được thêm vào biểu mẫu.

Đối tượng điều khiển cung cấp các phương pháp để thay đổi bản trình bày hoặc hành vi của điều khiển và xác định cột tương ứng. Điều khiển Access bằng cách sử dụng một trong các bộ sưu tập sau:

  • formContext.ui.controls
  • formContext.ui Section.controls
  • formContext.data.entityAttribute.controls

FormContext. phương pháp getControl là một phương pháp lối tắt để truy nhập formContext.ui.controls.get.

Lưu ý

Khi bạn thực hiện hành động trên các điều khiển gắn với một cột, hãy cân nhắc rằng điều khiển có thể xuất hiện trên trang nhiều lần. Thông thường, bạn nên thực hiện các hành động tương tự cho từng điều khiển cho cột. Bạn có thể di chuyển vòng lặp qua bộ sưu tập điều khiển cột và thực hiện các hành động trên từng điều khiển.

Điều khiển được phân loại theo loại. Sử dụng phương pháp getControlType để xác định loại điều khiển. Một số phương pháp điều khiển nhất định chỉ sẵn dùng cho các loại điều khiển cụ thể.

Bài viết này cung cấp thông tin về các phương pháp có sẵn cho từng loại điều khiển.

Loại điều khiển chuẩn

Những phương pháp này sẵn dùng cho điều khiển Chuẩn.

Phương pháp Mô tả
thêm Chú giải Hiển thị thông báo lỗi hoặc đề xuất với các hành động tùy chọn.
clearNotification Loại bỏ thông báo khỏi điều khiển.
getAttribute Trả về cột mà điều khiển được liên kết.
getControlType Trả về kiểu điều khiển.
getDisabled Trả về xem điều khiển có bị vô hiệu hóa hay không.
getLabel Trả về nhãn của điều khiển.
getName Trả về tên của điều khiển.
getOutputs Trả về từ điển thuộc tính đầu ra của điều khiển.
getParent Trả về phần có chứa điều khiển.
getVisible Trả về việc điều khiển có hiển thị hay không.
setDisabled Bật hoặc tắt điều khiển.
setFocus Di chuyển tiêu điểm đến điều khiển.
setLabel Thay đổi nhãn của điều khiển.
setNotification Hiển thị thông báo lỗi để cho biết dữ liệu không hợp lệ.
setVisible Hiển thị hoặc ẩn điều khiển.

Các phương pháp sau đây cho điều khiển Tiêu chuẩn bị phản đối: addOnKeyPress, fireOnKeyPress và loại bỏOnKeyPress.

Loại điều khiển IFRAME

Các phương pháp này có sẵn cho điều khiển IFRAME.

Phương pháp Mô tả
lấy Nội dung Cửa sổ Trả về cửa sổ nội dung của IFRAME hoặc tài nguyên web.
getControlType Trả về kiểu điều khiển.
getDisabled Trả về xem điều khiển có bị vô hiệu hóa hay không.
getInitialUrl Trả về URL mặc định được cấu hình cho IFRAME.
getLabel Trả về nhãn của điều khiển.
getName Trả về tên của điều khiển.
lấy Đối tượng Trả về đối tượng biểu mẫu đại diện cho IFRAME hoặc tài nguyên web.
getParent Trả về phần có chứa điều khiển.
getSrc Trả về URL hiện được hiển thị trong IFRAME hoặc tài nguyên web.
getVisible Trả về việc điều khiển có hiển thị hay không.
setDisabled Bật hoặc tắt điều khiển.
setFocus Di chuyển tiêu điểm đến điều khiển.
setLabel Thay đổi nhãn của điều khiển.
setSrc Đặt URL để hiển thị trong IFRAME hoặc tài nguyên web.
setVisible Hiển thị hoặc ẩn điều khiển.

Loại điều khiển Kbsearch (tìm kiếm cơ sở kiến thức)

Những phương pháp này có sẵn cho điều khiển tìm kiếm cơ sở kiến thức.

Phương pháp Mô tả
addOnPostSearch Thêm bộ xử lý sự kiện chạy sau khi hoàn tất tìm kiếm.
addOnResultOpened Thêm trình xử lý sự kiện chạy khi kết quả tìm kiếm mở ra.
addOnSelection Thêm bộ xử lý sự kiện chạy khi chọn kết quả tìm kiếm.
getControlType Trả về kiểu điều khiển.
getDisabled Trả về xem điều khiển có bị vô hiệu hóa hay không.
getLabel Trả về nhãn của điều khiển.
getName Trả về tên của điều khiển.
getParent Trả về phần có chứa điều khiển.
getSearchQuery Trả về văn bản được dùng làm tiêu chí tìm kiếm.
getSelectedResults Trả về kết quả tìm kiếm hiện được chọn.
getTotalResultCount Trả về số lượng kết quả tìm kiếm.
getVisible Trả về việc điều khiển có hiển thị hay không.
openSearchResult Mở kết quả tìm kiếm đã xác định.
removeOnPostSearch Loại bỏ trình xử lý sự kiện để hoàn tất tìm kiếm.
removeOnResultOpened Loại bỏ trình xử lý sự kiện để mở kết quả tìm kiếm.
removeOnSelection Loại bỏ bộ xử lý sự kiện để chọn kết quả tìm kiếm.
setFocus Di chuyển tiêu điểm đến điều khiển.
setLabel Thay đổi nhãn của điều khiển.
setSearchQuery Đặt văn bản được sử dụng làm tiêu chí tìm kiếm.
setVisible Hiển thị hoặc ẩn điều khiển.

Lưu ý

Khi bạn thêm điều khiển tìm kiếm cơ sở kiến thức vào ngăn xã hội, tên điều khiển sẽ là searchwidgetcontrol_notescontrol. Bạn không thể thay đổi tên này.

Loại điều khiển tra cứu

Những phương pháp này có sẵn cho điều khiển tra cứu.

Phương pháp Mô tả
addCustomFilter Thêm bộ lọc vào kết quả tra cứu, kết hợp với các bộ lọc hiện có bằng cách sử dụng AND.
addCustomView Thêm dạng xem vào hộp thoại tra cứu.
thêm Chú giải Hiển thị thông báo lỗi hoặc đề xuất với các hành động tùy chọn.
addOnLookupTagClick Thêm trình xử lý sự kiện chạy khi bấm thẻ tra cứu.
addPreSearch Thêm bộ xử lý sự kiện chạy trước khi tìm kiếm tra cứu.
clearNotification Loại bỏ thông báo khỏi điều khiển.
getAttribute Trả về cột mà điều khiển được liên kết.
getControlType Trả về kiểu điều khiển.
getDefaultView Trả về ID của dạng xem tra cứu mặc định.
getDisabled Trả về xem điều khiển có bị vô hiệu hóa hay không.
getEntityTypes Trả về các kiểu bảng được phép trong tra cứu.
getLabel Trả về nhãn của điều khiển.
getName Trả về tên của điều khiển.
getParent Trả về phần có chứa điều khiển.
getVisible Trả về việc điều khiển có hiển thị hay không.
removeOnLookupTagClick Loại bỏ trình xử lý sự kiện cho các lần bấm vào thẻ tra cứu.
loại bỏPreSearch Loại bỏ trình xử lý sự kiện chạy trước khi tìm kiếm tra cứu.
setDefaultView Đặt dạng xem mặc định trong hộp thoại tra cứu.
setDisabled Bật hoặc tắt điều khiển.
setEntityTypes Đặt các loại bảng được phép trong tra cứu.
setFocus Di chuyển tiêu điểm đến điều khiển.
setLabel Thay đổi nhãn của điều khiển.
setNotification Hiển thị thông báo lỗi để cho biết dữ liệu không hợp lệ.
setVisible Hiển thị hoặc ẩn điều khiển.

Các lựa chọn và loại điều khiển lựa chọn

Các lựa chọn và điều khiển lựa chọn có cùng một bộ phương pháp sẵn dùng.

Phương pháp Mô tả
thêm Chú giải Hiển thị thông báo lỗi hoặc đề xuất với các hành động tùy chọn.
thêm Tùy chọn Thêm tùy chọn vào điều khiển.
clearNotification Loại bỏ thông báo khỏi điều khiển.
clearOptions Loại bỏ tất cả các tùy chọn khỏi điều khiển.
getAttribute Trả về cột mà điều khiển được liên kết.
getControlType Trả về kiểu điều khiển.
getDisabled Trả về xem điều khiển có bị vô hiệu hóa hay không.
getLabel Trả về nhãn của điều khiển.
getName Trả về tên của điều khiển.
getOptions Trả về các tùy chọn sẵn có, bao gồm tùy chọn trống và loại trừ các tùy chọn đã loại bỏ.
getParent Trả về phần có chứa điều khiển.
getVisible Trả về việc điều khiển có hiển thị hay không.
loại bỏ Tùy chọn Loại bỏ một tùy chọn khỏi điều khiển.
setDisabled Bật hoặc tắt điều khiển.
setFocus Di chuyển tiêu điểm đến điều khiển.
setLabel Thay đổi nhãn của điều khiển.
setNotification Hiển thị thông báo lỗi để cho biết dữ liệu không hợp lệ.
setVisible Hiển thị hoặc ẩn điều khiển.

Loại điều khiển biểu mẫu nhanh

Xem formContext.ui.quickForms để biết thông tin về các phương pháp được hỗ trợ cho loại điều khiển này.

Loại điều khiển lưới con

Hãy xem Lưới và lưới con để biết thông tin về các phương pháp được hỗ trợ cho loại điều khiển này.

Loại điều khiển tường đường thời gian

Điều khiển dòng thời gian hiển thị các bài đăng, hoạt động và ghi chú trong một dạng xem thống nhất. Những phương pháp này có sẵn cho loại điều khiển này.

Phương pháp Mô tả
getControlType Trả về kiểu điều khiển.
getDisabled Trả về xem điều khiển có bị vô hiệu hóa hay không.
getLabel Trả về nhãn của điều khiển.
getName Trả về tên của điều khiển.
getParent Trả về phần có chứa điều khiển.
getVisible Trả về việc điều khiển có hiển thị hay không.
làm tươi Làm mới dữ liệu được hiển thị trong đường thời gian.
setDisabled Bật hoặc tắt điều khiển.
setFocus Di chuyển tiêu điểm đến điều khiển.
setLabel Thay đổi nhãn của điều khiển.
setVisible Hiển thị hoặc ẩn điều khiển.

Loại điều khiển hẹn giờ

Các phương pháp này có sẵn cho điều khiển hẹn giờ.

Phương pháp Mô tả
getControlType Trả về kiểu điều khiển.
getDisabled Trả về xem điều khiển có bị vô hiệu hóa hay không.
getLabel Trả về nhãn của điều khiển.
getName Trả về tên của điều khiển.
getParent Trả về phần có chứa điều khiển.
getState Trả về trạng thái hiện tại của bộ hẹn giờ.
getVisible Trả về việc điều khiển có hiển thị hay không.
làm tươi Làm mới dữ liệu được hiển thị trong bộ hẹn giờ.
setDisabled Bật hoặc tắt điều khiển.
setFocus Di chuyển tiêu điểm đến điều khiển.
setLabel Thay đổi nhãn của điều khiển.
setVisible Hiển thị hoặc ẩn điều khiển.

Loại điều khiển tài nguyên web

Điều khiển tài nguyên web có cùng một bộ phương pháp sẵn dùng với điều khiển iframe. Xem loại điều khiển iframe.

Loại điều khiển cấu phần biểu mẫu

Kiểu điều khiển cấu phần biểu mẫu có cùng một bộ phương pháp sẵn dùng với formContext trên biểu mẫu chính. Xem API Máy khách hành vi cấu > phần biểu mẫu.

Cột