kgendesignerplugin - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

kgendesignerplugin - Tạo các plugin tiện ích cho Qt (TM) Designer.

SYNOPSIS

kggendesignerplugin [LỰA CHỌN...] hồ sơ

MÔ TẢ

Các plugin tiện ích con tùy chỉnh cho Qt (TM) Designer thường tuân theo một mẫu tiêu chuẩn và
các lớp được cung cấp bởi plugin chủ yếu cung cấp thông tin tĩnh, cùng với chức năng
tạo một thể hiện mà bình thường chỉ là một lệnh gọi phương thức khởi tạo đơn giản. kggendesignerplugin
cho phép các nhà phát triển thư viện cung cấp các tiện ích con mới tạo ra một plugin như vậy mà không cần
tạo tất cả mã bảng soạn sẵn liên quan, bằng cách cung cấp mô tả kiểu ini đơn giản
tập tin.

kggendesignerplugin chọn các giá trị mặc định hợp lý cho hầu hết các cài đặt, vì vậy cấu hình tối thiểu
thường là cần thiết.

LỰA CHỌN

-o hồ sơ
Tên cho tệp C ++ được tạo. Nếu không được đưa ra, tiêu chuẩn sẽ được sử dụng.

-n tên plugin
Được cung cấp để tương thích. Giá trị mặc định cho tùy chọn PluginName trong đầu vào
tập tin.

-g nhóm
Được cung cấp để tương thích. Giá trị mặc định cho tùy chọn DefaultGroup trong đầu vào
tập tin.

--tác giả
Hiển thị thông tin tác giả.

--giấy phép
Hiển thị thông tin giấy phép.

-NS, --Cứu giúp
Hiển thị một văn bản trợ giúp ngắn gọn.

-v , --phiên bản
Hiển thị thông tin phiên bản.

FILE FORMAT

Tệp đầu vào là tệp cấu hình kiểu ini (cụ thể là ở định dạng
được hỗ trợ bởi khuôn khổ KConfig) mô tả một tập hợp các tiện ích con. Nó chứa một
[Toàn cầu], cung cấp thông tin chung về plugin và một phần cho mỗi
tiện ích con cần được bao gồm trong plugin.

Phần [Toàn cầu] có thể có các mục sau:

Nhóm mặc định
Giá trị mặc định cho Nhóm mục nhập trong các phần lớp (mặc định: "Tùy chỉnh", trừ khi
các -g tùy chọn được đưa ra).

Bao gồm
Một danh sách (được phân tách bằng dấu phẩy) bao gồm (mặc định: trống). Lưu ý rằng tiêu đề
các tệp cho các widget được chỉ định sau này trong tệp sẽ không được liệt kê ở đây; thay vào đó, cái này
dành cho các tiêu đề đặc biệt cho việc sử dụng riêng của plugin, giống như các tiêu đề cho các lớp cung cấp
các bản xem trước.

Tên plugin
Tên của lớp C ++ chính trong plugin (mặc định: "WidgetsPlugin", trừ khi -n
tùy chọn được đưa ra).

Mỗi lớp nên có [Tên lớp], có thể bao gồm phần sau
mục:

MãMẫu
Giá trị được trả về bởi hàm codeTemplate () của plugin, được đánh dấu cho
"sử dụng trong tương lai" bởi Qt (TM) Designer (mặc định: trống).

Trình xây dựngArgs
Các đối số để chuyển tới hàm tạo của lớp được ImplClass đưa ra; những thứ này phải
được bao quanh bởi dấu ngoặc đơn (mặc định: "(cha)"). Biến duy nhất được đảm bảo là
có sẵn là cha mẹ, là QWidget mẹ được Qt (TM) Designer chuyển qua.

Mục nhập này bị bỏ qua nếu CreateWidget được đặt.

TạoWidget
Mã cần thiết để tạo một phiên bản của tiện ích con (mặc định: sử dụng mã mới để tạo
phiên bản của lớp được cung cấp bởi mục nhập ImplClass, chuyển các đối số được chỉ định bởi
ConstructorArgs). Xem các ghi chú cho ImplClass và ConstructorArgs.

DomXML
Mô tả giao diện người dùng XML của tiện ích con (mặc định: mặc định được cung cấp bởi Qt (TM)
Tiêu đề plugin của nhà thiết kế).

Nhóm
Nhóm hiển thị tiện ích con trong Qt (TM) Designer (mặc định: giá trị của
Nhóm mặc định mục nhập trong phần [Toàn cầu]).

Tên biểu tượng
Tệp hình ảnh hoặc tên biểu tượng chuẩn để sử dụng làm biểu tượng cho tiện ích con này trong Qt (TM)
Danh sách tiện ích con của nhà thiết kế (mặc định: tệp PNG được đặt tên với tên phần, với bất kỳ dấu hiệu kép nào
dấu hai chấm bị xóa, trong thư mục "pics" của tệp tài nguyên đã biên dịch; Ví dụ,
: /pics/Foo.png trong phần [Foo] hoặc: /pics/FooBar.png trong phần [Foo :: Bar]).

lớp ngụ ý
Lớp sẽ được sử dụng để tạo một phiên bản của tiện ích con để sử dụng
Qt (TM) Designer (mặc định: tên phần). Lưu ý rằng điều này không thực sự phải
là lớp sẽ được tạo cho một ứng dụng cuối: được xác định bởi
DomXML.

Mục nhập này bị bỏ qua nếu CreateWidget được đặt.

Bao gồm
Tiêu đề cần được bao gồm để sử dụng tiện ích này (mặc định: chữ thường
phiên bản của tên phần, với bất kỳ dấu hai chấm nào bị xóa và thêm ".h"; Ví dụ,
foo.h trong phần [Foo] hoặc foobar.h trong phần [Foo :: Bar]).

LàContainer
Tiện ích con này có thể chứa các tiện ích con khác hay không (mặc định: false).

Chú giải công cụ
Chú giải công cụ sẽ hiển thị khi di chuột qua tiện ích con trong danh sách tiện ích con của Qt (TM)
Nhà thiết kế (mặc định: tên phần, với "Tiện ích con" được thêm vào; ví dụ: Tiện ích con Foo
trong phần [Foo]).

Đây là gì
Văn bản này là gì được liên kết với tiện ích con trong Qt (TM) Designer (mặc định:
tên phần, với "Tiện ích con" được thêm vào; ví dụ, Foo Widget trong phần [Foo]).

VÍ DỤ

Tệp mô tả đơn giản nhất có thể trông giống như

[foo]
ToolTip = Hiển thị hình ảnh
[Quán ba]
ToolTip = Trình biên tập thanh

Lưu ý rằng mỗi lớp phải có ít nhất một bộ khóa (Mẹo công cụ đã được sử dụng trong ví dụ này),
nếu không nó sẽ bị bỏ qua.

Thông thường, bạn muốn thay đổi ít nhất văn bản mà người dùng có thể nhìn thấy, có nghĩa là Mẹo công cụ,
Mục nhập WhatsThis và Nhóm. Ngoài ra, đặt tên plugin có thể là một ý tưởng hay
ngăn chặn xung đột ký hiệu có thể xảy ra và không làm nhầm lẫn trình gỡ lỗi (cả ứng dụng trình gỡ lỗi
và người thực hiện gỡ lỗi):

[Global]
PluginName = FooWidgets
DefaultGroup = Hiển thị

[foo]
ToolTip = Hiển thị gấu
WhatsThis = Một tiện ích hình ảnh hiển thị những con gấu đang nhảy múa

[Quán ba]
ToolTip = Trình biên tập thanh
WhatsThis = Một giao diện biên tập viên cho các quán bar dành cho gấu
Nhóm = Chỉnh sửa

Các tệp phức tạp hơn có thể cần thiết nếu bạn có các lớp không gian tên hoặc các tùy chọn bổ sung
cần cung cấp cho các nhà xây dựng, ví dụ:

[Global]
PluginName = FooWidgets
DefaultGroup = Foo

[Foo :: Bar]
ToolTip = Hiển thị các thanh
WhatsThis = Một tiện ích hiển thị các thanh theo một cách cụ thể
IncludeFile = foo / bar.h
IconName =: / previews / bar.png

[Foo :: Baz]
IncludeFile = foo / baz.h
ConstructorArgs = (Foo :: Baz :: SomeOption, cha)
Nhóm = Foo (Đặc biệt)
IsContainer = true
IconName =: / previews / baz.png

Đôi khi các tiện ích con đặc biệt phức tạp có thể cần triển khai "lớp xem trước" đặc biệt
để sử dụng trong Qt (TM) Designer; đây có thể là một lớp con của tiện ích con thực sự
một số thiết lập bổ sung hoặc nó có thể là một triển khai hoàn toàn khác.

[Global]
Bao gồm = foopreviews.h

[Tiện ích ưa thích]
ImplClass = FancyWidgetPreview

Sử dụng kgendesignerplugin trực tuyến bằng các dịch vụ onworks.net