<Cthuvien:gchu>
Mô tả
Cthuvien:gchu là một control chuyên dùng để hiển thị nhãn ghi chú (render thẻ <span>). Ngoài việc hiển thị dòng văn bản thông thường, control này mang tính mở rộng với khả năng liên kết với một ô Checkbox biểu mẫu (qua cbkId), cũng như tự động tương thích và tạo luồng sự kiện click ghim tiêu điểm (focus) nếu tham gia kết xuất dưới dạng bảng lưới (css_G...).
Thuộc tính
Thuộc tính chung
| Tên | Kiểu | Mặc định | Có thể có | Mục đích | Thuộc tính mới | Ghi chú |
|---|---|---|---|---|---|---|
| id | string | Định danh của phần tử | ||||
| Text | string | Chứa đựng dòng text/chuỗi HTML sẽ vẽ lên giao diện | ||||
| CssClass | string | "css_gchu" | css_G... | Phân loại hiển thị | Nếu truyền vào css_G... thì auto nhúng thêm hàm GridX_click(event,'C') | |
| nhap | bool | true | true / false | Khai báo control có thuộc phạm vi kiểm tra truy xuất/nhập số liệu chuẩn hay không (C/K ở client) | Bị thiết lập tự động thành K nếu có khai báo cbkId | |
| kt_xoa | string | "X" | K: không bao giờ xóa G: dùng cho mã L: dùng cho một số thông tin liên quan mã nhưng vẫn giữ khi làm mới form X: làm mới form là xóa | Xóa khi làm mới form. Cấu hình cho việc tự làm rỗng hay bảo toàn nội dung khi ra lệnh reset form. Mặc định là bị xóa đi (X) | Bị thiết lập tự động thành K nếu có khai báo cbkId |
Chức năng
| Tên | Kiểu | Mặc định | Có thể có | Mục đích | Thuộc tính mới | Ghi chú |
|---|---|---|---|---|---|---|
| cbkId | string | ID của một control Checkbox trên trang | Biến nhãn này thành text click đại diện cho một checkbox. Khi click chuột vào nhãn ghi chú, Checkbox cấu hình sẽ bị thay đổi trạng thái | Sinh sự kiện onmousedown=form_P_cbkID('...cbkId...') trên HTML |
Khởi tạo
Quá trình render phía server (OnPreRender)
Control xử lý theo hai nhánh chính dựa trên CssClass:
Nhánh 1 — Trong lưới (CssClass bắt đầu bằng css_G):
- Gán
tenKieu = "gchu"vàten_goc = ID. - Gán
onmousedown = "GridX_click(event,'C')". - Không xử lý
nhap,kt_xoa,cbkId.
Nhánh 2 — Ngoài lưới:
- Gán
tenKieu = "gchu"vàten_goc = ID. - Nếu
cbkIdtrống:- Nếu
nhap = true, gánnhap = "C"(nếufalsekhông gán). - Gán
kt_xoatheo giá trị khai báo.
- Nếu
- Nếu
cbkIdcó giá trị:- Gán
nhap = "K"vàkt_xoa = "K". - Gán
onmousedown = "form_P_cbkID('[cbkId]');". - Nếu
CssClasstrống, gán mặc địnhcss_gchu.
- Gán
Ví dụ
Khai báo thông thường (gắn liên kết với Checkbox):
<Cthuvien:ckb ID="chkChon" runat="server" />
<Cthuvien:gchu ID="lblChon" runat="server" Text="Click vào đây để tích Checkbox" cbkId="chkChon" />
Mã HTML sinh ra (Client):
<input type="checkbox" name="ctl00$MainContent$chkChon" id="ctl00_MainContent_chkChon" ... />
<span id="ctl00_MainContent_lblChon" class="css_gchu" ten_goc="lblChon" tenKieu="gchu" nhap="K" kt_xoa="K" onmousedown="form_P_cbkID('chkChon');">Click vào đây để tích Checkbox</span>