Chuyển tới nội dung chính

<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ênKiểuMặc địnhCó thể cóMục đíchThuộc tính mớiGhi chú
idstringĐịnh danh của phần tử
TextstringChứa đựng dòng text/chuỗi HTML sẽ vẽ lên giao diện
CssClassstring"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')
nhapbooltruetrue / falseKhai 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_xoastring"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ênKiểuMặc địnhCó thể cóMục đíchThuộc tính mớiGhi chú
cbkIdstringID của một control Checkbox trên trangBiế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áiSinh 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 cbkId trống:
    • Nếu nhap = true, gán nhap = "C" (nếu false không gán).
    • Gán kt_xoa theo giá trị khai báo.
  • Nếu cbkId có giá trị:
    • Gán nhap = "K" và kt_xoa = "K".
    • Gán onmousedown = "form_P_cbkID('[cbkId]');".
    • Nếu CssClass trống, gán mặc định css_gchu.

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>