/usr/include/wx-3.0/wx/wxPython/i_files/_about.i is in python-wxgtk3.0-dev 3.0.2.0+dfsg-7.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 | /////////////////////////////////////////////////////////////////////////////
// Name: _about.i
// Purpose: SWIG interface for wxAboutDialog
//
// Author: Robin Dunn
//
// Created: 08-Oct-2006
// RCS-ID: $Id$
// Copyright: (c) 2006 by Total Control Software
// Licence: wxWindows license
/////////////////////////////////////////////////////////////////////////////
// Not a %module
%{
#include <wx/aboutdlg.h>
%}
//---------------------------------------------------------------------------
%newgroup
DocStr(wxAboutDialogInfo,
"`wx.AboutDialogInfo` contains information to be shown in the standard
About dialog displayed by the `wx.AboutBox` function. This class
contains the general information about the program, such as its name,
version, copyright and so on, as well as lists of the program
developers, documentation writers, artists and translators.
While all the main platforms have a native implementation of the about
dialog, they are often more limited than the generic version provided
by wxWidgets and so the generic version is used if
`wx.AboutDialogInfo` has any fields not supported by the native
version. Currently GTK+ version supports all the possible fields
natively but MSW and Mac versions don't support URLs, licence text nor
custom icons in the about dialog and if either of those is used,
wxAboutBox() will automatically use the generic version so you should
avoid specifying these fields to achieve more native look and feel.
", "");
class wxAboutDialogInfo
{
public:
wxAboutDialogInfo();
~wxAboutDialogInfo();
DocDeclStr(
void , SetName(const wxString& name),
"Set the name of the program. If this method is not called, the string
returned by `wx.App.GetAppName` will be shown in the dialog.", "");
DocDeclStr(
wxString , GetName() const,
"Returns the program name.", "");
%property(Name, GetName, SetName);
DocDeclStr(
void , SetVersion(const wxString& version,
const wxString& longVersion = wxEmptyString),
"Set the version of the program. The version is in free format,
i.e. not necessarily in the x.y.z form but it shouldn't contain the
\"version\" word.", "");
DocDeclStr(
bool , HasVersion() const,
"Returns ``True`` if the version property has been set.", "");
DocDeclStr(
wxString , GetVersion() const,
"Returns the version value.", "");
%property(Version, GetVersion, SetVersion);
DocDeclStr(
wxString , GetLongVersion() const,
"", "");
%property(LongVersion, GetLongVersion);
DocDeclStr(
void , SetDescription(const wxString& desc),
"Set brief, but possibly multiline, description of the program.", "");
DocDeclStr(
bool , HasDescription() const,
"Returns ``True`` if the description property has been set.", "");
DocDeclStr(
wxString , GetDescription() const,
"Returns the description value.", "");
%property(Description, GetDescription, SetDescription);
DocDeclStr(
void , SetCopyright(const wxString& copyright),
"Set the short string containing the program copyright
information. Notice that any occurrences of \"(C)\" in ``copyright``
will be replaced by the copyright symbol (circled C) automatically,
which means that you can avoid using this symbol in the program source
code which can be problematic.", "");
DocDeclStr(
bool , HasCopyright() const,
"Returns ``True`` if the copyright property has been set.", "");
DocDeclStr(
wxString , GetCopyright() const,
"Returns the copyright value.", "");
%property(Copyright, GetCopyright, SetCopyright);
DocDeclStr(
void , SetLicence(const wxString& licence),
"Set the long, multiline string containing the text of the program
licence.
Only GTK+ version supports showing the licence text in the native
about dialog currently so the generic version will be used under all
the other platforms if this method is called. To preserve the native
look and feel it is advised that you do not call this method but
provide a separate menu item in the \"Help\" menu for displaying the
text of your program licence.
", "");
DocDeclStr(
void , SetLicense(const wxString& licence),
"This is the same as `SetLicence`.", "");
DocDeclStr(
bool , HasLicence() const,
"Returns ``True`` if the licence property has been set.", "");
DocDeclStr(
wxString , GetLicence() const,
"Returns the licence value.", "");
%property(Licence, GetLicence, SetLicence);
%pythoncode { License = Licence }
DocDeclStr(
void , SetIcon(const wxIcon& icon),
"Set the icon to be shown in the dialog. By default the icon of the
main frame will be shown if the native about dialog supports custom
icons. If it doesn't but a valid icon is specified using this method,
the generic about dialog is used instead so you should avoid calling
this function for maximally native look and feel.", "");
DocDeclStr(
bool , HasIcon() const,
"Returns ``True`` if the icon property has been set.", "");
DocDeclStr(
wxIcon , GetIcon() const,
"Return the current icon value.", "");
%property(Icon, GetIcon, SetIcon);
// web site for the program and its description (defaults to URL itself if
// empty)
%Rename(_SetWebSite,
void , SetWebSite(const wxString& url, const wxString& desc = wxEmptyString));
%Rename(_GetWebSiteURL,
wxString , GetWebSiteURL() const);
%Rename(_GetWebSiteDescription,
wxString , GetWebSiteDescription() const);
bool HasWebSite() const;
%pythoncode {
def SetWebSite(self, args):
"""
SetWebSite(self, URL, [Description])
Set the web site property. The ``args`` parameter can
either be a single string for the URL, to a 2-tuple of
(URL, Description) strings.
"""
if type(args) in [str, unicode]:
self._SetWebSite(args)
else:
self._SetWebSite(args[0], args[1])
def GetWebSite(self):
"""
GetWebSite(self) --> (URL, Description)
"""
return (self._GetWebSiteURL(), self._GetWebSiteDescription())
}
%property(WebSite, GetWebSite, SetWebSite)
DocDeclAStr(
void , SetDevelopers(const wxArrayString& developers),
"SetDevelopers(self, list developers)",
"Set the list of the developers of the program.", "");
DocDeclStr(
void , AddDeveloper(const wxString& developer),
"Add a string to the list of developers.", "");
DocDeclStr(
bool , HasDevelopers() const,
"Returns ``True if any developers have been set.", "");
DocDeclAStr(
const wxArrayString& , GetDevelopers() const,
"GetDevelopers(self) --> list",
"Returns the list of developers.", "");
%property(Developers, GetDevelopers, SetDevelopers);
DocDeclAStr(
void , SetDocWriters(const wxArrayString& docwriters),
"SetDocWriters(self, list docwriters)",
"Set the list of the documentation writers.", "");
DocDeclStr(
void , AddDocWriter(const wxString& docwriter),
"Add a string to the list of documentation writers.", "");
DocDeclStr(
bool , HasDocWriters() const,
"Returns ``True if any documentation writers have been set.", "");
DocDeclAStr(
const wxArrayString& , GetDocWriters() const,
"GetDocWriters(self) --> list",
"Returns the list of documentation writers.", "");
%property(DocWriters, GetDocWriters, SetDocWriters);
DocDeclAStr(
void , SetArtists(const wxArrayString& artists),
"SetArtists(self, list artists)",
"Set the list of artists for the program.", "");
DocDeclStr(
void , AddArtist(const wxString& artist),
"Add a string to the list of artists.", "");
DocDeclStr(
bool , HasArtists() const,
"Returns ``True`` if any artists have been set.", "");
DocDeclAStr(
const wxArrayString& , GetArtists() const,
"GetArtists(self) --> list",
"Returns the list od artists.", "");
%property(Artists, GetArtists, SetArtists);
DocDeclAStr(
void , SetTranslators(const wxArrayString& translators),
"SetTranslators(self, list translators)",
"Sets the list of program translators.", "");
DocDeclStr(
void , AddTranslator(const wxString& translator),
"Add a string to the list of translators.", "");
DocDeclStr(
bool , HasTranslators() const,
"Returns ``True`` if any translators have been set.", "");
DocDeclAStr(
const wxArrayString& , GetTranslators() const,
"GetTranslators(self) --> list",
"Returns the list of program translators.", "");
%property(Translators, GetTranslators, SetTranslators);
// implementation only
// -------------------
// "simple" about dialog shows only textual information (with possibly
// default icon but without hyperlink nor any long texts such as the
// licence text)
bool IsSimple() const;
// get the description and credits (i.e. all of developers, doc writers,
// artists and translators) as a one long multiline string
wxString GetDescriptionAndCredits() const;
// returns the copyright with the (C) string substituted by the Unicode
// character U+00A9
wxString GetCopyrightToDisplay() const;
};
DocStr(wxAboutBox,
"This function shows the standard about dialog containing the
information specified in ``info``. If the current platform has a
native about dialog which is capable of showing all the fields in
`wx.AboutDialogInfo`, the native dialog is used, otherwise the
function falls back to the generic wxWidgets version of the dialog.", "");
void wxAboutBox(const wxAboutDialogInfo& info, wxWindow* parent = NULL);
//---------------------------------------------------------------------------
|