File: aboutdialog.py.page

package info (click to toggle)
gnome-devel-docs 40.3-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 79,188 kB
  • sloc: javascript: 2,514; xml: 2,407; ansic: 2,229; python: 1,854; makefile: 805; sh: 499; cpp: 131
file content (143 lines) | stat: -rw-r--r-- 5,627 bytes parent folder | download
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
<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" xmlns:xi="http://www.w3.org/2001/XInclude" type="guide" style="task" id="aboutdialog.py" xml:lang="sv">
  <info>
    <title type="text">AboutDialog (Python)</title>
    <link type="guide" xref="beginner.py#windows"/>
    <link type="next" xref="messagedialog.py"/>
    <revision version="0.1" date="2012-06-11" status="draft"/>

    <credit type="author copyright">
      <name>Marta Maria Casetti</name>
      <email its:translate="no">mmcasetti@gmail.com</email>
      <years>2012</years>
    </credit>

    <desc>Ett fönster som visar information om ett program</desc>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Sebastian Rasmussen</mal:name>
      <mal:email>sebras@gmail.com</mal:email>
      <mal:years>2019</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Anders Jonsson</mal:name>
      <mal:email>anders.jonsson@norsjovallen.se</mal:email>
      <mal:years>2021</mal:years>
    </mal:credit>
  </info>

  <title>AboutDialog</title>
  <media type="image" mime="image/png" src="media/aboutdialog_GMenu.png"/>
  <p>Ett AboutDialog-exempel som använder Gtk.ApplicationWindow och Menu (”om” visas om ”Om” i menyn väljs).</p>

  <links type="section"/>

  <section id="code">
  <title>Kod som använts för att generera detta exempel</title>

  <code mime="text/x-python" style="numbered">from gi.repository import Gtk
from gi.repository import Gio
import sys


class MyWindow(Gtk.ApplicationWindow):

     # konstruktor för ett fönster (föräldrafönstret)
    def __init__(self, app):
        Gtk.Window.__init__(self, title="AboutDialog-exempel", application=app)
        self.set_default_size(200, 200)

        # skapa about_action (en Gio.SimpleAction)
        about_action = Gio.SimpleAction.new("about", None)
        # anslut signalen från åtgärden till funktionen about_cb()
        about_action.connect("activate", self.about_cb)
        # lägg till åtgärden till programmet
        app.add_action(about_action)

    # återanropsfunktion för about_actions ”activate”-signal
    def about_cb(self, action, parameter):
        # en Gtk.AboutDialog
        aboutdialog = Gtk.AboutDialog()

        # listor över upphovsmän och dokumentatörer (kommer att användas senare)
        authors = ["GNOME:s dokumentationsgrupp"]
        documenters = ["GNOME:s dokumentationsgrupp"]

        # vi fyller i aboutdialog
        aboutdialog.set_program_name("AboutDialog-exempel")
        aboutdialog.set_copyright(
            "Copyright \xc2\xa9 2012 GNOME:s dokumentationsgrupp")
        aboutdialog.set_authors(authors)
        aboutdialog.set_documenters(documenters)
        aboutdialog.set_website("http://developer.gnome.org")
        aboutdialog.set_website_label("GNOME:s utvecklarwebbplats")

        # vi vill inte visa titeln, vilken som standard hade varit ”Om AboutDialog-exempel”
        # vi måste återställa titeln för meddelandedialogfönstret efter att ha ställt in
        # programnamnet
        aboutdialog.set_title("")

        # för att stänga aboutdialog när ”close” klickas på ansluter vi
        # signalen ”response” till on_close
        aboutdialog.connect("response", self.on_close)
        # visa aboutdialog
        aboutdialog.show()

    # förstör aboutdialog
    def on_close(self, action, parameter):
        action.destroy()


class MyApplication(Gtk.Application):

    def __init__(self):
        Gtk.Application.__init__(self)

    def do_activate(self):
        win = MyWindow(self)
        win.show_all()

    def quit_cb(self, action, parameter):
        self.quit()

    def do_startup(self):
        Gtk.Application.do_startup(self)

        # skapa en meny (en Gio.Menu)
        menu = Gio.Menu()
        # lägg till ett menyobjekt med etiketten ”Om” och åtgärden ”app.about”
        menu.append("Om", "app.about")
        # lägg till ett menyobjekt med etiketten ”Avsluta” och åtgärden ”app.quit”
        menu.append("Avsluta", "app.quit")
        # sätt menyn som meny för programmet
        self.set_app_menu(menu)

        # en ny simpleaction - för programmet
        quit_action = Gio.SimpleAction.new("quit", None)
        quit_action.connect("activate", self.quit_cb)
        self.add_action(quit_action)

app = MyApplication()
exit_status = app.run(sys.argv)
sys.exit(exit_status)
</code>

  </section>

  <section id="methods">
  <title>Användbara metoder för en AboutDialog-komponent</title>
    <p>På rad 15 ansluts signalen <code>"activate"</code> till återanropsfunktionen <code>about_cb()</code> med <code><var>komponent</var>.connect(<var>signal</var>, <var>återanropsfunktion</var>)</code>. Se <link xref="signals-callbacks.py"/> för en utförligare förklaring.</p>
  </section>

  <section id="references">
  <title>API-referenser</title>
  <p>I detta exempel använde vi följande:</p>
  <list>
    <item><p><link href="http://developer.gnome.org/gtk3/unstable/GtkAboutDialog.html">GtkAboutDialog</link></p></item>
    <item><p><link href="http://developer.gnome.org/gtk3/unstable/GtkApplicationWindow.html">GtkApplicationWindow</link></p></item>
    <item><p><link href="http://developer.gnome.org/gio/stable/GMenu.html">GMenu</link></p></item>
    <item><p><link href="http://developer.gnome.org/gtk3/unstable/GtkApplication.html">GtkApplication</link></p></item>
  </list>
  </section>
</page>