kgendesignerplugin - ອອນລາຍໃນຄລາວ

ໂຄງການ:

NAME

kgendesignerplugin - ສ້າງ widget plugins ສໍາລັບ Qt(TM) Designer.

ສະຫຼຸບສັງລວມ

kgendesignerplugin [OPTIONS... ] ເອກະສານ

ລາຍລະອຽດ

plugins widget ທີ່ກໍາຫນົດເອງສໍາລັບ Qt(TM) Designer ປົກກະຕິແລ້ວປະຕິບັດຕາມຮູບແບບມາດຕະຖານ, ແລະ
ຫ້ອງຮຽນສະຫນອງໃຫ້ໂດຍ plugin ສ່ວນຫຼາຍແມ່ນສະຫນອງຂໍ້ມູນສະຖິດ, ພ້ອມກັບຫນ້າທີ່
ສ້າງຕົວຢ່າງທີ່ປົກກະຕິແມ່ນພຽງແຕ່ການໂທ constructor ງ່າຍດາຍ. kgendesignerplugin
ອະນຸຍາດໃຫ້ນັກພັດທະນາຫ້ອງສະຫມຸດທີ່ສະຫນອງ widget ໃຫມ່ເພື່ອສ້າງ plugin ດັ່ງກ່າວໂດຍບໍ່ມີການ
ການສ້າງລະຫັດ boilerplate ທີ່ກ່ຽວຂ້ອງທັງຫມົດ, ໂດຍການສະຫນອງຄໍາອະທິບາຍແບບ ini ແບບງ່າຍດາຍ
ຍື່ນ.

kgendesignerplugin ເລືອກຄ່າເລີ່ມຕົ້ນທີ່ເໝາະສົມສຳລັບການຕັ້ງຄ່າສ່ວນໃຫຍ່, ສະນັ້ນການກຳນົດຄ່າໜ້ອຍທີ່ສຸດ
ປົກກະຕິແລ້ວແມ່ນມີຄວາມຈໍາເປັນ.

OPTIONS

-o ເອກະສານ
ຊື່ສໍາລັບໄຟລ໌ C++ ທີ່ສ້າງຂຶ້ນ. ຖ້າບໍ່ໃຫ້, stdout ຈະຖືກນໍາໃຊ້.

-n plugin-name
ສະຫນອງໃຫ້ເຂົ້າກັນໄດ້. ຄ່າເລີ່ມຕົ້ນສໍາລັບຕົວເລືອກ PluginName ໃນການປ້ອນຂໍ້ມູນ
ຍື່ນ.

-g ກຸ່ມ
ສະຫນອງໃຫ້ເຂົ້າກັນໄດ້. ຄ່າເລີ່ມຕົ້ນສໍາລັບຕົວເລືອກ DefaultGroup ໃນການປ້ອນຂໍ້ມູນ
ຍື່ນ.

--ຜູ້ຂຽນ
ສະແດງຂໍ້ມູນຜູ້ຂຽນ.

-- ໃບ​ອະ​ນຸ​ຍາດ​
ສະແດງຂໍ້ມູນໃບອະນຸຍາດ.

-ຊ, - ຊ່ວຍ
ສະແດງຂໍ້ຄວາມຊ່ວຍເຫຼືອສັ້ນໆ.

-v , - ການປ່ຽນແປງ
ສະແດງຂໍ້ມູນສະບັບ.

ເອກະສານ ຮູບແບບ

ໄຟລ໌ປ້ອນຂໍ້ມູນແມ່ນໄຟລ໌ການຕັ້ງຄ່າແບບ ini (ໂດຍສະເພາະ, ມັນແມ່ນຢູ່ໃນຮູບແບບ
ສະຫນັບສະຫນູນໂດຍ KConfig framework) ທີ່ອະທິບາຍຊຸດຂອງ widget. ມັນປະກອບດ້ວຍ a
[ທົ່ວໂລກ] ພາກ, ການສະຫນອງຂໍ້ມູນທົ່ວໄປກ່ຽວກັບ plugin, ແລະພາກສ່ວນສໍາລັບແຕ່ລະຄົນ
widget ທີ່ຄວນຈະຖືກລວມຢູ່ໃນ plugin.

ພາກສ່ວນ [ທົ່ວໂລກ] ສາມາດມີລາຍການຕໍ່ໄປນີ້:

DefaultGroup
ຄ່າເລີ່ມຕົ້ນຂອງ ກຸ່ມ ເຂົ້າຢູ່ໃນພາກສ່ວນຂອງຫ້ອງຮຽນ (ຄ່າເລີ່ມຕົ້ນ: "Custom", ເວັ້ນເສຍແຕ່
ໄດ້ -g ທາງ​ເລືອກ​ແມ່ນ​ໄດ້​ຮັບ​)​.

ລວມມີ
ລາຍຊື່ທີ່ຕ້ອງການ (ຂັ້ນດ້ວຍເຄື່ອງໝາຍຈຸດ) ລວມມີ (ຄ່າເລີ່ມຕົ້ນ: ຫວ່າງເປົ່າ). ໃຫ້ສັງເກດວ່າຫົວ
ໄຟລ໌ສໍາລັບ widget ທີ່ລະບຸໄວ້ຕໍ່ມາໃນໄຟລ໌ບໍ່ຄວນຖືກສະແດງຢູ່ທີ່ນີ້; ແທນທີ່ຈະ, ນີ້
ແມ່ນສໍາລັບສ່ວນຫົວພິເສດສໍາລັບການນໍາໃຊ້ຂອງຕົນເອງຂອງ plugin, ເຊັ່ນວ່າສໍາລັບຫ້ອງຮຽນສະຫນອງ
ຕົວຢ່າງ.

PluginName
ຊື່ຂອງຊັ້ນ C ++ ຕົ້ນຕໍໃນ plugin (ຄ່າເລີ່ມຕົ້ນ: "WidgetsPlugin", ເວັ້ນເສຍແຕ່ວ່າ -n
ທາງ​ເລືອກ​ແມ່ນ​ໄດ້​ຮັບ​)​.

ແຕ່ລະຫ້ອງຮຽນຄວນມີຂອງຕົນເອງ [ຊື່ຫ້ອງຮຽນ] ພາກ, ຊຶ່ງສາມາດປະກອບມີດັ່ງຕໍ່ໄປນີ້
ລາຍການ:

ແມ່ແບບລະຫັດ
ຄ່າທີ່ສົ່ງຄືນໂດຍຟັງຊັນ codeTemplate() ຂອງ plugin, ເຊິ່ງຖືກໝາຍໄວ້
"ການນໍາໃຊ້ໃນອະນາຄົດ" ໂດຍ Qt(TM) Designer (ຄ່າເລີ່ມຕົ້ນ: ຫວ່າງເປົ່າ).

ConstructorArgs
ການໂຕ້ຖຽງທີ່ຈະຜ່ານໄປຫາຜູ້ກໍ່ສ້າງຂອງຊັ້ນຮຽນທີ່ໃຫ້ໂດຍ ImplClass; ເຫຼົ່ານີ້ຕ້ອງ
ຖືກອ້ອມຮອບດ້ວຍວົງເລັບ (ຄ່າເລີ່ມຕົ້ນ: "(ພໍ່ແມ່)"). ຕົວແປພຽງແຕ່ຮັບປະກັນທີ່ຈະເປັນ
ມີແມ່ນ ພໍ່ແມ່, ຊຶ່ງເປັນ QWidget ພໍ່ແມ່ຜ່ານໂດຍ Qt(TM) Designer.

ລາຍການນີ້ຖືກລະເລີຍຖ້າ CreateWidget ຖືກຕັ້ງ.

ສ້າງWidget
ລະຫັດທີ່ຈໍາເປັນເພື່ອສ້າງຕົວຢ່າງຂອງ widget (ຄ່າເລີ່ມຕົ້ນ: ໃຊ້ໃຫມ່ເພື່ອສ້າງ
ຕົວຢ່າງຂອງຊັ້ນທີ່ໃຫ້ໂດຍການເຂົ້າ ImplClass, ຖ່າຍທອດການໂຕ້ຖຽງທີ່ລະບຸໄວ້ໂດຍ
ConstructorArgs). ເບິ່ງບັນທຶກສໍາລັບ ImplClass ແລະ ConstructorArgs.

DomXML
ລາຍລະອຽດ XML UI ຂອງ widget (ຄ່າເລີ່ມຕົ້ນ: ຄ່າເລີ່ມຕົ້ນທີ່ສະໜອງໃຫ້ໂດຍ Qt(TM)
ຜູ້ອອກແບບສ່ວນຫົວ plugin).

ກຸ່ມ
ກຸ່ມທີ່ຈະສະແດງ widget ພາຍໃຕ້ໃນ Qt(TM) Designer (ຄ່າເລີ່ມຕົ້ນ: ຄ່າຂອງ
DefaultGroup ເຂົ້າຢູ່ໃນພາກ [ທົ່ວໂລກ]).

ຊື່ໄອຄອນ
ໄຟລ໌ຮູບພາບ ຫຼືຊື່ໄອຄອນມາດຕະຖານເພື່ອໃຊ້ເປັນໄອຄອນສຳລັບວິດເຈັດນີ້ໃນ Qt(TM)
ລາຍຊື່ widget ຂອງຜູ້ອອກແບບ (ຄ່າເລີ່ມຕົ້ນ: ໄຟລ໌ PNG ທີ່ມີຊື່ທີ່ມີຊື່ພາກ, ມີສອງເທົ່າ
colons ຖືກລຶບອອກ, ໃນ "pics" directory ຂອງໄຟລ໌ຊັບພະຍາກອນທີ່ລວບລວມ; ຍົກ​ຕົວ​ຢ່າງ,
:/pics/Foo.png ໃນພາກ [Foo], ຫຼື :/pics/FooBar.png ໃນພາກ [Foo::Bar]).

ImplClass
ຫ້ອງຮຽນທີ່ຄວນຈະຖືກນໍາໃຊ້ເພື່ອສ້າງຕົວຢ່າງຂອງ widget ສໍາລັບການນໍາໃຊ້
Qt(TM) ຜູ້ອອກແບບ (ຄ່າເລີ່ມຕົ້ນ: ຊື່ພາກສ່ວນ). ໃຫ້ສັງເກດວ່ານີ້ບໍ່ແມ່ນຕົວຈິງແລ້ວ
ເປັນຫ້ອງຮຽນທີ່ຈະສ້າງສໍາລັບຄໍາຮ້ອງສະຫມັກສິ້ນສຸດ: ທີ່ຖືກກໍານົດໂດຍ
DomXML.

ລາຍການນີ້ຖືກລະເລີຍຖ້າ CreateWidget ຖືກຕັ້ງ.

ລວມໄຟລ໌
ສ່ວນຫົວທີ່ຕ້ອງຖືກລວມເຂົ້າເພື່ອໃຊ້ widget ນີ້ (ຄ່າເລີ່ມຕົ້ນ: ຕົວພິມນ້ອຍ
ເວີຊັນຂອງຊື່ພາກສ່ວນ, ດ້ວຍການເອົາຈໍ້າສອງເມັດອອກ ແລະ ".h" ຕໍ່ທ້າຍ; ຍົກ​ຕົວ​ຢ່າງ,
foo.h ໃນພາກ [Foo], ຫຼື foobar.h ໃນພາກ [Foo::Bar]).

IsContainer
widget ນີ້ສາມາດບັນຈຸ widget ອື່ນໆໄດ້ບໍ່ (ຄ່າເລີ່ມຕົ້ນ: false).

ຄຳແນະນຳ
ຄໍາແນະນໍາເຄື່ອງມືທີ່ຈະສະແດງໃນເວລາທີ່ເລື່ອນຢູ່ເທິງ widget ໃນບັນຊີລາຍຊື່ widget ຂອງ Qt(TM)
ຜູ້ອອກແບບ (ຄ່າເລີ່ມຕົ້ນ: ຊື່ພາກສ່ວນ, ໂດຍມີ "Widget" ຕໍ່ທ້າຍ; ຕົວຢ່າງ, Foo Widget
ໃນພາກ [Foo]).

ນີ້​ແມ່ນ​ຫຍັງ
ຂໍ້ຄວາມນີ້ແມ່ນຫຍັງທີ່ກ່ຽວຂ້ອງກັບ widget ໃນ Qt(TM) Designer (ຄ່າເລີ່ມຕົ້ນ: the
ຊື່ພາກ, ດ້ວຍ "Widget" ຕໍ່ທ້າຍ; ຕົວຢ່າງ, Foo Widget ໃນພາກ [Foo]).

ຕົວຢ່າງ

ໄຟລ໌ຄໍາອະທິບາຍທີ່ງ່າຍດາຍທີ່ສຸດອາດຈະເບິ່ງຄືວ່າ

[Foo]
ToolTip=ສະແດງ foos
[ບາ]
ToolTip=Bar editor

ໃຫ້ສັງເກດວ່າແຕ່ລະຫ້ອງຮຽນຕ້ອງມີຢ່າງຫນ້ອຍຫນຶ່ງຊຸດທີ່ສໍາຄັນ (ToolTip ຖືກນໍາໃຊ້ໃນຕົວຢ່າງນີ້),
ຖ້າບໍ່ດັ່ງນັ້ນມັນຈະຖືກລະເລີຍ.

ໂດຍປົກກະຕິແລ້ວ, ທ່ານຕ້ອງການປ່ຽນຢ່າງນ້ອຍຂໍ້ຄວາມທີ່ຜູ້ໃຊ້ເຫັນໄດ້, ຊຶ່ງຫມາຍຄວາມວ່າ ToolTip,
WhatsThis ແລະລາຍການກຸ່ມ. ນອກຈາກນັ້ນ, ການຕັ້ງຄ່າຊື່ plugin ສາມາດເປັນຄວາມຄິດທີ່ດີທີ່ຈະ
ປ້ອງກັນການປະທະກັນຂອງສັນຍາລັກທີ່ເປັນໄປໄດ້ ແລະບໍ່ສັບສົນຕົວດີບັກ (ທັງສອງແອັບພລິເຄຊັນດີບັກ
ແລະ​ຜູ້​ທີ່​ເຮັດ​ການ debugging):

[ທົ່ວໂລກ]
PluginName=FooWidgets
DefaultGroup=ສະແດງຜົນ

[Foo]
ToolTip=ສະແດງໝີ
WhatsThis=ວິດເຈັດຮູບພາບທີ່ສະແດງຫມີເຕັ້ນ

[ບາ]
ToolTip=Bar editor
WhatsThis=ຕົວໂຕ້ຕອບບັນນາທິການສຳລັບແຖບສຳລັບໝີ
ກຸ່ມ=ແກ້ໄຂ

ໄຟລ໌ທີ່ສັບສົນຫຼາຍອາດຈະມີຄວາມຈໍາເປັນຖ້າຫາກວ່າທ່ານມີຫ້ອງຮຽນ namespaced ຫຼືທາງເລືອກພິເສດທີ່
ຕ້ອງການສະຫນອງໃຫ້ແກ່ຜູ້ກໍ່ສ້າງ, ສໍາລັບຕົວຢ່າງ:

[ທົ່ວໂລກ]
PluginName=FooWidgets
DefaultGroup=Foo

[Foo::Bar]
ToolTip=ສະແດງແຖບ
WhatsThis=ວິດເຈັດທີ່ສະແດງແຖບໃນລັກສະນະສະເພາະ
IncludeFile=foo/bar.h
IconName=:/previews/bar.png

[Foo::Baz]
IncludeFile=foo/baz.h
ConstructorArgs=(Foo::Baz::SomeOption, ພໍ່ແມ່)
Group=Foo (ພິເສດ)
IsContainer=ຈິງ
IconName=:/previews/baz.png

ບາງຄັ້ງ widgets ສະລັບສັບຊ້ອນໂດຍສະເພາະອາດຈະຕ້ອງການການປະຕິບັດ "ຫ້ອງສະແດງຕົວຢ່າງ" ພິເສດ
ສໍາລັບການນໍາໃຊ້ໃນ Qt(TM) Designer; ນີ້ອາດຈະເປັນ subclass ຂອງ widget ທີ່ແທ້ຈິງທີ່ພຽງແຕ່ເຮັດ
ບາງການຕັ້ງຄ່າພິເສດ, ຫຼືມັນອາດຈະເປັນການຈັດຕັ້ງປະຕິບັດທີ່ແຕກຕ່າງກັນຫມົດ.

[ທົ່ວໂລກ]
ລວມ=foopreviews.h

[FancyWidget]
ImplClass=FancyWidgetPreview

ໃຊ້ kgendesignerplugin ອອນລາຍໂດຍໃຊ້ບໍລິການ onworks.net