Thông số

Các hàm truy vấn PCB được hiển thị trong hộp thoại Parameters PCB query functions shown in the Query Helper dialog
Trang tham chiếu này trình bày chi tiết các từ khóa ngôn ngữ truy vấn thuộc danh mục Parameters có sẵn trong tài liệu PCB và thư viện PCB. Để được trợ giúp về một từ khóa truy vấn cụ thể, hãy sử dụng các phần có thể thu gọn bên dưới hoặc tô sáng (hoặc nhấp vào bên trong) bất kỳ từ khóa nào trong Query Helper hoặc bảng Filter, rồi nhấn F1 để truy cập ngay đến phần tương ứng.
CompParameterValue
Tóm tắt
Trả về giá trị chuỗi của một tham số linh kiện PCB, có thể được kiểm tra để trả về các linh kiện PCB thỏa mãn truy vấn.
Cú pháp
CompParameterValue(ParameterName : String) : String
Ví dụ sử dụng
CompParameterValue('Mounting Technology') Like 'SM*'
Trả về tất cả linh kiện có chứa tham số Mounting Technology với chuỗi giá trị bắt đầu bằng SM, chẳng hạn như SMT, SMD, v.v. Các đối tượng con liên kết của một đối tượng linh kiện thỏa điều kiện, chẳng hạn như track, arc, pad, text, v.v., cũng được trả về.
CompParameterValue('Mounting Technology') Like '*SM*'
Trả về tất cả linh kiện và các đối tượng con liên kết của chúng khi tham số Mounting Technology có chuỗi giá trị chứa *SM*.
StrToNumber(CompParameterValue('VoltageRating'),V) > 50
Trả về tất cả linh kiện và các đối tượng con liên kết của chúng khi giá trị tham số VoltageRating lớn hơn 50 volt. Giá trị chuỗi do CompParameterValue trả về được chuyển đổi thành số để so sánh bằng hàm StrToNumber có nhận biết đơn vị.
FootprintParameterValue
Tóm tắt
Trả về giá trị chuỗi của một tham số Footprint PCB, có thể được kiểm tra để trả về các linh kiện PCB thỏa mãn truy vấn.
Cú pháp
FootprintParameterValue(ParameterName : String) : String
Ví dụ sử dụng
FootprintParameterValue('Mounting Type') Like 'SMD'
Trả về tất cả linh kiện và các đối tượng con liên kết của chúng khi tham số Footprint Mounting Type có chuỗi giá trị chứa SMD.
HasCompParameter
Tóm tắt
Trả về các linh kiện PCB có chứa tên tham số được chỉ định.
Cú pháp
HasCompParameter(ParameterName : String) : Boolean
Ví dụ sử dụng
HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = True
Trả về tất cả các đối tượng cha linh kiện có tên tham số Mounting Technology. Các đối tượng con liên kết của một đối tượng linh kiện thỏa điều kiện, chẳng hạn như track, arc, pad, text, v.v., cũng được trả về.
Not HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = False
Trả về tất cả linh kiện và các đối tượng con liên kết của chúng, except đối với các đối tượng cha linh kiện có tham số Mounting Technology.
HasCompParameterValue
Tóm tắt
Trả về các linh kiện PCB có chứa tên tham số được chỉ định và có giá trị thỏa mãn truy vấn.
Cú pháp
HasCompParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Ví dụ sử dụng
HasCompParameterValue('Mounting Technology','SMT')
HasCompParameterValue('Mounting Technology','SMT') = True
Trả về tất cả các đối tượng cha linh kiện có tên tham số Mounting Technology với thuộc tính giá trị khớp là SMT. Các đối tượng con liên kết của một đối tượng linh kiện thỏa điều kiện, chẳng hạn như track, arc, pad, text, v.v., cũng được trả về.
Not HasCompParameterValue('Design Item Status','RoHS-Compliant')
HasCompParameterValue('Design Item Status','RoHS-Compliant') = False
Trả về tất cả linh kiện và các đối tượng con liên kết của chúng không có tham số Design Item Status với giá trị là RoHS-Compliant.
HasFootprintParameter
Tóm tắt
Trả về các linh kiện PCB có chứa tên tham số Footprint được chỉ định.
Cú pháp
HasFootprintParameter(ParameterName : String) : Boolean
Ví dụ sử dụng
HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = True
Trả về tất cả các đối tượng cha linh kiện có tên tham số Footprint IPC Density . Các đối tượng con liên kết của một đối tượng linh kiện thỏa điều kiện, chẳng hạn như track, arc, pad, text, v.v., cũng được trả về.
Not HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = False
Trả về tất cả linh kiện và các đối tượng con liên kết của chúng, except đối với các đối tượng cha linh kiện có tham số Footprint IPC Density .
HasFootprintParameterValue
Tóm tắt
Trả về các linh kiện PCB có chứa tên tham số Footprint được chỉ định và có giá trị thỏa mãn truy vấn.
Cú pháp
HasFootprintParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Ví dụ sử dụng
HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = True
Trả về tất cả các đối tượng cha linh kiện có tên tham số Footprint Mounting Method với thuộc tính giá trị khớp là Press Fit. Các đối tượng con liên kết của một đối tượng linh kiện thỏa điều kiện, chẳng hạn như track, arc, pad, text, v.v., cũng được trả về.
Not HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = False
Trả về tất cả linh kiện và các đối tượng con liên kết của chúng không có tham số Footprint Mounting Method với giá trị là Press Fit.
HasParameter
Tóm tắt
Trả về các đối tượng PCB có chứa tên tham số được chỉ định.
Cú pháp
HasParameter(ParameterName : String) : Boolean
Ví dụ sử dụng
HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = True
Trả về tất cả đối tượng có tên tham số Mounting Technology.
Not HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = False
Trả về tất cả các đối tượng except những đối tượng có tham số Mounting Technology.
HasParameterValue
Tóm tắt
Trả về các đối tượng PCB có chứa tên tham số được chỉ định và có giá trị thỏa mãn truy vấn.
Cú pháp
HasParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Ví dụ sử dụng
HasParameterValue('Mounting Technology','SMT')
HasParameterValue('Mounting Technology','SMT') = True
Trả về tất cả đối tượng có tên tham số Mounting Technology và thuộc tính giá trị khớp là SMT.
Not HasParameterValue('Design Item Status','RoHS-Compliant')
HasParameterValue('Design Item Status','RoHS-Compliant') = False
Trả về tất cả đối tượng không có tham số Design Item Status với giá trị là RoHS-Compliant.
ParameterValue
Tóm tắt
Trả về giá trị chuỗi của một tham số đối tượng PCB, có thể được kiểm tra để trả về các đối tượng PCB thỏa mãn truy vấn.
Cú pháp
ParameterValue(ParameterName : String) : String
Ví dụ sử dụng
ParameterValue('Mounting Technology') Like 'SM*'
Trả về tất cả đối tượng có tham số Mounting Technology với chuỗi giá trị bắt đầu bằng SM, chẳng hạn như SMT, SMD, v.v.
ParameterValue('Mounting Technology') Like '*SM*'
Trả về tất cả đối tượng có tham số Mounting Technology với chuỗi giá trị chứa SM.
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Trả về tất cả đối tượng có giá trị tham số VoltageRating lớn hơn 50 volt. Giá trị chuỗi do ParameterValue trả về được chuyển đổi thành số để so sánh bằng hàm StrToNumber có nhận biết đơn vị.
StrToNumber
Tóm tắt
Chuyển đổi chuỗi giá trị tham số được chỉ định thành một số bằng cách sử dụng loại đơn vị được quy định.
Cú pháp
StrToNumber(Value : String , Unit : String) : Number
Ví dụ sử dụng
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Chuyển đổi chuỗi giá trị được trả về bởi tham số VoltageRating thành một số, sử dụng volt (V) làm đơn vị, sau đó trả về tất cả đối tượng có giá trị lớn hơn 50V.
StrToNumber(ParameterValue('Resistance'),Ohms) Between 1000 And 10000
Chuyển đổi chuỗi giá trị được trả về bởi tham số Resistance thành một số, sử dụng ohm làm đơn vị, sau đó trả về tất cả đối tượng có giá trị từ 1kΩ đến 10kΩ.
StrToNumber(ParameterValue('CapacitanceValue'),F) < 2e-9
Chuyển đổi chuỗi giá trị được trả về bởi tham số CapacitanceValue thành một số, sử dụng điện dung (F) làm đơn vị, sau đó trả về tất cả đối tượng có giá trị nhỏ hơn 2nF (2e-9 theo ký pháp khoa học).
Ghi chú
Sẽ phát sinh lỗi scripting nếu chuỗi giá trị không thể được chuyển đổi thành số. Để xử lý tình huống này, hãy sử dụng hàm StrToNumber, hàm này trả về một số mặc định được chỉ định nếu việc chuyển đổi thất bại.
Hàm chuyển đổi chuỗi sang số có nhận biết đơn vị chấp nhận một phạm vi lớn các định nghĩa loại Đơn vị, bao gồm:
- V – Điện áp
- A – Dòng điện
- Ohm – Điện trở
- Z – Trở kháng
- F – Điện dung
- H – Điện cảm
- G – Điện dẫn
- W – Công suất
- Hz – Tần số
- Q – Điện tích
- C – Nhiệt độ
- dB – Decibel
- % – Phần trăm
- m – Chiều dài
- Kg – Khối lượng
- s – Thời gian
Bộ chuyển đổi chấp nhận các hệ số tỷ lệ giá trị tiêu chuẩn (micro, kilo, mega, v.v.) và do đó hỗ trợ các chuỗi tham số chứa các chữ viết tắt tiền tố như mV, uA, kHz, v.v.
Một số cách biểu diễn giá trị khác nhau cũng được hỗ trợ. Ví dụ, cùng một giá trị điện trở có thể được biểu diễn là:
- 2k2
- 2.2k
- 2200
- 2,200
StrToNumberDef
Tóm tắt
Chuyển đổi chuỗi giá trị tham số được chỉ định thành một số, hoặc một số mặc định, bằng cách sử dụng loại đơn vị được quy định.
Cú pháp
StrToNumber(Value : String , Unit : String , Default : Number) : Number
Ví dụ sử dụng
StrToNumberDef(ParameterValue('VoltageRating'),V,10) > 50
Chuyển đổi chuỗi giá trị được trả về bởi tham số VoltageRating thành một số, sử dụng điện áp (V) làm đơn vị, sau đó trả về tất cả đối tượng có giá trị lớn hơn 50V. Nếu chuỗi tham số hoặc đơn vị không được nhận diện (không thể chuyển đổi), giá trị mặc định 10 sẽ được trả về.
StrToNumberDef(ParameterValue('VoltageRating'),'V',6) Between 10 And 50
Chuyển đổi chuỗi giá trị được trả về bởi tham số VoltageRating thành một số, sử dụng điện áp (V) làm đơn vị, sau đó trả về tất cả đối tượng có mức điện áp từ 10V đến 50V. Nếu không thể đọc giá trị, sẽ giả định điện áp là 6V (giá trị mặc định đã định nghĩa).
Ghi chú
Hàm chuyển đổi chuỗi sang số có nhận biết đơn vị chấp nhận một phạm vi lớn các định nghĩa loại Đơn vị, bao gồm:
- V – Điện áp
- A – Dòng điện
- Ohm – Điện trở
- Z – Trở kháng
- F – Điện dung
- H – Điện cảm
- G – Điện dẫn
- W – Công suất
- Hz – Tần số
- Q – Điện tích
- C – Nhiệt độ
- dB – Decibel
- % – Phần trăm
- m – Chiều dài
- Kg – Khối lượng
- s – Thời gian
Bộ chuyển đổi chấp nhận các hệ số tỷ lệ giá trị tiêu chuẩn (micro, kilo, mega, v.v.) và do đó hỗ trợ các chuỗi tham số chứa các chữ viết tắt tiền tố như mV, uA, kHz, v.v.
Một số cách biểu diễn giá trị khác nhau cũng được hỗ trợ. Ví dụ, cùng một giá trị điện trở có thể được biểu diễn là:
- 2k2
- 2.2k
- 2200
- 2,200