kgendesignerplugin - מקוון בענן

תָכְנִית:

שֵׁם

kgendesignerplugin - יוצר תוספים של ווידג'טים עבור Qt(TM) Designer.

תַקצִיר

plugin kgendesigner [אפשרויות...] פילה

תיאור

תוספי הווידג'טים המותאמים אישית עבור Qt(TM) Designer בדרך כלל עוקבים אחר דפוס סטנדרטי, וה-
מחלקות המסופקות על ידי התוסף מספקות בעיקר מידע סטטי, יחד עם פונקציה ל
צור מופע שהוא בדרך כלל רק קריאת קונסטרוקטור פשוטה. plugin kgendesigner
מאפשר למפתחים של ספריות המספקות ווידג'טים חדשים ליצור תוסף כזה בלעדיו
יצירת כל קוד ה-boilerplate המשויך, על ידי מתן תיאור פשוט בסגנון ini
קובץ.

plugin kgendesigner בוחר ברירת מחדל הגיונית עבור רוב ההגדרות, כך שתצורה מינימלית
הוא בדרך כלל הכרחי.

אפשרויות

-o פילה
השם לקובץ C++ שנוצר. אם לא ניתן, stdout יהיה בשימוש.

-n שם תוסף
מסופק עבור תאימות. ערך ברירת המחדל עבור אפשרות PluginName בקלט
קובץ.

-g קבוצה
מסופק עבור תאימות. ערך ברירת המחדל עבור אפשרות DefaultGroup בקלט
קובץ.

--מְחַבֵּר
הצג מידע על המחבר.

--רישיון
הצג פרטי רישיון.

-ח, - עזרה
הצג טקסט עזרה קצר.

-v , --גִרְסָה
הצג מידע על גרסה.

קובץ פורמט

קובץ הקלט הוא קובץ תצורה בסגנון איני (באופן ספציפי, הוא בפורמט
נתמך על ידי מסגרת KConfig) המתארת ​​קבוצה של ווידג'טים. הוא מכיל א
קטע [גלובלי] המספק מידע כללי על התוסף וקטע לכל אחד מהם
יישומון שאמור להיכלל בתוסף.

הקטע [גלובלי] יכול לכלול את הערכים הבאים:

קבוצת ברירת מחדל
ערך ברירת המחדל עבור קְבוּצָה ערך בקטעי הכיתה (ברירת מחדל: "מותאם אישית", אלא אם כן
מה היא -g ניתנת אפשרות).

כולל
רשימה (מופרדת בפסיק) של חובה כוללת (ברירת מחדל: ריקה). שימו לב שהכותרת
אין לרשום כאן קבצים עבור הווידג'טים שצוינו מאוחר יותר בקובץ; במקום זאת, זה
מיועד לכותרות מיוחדות לשימוש עצמי של התוסף, כמו אלו למתן שיעורים
תצוגות מקדימות.

שם תוסף
שם המחלקה הראשית של C++ בתוסף (ברירת המחדל: "WidgetsPlugin", אלא אם כן -n
ניתנת אפשרות).

לכל כיתה צריכה להיות [שם הכיתה] סעיף, שיכול לכלול את הדברים הבאים
ערכים:

CodeTemplate
הערך המוחזר על ידי הפונקציה codeTemplate() של הפלאגין, המסומן עבור
"שימוש עתידי" מאת Qt(TM) Designer (ברירת מחדל: ריק).

ConstructorArgs
הטיעונים שיעבירו לבנאי המחלקה שניתן על ידי ImplClass; אלה חייבים
להיות מוקף בסוגריים (ברירת מחדל: "(הורה)"). המשתנה היחיד המובטח
זמין הוא הורה, שהוא ה-QWidget האב שעבר על ידי Qt(TM) Designer.

מתעלמים מהערך הזה אם CreateWidget מוגדר.

CreateWidget
הקוד הדרוש ליצירת מופע של הווידג'ט (ברירת מחדל: משתמש ב-new כדי ליצור
מופע של המחלקה שניתנה על ידי הערך ImplClass, העברת הארגומנטים שצוינו על ידי
ConstructorArgs). עיין בהערות עבור ImplClass ו-ConstructorArgs.

DomXML
תיאור ממשק משתמש XML של הווידג'ט (ברירת מחדל: ברירת המחדל המסופקת על ידי ה-Qt(TM)
כותרות פלאגין מעצבים).

קְבוּצָה
הקבוצה שבה תציג את הווידג'ט ב-Qt(TM) Designer (ברירת מחדל: הערך של ה-
קבוצת ברירת מחדל ערך בסעיף [גלובלי]).

שם אייקון
קובץ התמונה או שם הסמל הסטנדרטי שישמש כסמל עבור ווידג'ט זה ב-Qt(TM)
רשימת ווידג'טים של מעצב (ברירת מחדל: קובץ PNG בשם עם שם המדור, עם כל כפול
נקודתיים הוסרו, בספריית "תמונות" של קובץ משאבים מהול; לדוגמה,
:/pics/Foo.png בקטע [Foo], או :/pics/FooBar.png בקטע [Foo::Bar]).

ImplClass
המחלקה שאמורה לשמש ליצירת מופע של הווידג'ט לשימוש של
מעצב Qt(TM) (ברירת מחדל: שם המדור). שימו לב שזה לא ממש חייב
להיות המחלקה שתיווצר עבור יישום קצה: זה נקבע על ידי ה
DomXML.

מתעלמים מהערך הזה אם CreateWidget מוגדר.

IncludeFile
הכותרת שצריך לכלול כדי להשתמש בווידג'ט הזה (ברירת מחדל: האותיות הקטנות
גרסה של שם המדור, עם כל נקודתיים שהוסרו והוסיפו ".h"; לדוגמה,
foo.h בקטע [Foo], או foobar.h בקטע [Foo::Bar]).

IsContainer
האם יישומון זה יכול להכיל ווידג'טים אחרים (ברירת מחדל: false).

הסבר קצר
הסבר הכלי להצגה בעת ריחוף מעל הווידג'ט ברשימת הווידג'טים של Qt(TM)
מעצב (ברירת מחדל: שם המדור, עם "יישומון" מצורף; לדוגמה, Foo Widget
בסעיף [Foo]).

מה זה
הטקסט מה זה המשויך לווידג'ט ב-Qt(TM) Designer (ברירת מחדל: ה
שם המדור, עם "יישומון" מצורף; לדוגמה, Foo Widget בקטע [Foo]).

דוגמאות

קובץ התיאור הפשוט ביותר עשוי להיראות כך

[פו]
ToolTip=מציג foos
[בָּר]
ToolTip=עורך סרגל

שימו לב שלכל מחלקה חייבת להיות לפחות סט מפתח אחד (בדוגמה זו נעשה שימוש ב-ToolTip),
אחרת זה יתעלם.

בדרך כלל, אתה רוצה לשנות לפחות את הטקסט הגלוי למשתמש, כלומר, הסבר הכלים,
WhatsThis וערכים בקבוצה. בנוסף, הגדרת שם הפלאגין יכולה להיות רעיון טוב
למנוע התנגשויות סמלים אפשריות ולא לבלבל מנופי באגים (הן אפליקציית ניפוי הבאגים
והאדם שעושה את ניפוי הבאגים):

[גלובלי]
PluginName=FooWidgets
DefaultGroup=תצוגה

[פו]
ToolTip=מציג דובים
WhatsThis=יישומון תמונה המציג דובים רוקדים

[בָּר]
ToolTip=עורך סרגל
WhatsThis=ממשק עורך עבור ברים עבור דובים
קבוצה=עריכה

ייתכן שיהיה צורך בקבצים מורכבים יותר אם יש לך מחלקות מרווחות שמות או אפשרויות נוספות
צריך אספקה ​​לבנאים, למשל:

[גלובלי]
PluginName=FooWidgets
DefaultGroup=Foo

[פו בר]
ToolTip=מציג פסים
WhatsThis=יישומון שמציג פסים בצורה מסוימת
IncludeFile=foo/bar.h
IconName=:/previews/bar.png

[Foo::Baz]
IncludeFile=foo/baz.h
ConstructorArgs=(Foo::Baz::SomeOption, הורה)
קבוצה=Fo (מיוחד)
IsContainer=true
IconName=:/previews/baz.png

לפעמים יישומונים מורכבים במיוחד עשויים להזדקק למימוש מיוחד של "מחלקת תצוגה מקדימה".
לשימוש ב-Qt(TM) Designer; זה עשוי להיות תת-מחלקה של הווידג'ט האמיתי שפשוט עושה זאת
הגדרה נוספת כלשהי, או שזה עשוי להיות יישום שונה לחלוטין.

[גלובלי]
Includes=foopreviews.h

[FancyWidget]
ImplClass=FancyWidgetPreview

השתמש ב-kgendesignerplugin באינטרנט באמצעות שירותי onworks.net