WxExtLib - DescriptionTexts.cpp
00001: //-------------------------------------------------------------------------
00002: // NOTE this is a generated file, do not edit - changes will be lost
00003: // if this file is re-generated
00004: //-------------------------------------------------------------------------
00005:
00006: const char * MessageExtDialogDescription =
00007: {
00008: "RATIONALE \n\n"
00009: "The normal wxMessageBox supports only predefined sets of "
00010: "Buttons -- this is a disadvantage, because the naming of the "
00011: "buttons cannot be done specific to the problem. The used "
00012: "messagebox implementations in X11, Motif, GTK, MSW seem to be "
00013: "equally restricted. \n\n"
00014: "Examples (flags for MSW C-API): 1) "
00015: "An error occured, but there is only the MB_OK style (which "
00016: "produces a MessageBox with a single 'OK' button). However, a "
00017: "single 'Cancel' button would be more appropriate. 2) The user "
00018: "is asked whether he/she wants to save a file. The buttons can "
00019: "be named 'Yes/No/Cancel' with the MB_YESNOCANCEL style, but "
00020: "with the normal MessageBox we cannot label the buttons 'Save/"
00021: "Discard/Cancel'. 'Save/Discard/Cancel' should be faster "
00022: "recognizable than 'Yes/No/Cancel', because the actions are quite "
00023: "clear even without reading the question. \n\n"
00024: "Another "
00025: "disadvantage of the normal MessageBox implementations is that the "
00026: "message text cannot be copied to the clipboard. This is just "
00027: "impractical if the user wants, for example, to note an uncommon "
00028: "error message. Moreover, automatic linebreak and automatic use of "
00029: "scrollbars for long message texts would be desireable. \n\n"
00030: ""
00031: "wxMessageExtDialog tries to overcome these shortcomings by "
00032: "providing a dialog class which allows specification of a message "
00033: "text, a title and arbitrary named buttons. It also tries to keep "
00034: "the usage of the programming interface simple, so that using the "
00035: "class isn't much more complicated than calling e.g. "
00036: "wxMessageBox(). \n\n"
00037: "Automatic line-break (wrapping) and "
00038: "scrolling is solved in wxMessageExtDialog by using either a "
00039: "wxTextCtrl or wxHtmlWindow (in case wxTextCtrl's functionality is "
00040: "not sufficient under the used platform). \n\n"
00041: "Copying to the "
00042: "clipboard is possible if the used control supports it (works for "
00043: "wxTextCtrl under MSW; doesn't work for wxHtmlWindow in wxWindows 2."
00044: "4.1; works for wxHtmlWindow in wxWidgets 2.5.2 in GTK port). \n\n"
00045: ""
00046:
00047: };
00048:
00049: const char * WxExtDialogDescriptionHtmlString =
00050: {
00051: " <h3>\n"
00052: " Extended dialog class\n"
00053: " </h3>\n"
00054: " <ul>\n"
00055: " <li>\n"
00056: " <font color=\"#A0A000\">wxExtDialog</font> class eases\n"
00057: " creating and adding controls\n"
00058: " </li>\n"
00059: " <li>\n"
00060: " slightly specialized to work with a MFC main window (under\n"
00061: " MSW, requires small modifications to wxWidgets library)\n"
00062: " </li>\n"
00063: " <li>\n"
00064: " support for dialog zoom\n"
00065: " </li>\n"
00066: " <li>\n"
00067: " simplification of control-change notification\n"
00068: " </li>\n"
00069: " </ul>\n"
00070: ""
00071:
00072: };
00073:
00074: const char * FormatMessageDescriptionHtmlString =
00075: {
00076: " <h3>\n"
00077: " Type-safe printf() replacement\n"
00078: " </h3>\n"
00079: " <ul>\n"
00080: " <li>\n"
00081: " <font color=\"#A0A000\">\n"
00082: " wxMessageFormatter/wxFormat/wxFormatMessage</font> provide\n"
00083: " type-safe string formatting similar to printf\n"
00084: " </li>\n"
00085: " <li>\n"
00086: " unlike with the C++ stream operator \"<<\", the format\n"
00087: " string must not be split up into pieces\n"
00088: " </li>\n"
00089: " <li>\n"
00090: " parameters are added with the \"%\" operator to <font color= \n"
00091: " \"#A0A000\">wxMessageFormatter</font>, alternatively, the\n"
00092: " overloaded function <font color=\"#A0A000\">\n"
00093: " wxFormatMessage()</font> can be used\n"
00094: " </li>\n"
00095: " <li>\n"
00096: " format string refers to parameters with \"%N\" or \"%{N}\"\n"
00097: " (with N being the N-th parameter added) - this makes it\n"
00098: " possible to reorder parameters in the output, which may be\n"
00099: " useful when translating the format string to other\n"
00100: " languages\n"
00101: " </li>\n"
00102: " <li>\n"
00103: " \"%+\" may be used to refer to the \"next\" parameter\n"
00104: " </li>\n"
00105: " </ul>\n"
00106: ""
00107:
00108: };
00109:
00110: const char * StatusValidatorsDescriptionHtmlString =
00111: {
00112: " <h3>\n"
00113: " Validators with immediate status output\n"
00114: " </h3>\n"
00115: " <ul>\n"
00116: " <li><font color=\"#A0A000\">wxTextCtrlStatusValidator</font> gives\n"
00117: " immediate feedback of validity of entered text via wxStatusMessageTarget\n"
00118: " (which output a status message into a wxTextCtrl)</li>\n"
00119: "\n"
00120: " <li>has support for \"Undefined\" (unspecified) values</li>\n"
00121: "\n"
00122: " <li>other general flags supported:\n"
00123: "\n"
00124: " <ul>\n"
00125: " <li>maintaining internal copy of value inside validator (useful e.g.\n"
00126: " to implement simple 'undo')</li>\n"
00127: "\n"
00128: " <li>left and/or right trimming of input</li>\n"
00129: " </ul>\n"
00130: " </li>\n"
00131: "\n"
00132: " <li>specializations:\n"
00133: "\n"
00134: " <ul>\n"
00135: " <li><font color=\"#A0A000\">wxTextCtrlStatusValidator</font>: base\n"
00136: " class for validators (such as wxNumberValidator)</li>\n"
00137: "\n"
00138: " <li><font color=\"#A0A000\">wxNumberValidator</font>: allows\n"
00139: " specification of a range of valid values (int, long or double)</li>\n"
00140: "\n"
00141: " <li><font color=\"#A0A000\">wxStringValidator</font>: a maximum length\n"
00142: " for the entered string can be specified</li>\n"
00143: "\n"
00144: " <li><font color=\"#A0A000\">wxDateTimeValidator</font>: validate\n"
00145: " from/to wxDateTime using specified date/time format string,\n"
00146: " defaulting to a simple ISO style date/time</li>\n"
00147: "\n"
00148: " <li><font color=\"#A0A000\">wxFilenameValidator</font>: support\n"
00149: " validation of file or directory names, with optional checks for\n"
00150: " existence/non-existence in file system and from/to relative/absolute\n"
00151: " path resolution</li>\n"
00152: " </ul>\n"
00153: " </li>\n"
00154: " </ul>\n"
00155: ""
00156:
00157: };
00158:
00159: const char * TextCtrlSliderPairValidatorsDescriptionHtmlString =
00160: {
00161: " <h3>\n"
00162: " Text/slider control pair validators\n"
00163: " </h3>\n"
00164: " <ul>\n"
00165: " <li>\n"
00166: " allow mutual update if one of both associated controls\n"
00167: " (wxTextCtrl or wxSlider) is changed by users input\n"
00168: " </li>\n"
00169: " <li>\n"
00170: " if entered text is valid: associated slider is updated\n"
00171: " immediately; otherwise the user will get immediate feedback\n"
00172: " via wxStatusMessageTarget (class is is derived from <font\n"
00173: " color=\"#A0A000\">\n"
00174: " wxNumberValidator/wxTextCtrlStatusValidator)</font>\n"
00175: " </li>\n"
00176: " <li>\n"
00177: " both required controls and both required validators can be\n"
00178: " created with minimum effort by calling <font color=\n"
00179: " \"#A0A000\">\n"
00180: " wxExtDialog::addTextCtrlSliderPairWithLabel()</font>\n"
00181: " </li>\n"
00182: " </ul>\n"
00183: " <h3>\n"
00184: ""
00185:
00186: };
00187:
00188: const char * ConfigEntryManagerDescriptionHtmlString =
00189: {
00190: " </ul>\n"
00191: " <h3>\n"
00192: " Type-safe access to entries in wxConfig\n"
00193: " </h3>\n"
00194: " <ul>\n"
00195: " <li>\n"
00196: " <font color=\"#A0A000\">wxConfigEntry</font> and <font color= \n"
00197: " \"#A0A000\">wxConfigEntryManager</font> allow typesafe\n"
00198: " reading/writing of values from/to wxConfig\n"
00199: " </li>\n"
00200: " <li>\n"
00201: " keys (access paths) and default values are centralized in\n"
00202: " the wxConfigEntry objects and therefore duplication can be\n"
00203: " avoided\n"
00204: " </li>\n"
00205: " <li>\n"
00206: " allows writing all values at once (e.g. upon program\n"
00207: " termination, or to give the user an overview of all\n"
00208: " sections/keys and their (default) values\n"
00209: " </li>\n"
00210: " <li>\n"
00211: " allows to reset to default values at once\n"
00212: " </li>\n"
00213: " <li>\n"
00214: " specializations of wxConfigEntry class:\n"
00215: " <ul>\n"
00216: " <li>\n"
00217: " <font color=\"#A0A000\">wxIntegerConfigEntry</font>\n"
00218: " (range of valid values can be specified)\n"
00219: " </li>\n"
00220: " <li>\n"
00221: " <font color=\"#A0A000\">wxStringConfigEntry</font>\n"
00222: " </li>\n"
00223: " <li>\n"
00224: " <font color=\"#A0A000\">wxBooleanConfigEntry</font>\n"
00225: " </li>\n"
00226: " <li>\n"
00227: " <font color=\"#A0A000\">wxDoubleConfigEntry</font>\n"
00228: " </li>\n"
00229: " <li>\n"
00230: " <font color=\"#A0A000\">wxDateTimeConfigEntry</font>\n"
00231: " </li>\n"
00232: " </ul>\n"
00233: " </li>\n"
00234: " </ul>\n"
00235: ""
00236:
00237: };
00238:
00239: