DOCSLIB.ORG

Application Programming Using the GNOME Libraries

Total Page：16

File Type：pdf, Size：1020Kb

Download full-text PDF Read full-text
Application Programming Using the GNOME Libraries Application Programming Using the GNOME Libraries George Lebl The GNOME Project [email protected] Application Programming Using the GNOME Libraries by George Lebl Copyright © 1999 by George Lebl In this tutorial, you will receive an overview of the GNOME libraries. You will learn how to speed up development of applications by using the many utility routines and objects available through the GNOME libraries, and how to make the GUI more consistent by using standard GNOME UI components. Focus will also be given to C applications using the GTK+ toolkit. Table of Contents Credits, Copyrights and Other Such Informations ....................................................................7 1. GNOME Libraries Overview....................................................................................................8 1.1. Where Do GNOME Libraries Fit .....................................................................................8 1.2. Structure of GNOME Libraries ........................................................................................8 2. GTK+ Programming ...............................................................................................................10 2.1. Overview.........................................................................................................................10 2.2. GLib ................................................................................................................................10 2.2.1. Naming Conventions............................................................................................10 2.2.2. Typedefs...............................................................................................................10 2.2.3. Portability and Utility Functions..........................................................................11 2.2.4. Containers ............................................................................................................13 2.2.4.1. GList, Doubly Linked List........................................................................14 2.2.4.2. GString, Dynamically Sized String Type..................................................15 2.2.4.3. GHashTable...............................................................................................16 2.2.5. More GLib Information .......................................................................................19 2.3. GTK+ ..............................................................................................................................19 2.3.1. GUI Basics...........................................................................................................19 2.3.2. GTK+ Object Model............................................................................................20 2.3.3. GTK+ Method Types ...........................................................................................20 2.3.4. Data on Objects....................................................................................................21 2.3.5. GTK+/GNOME Naming Conventions ................................................................21 2.3.6. Using GTK+ Methods .........................................................................................21 2.3.7. Example Hello World Program............................................................................22 3. GNOME Programming ...........................................................................................................26 3.1. Introduction.....................................................................................................................26 3.1.1. What Is a GNOME Program................................................................................26 3.1.2. Very Basic GNOME Program..............................................................................26 3.2. Overview.........................................................................................................................28 3.3. Using the libgnome Library............................................................................................28 3.3.1. Configuration Files ..............................................................................................29 3.3.1.1. Reading Configuration Info ......................................................................29 3.3.1.2. Writing Configuration Info .......................................................................29 3.3.1.3. Privacy Functions......................................................................................30 3.3.1.4. Using gnome-config for Arbitrary Files ...................................................30 3.3.1.5. Automatic Prefixes....................................................................................30 3.3.1.6. Misc gnome-config Stuff ..........................................................................31 3.3.2. .desktop Files .......................................................................................................31 3.3.3. Utility and Files ...................................................................................................32 3 3.3.3.1. Files...........................................................................................................32 3.3.3.2. Utility ........................................................................................................33 3.3.4. Mime Types .........................................................................................................34 3.3.5. Meta Data.............................................................................................................35 3.4. Using the GnomeApp Framework ..................................................................................37 3.4.1. GnomeApp Overview ..........................................................................................37 3.4.2. Creating a GnomeApp Window...........................................................................37 3.4.3. Menu and Tool-bar Creation................................................................................38 3.4.3.1. Automatic Menu and Tool-bar Creation ...................................................38 3.4.3.2. GnomeUIInfo Structure Definition...........................................................38 3.4.3.3. Helper Macros...........................................................................................40 3.4.3.4. Standard Menu Item Macros.....................................................................40 3.4.3.4.1. Menu Items ....................................................................................41 3.4.3.4.2. Menu Trees and Subtrees...............................................................43 3.4.3.5. Help Menu ................................................................................................44 3.4.3.6. Example ....................................................................................................45 3.4.3.7. Accelerator Keys.......................................................................................47 3.4.4. GnomeAppBar, The Status Bar ...........................................................................47 3.4.5. Talking To The User ............................................................................................48 3.5. Using the libgnomeui Library.........................................................................................51 3.5.1. Stock Icons...........................................................................................................51 3.5.2. Dialogs .................................................................................................................56 3.5.2.1. Generic Dialogs ........................................................................................56 3.5.2.2. Message Box.............................................................................................59 3.5.2.3. Property Dialogs .......................................................................................59 3.5.2.4. File Picking Dialog ...................................................................................61 3.5.2.5. About Box.................................................................................................62 3.5.3. Entries ..................................................................................................................63 3.5.3.1. GnomeEntry..............................................................................................64 3.5.3.2. GnomeFileEntry........................................................................................64 3.5.3.3. GnomePixmapEntry..................................................................................64 3.5.3.4. GnomeIconEntry.......................................................................................65 3.5.3.5. GnomeNumberEntry.................................................................................66 3.5.4. Using Images .......................................................................................................66 3.5.5. Session Management ...........................................................................................67 3.5.6. Multiple Document Interface...............................................................................69 3.5.6.1. The Main MDI Window............................................................................69 3.5.6.2. The MDI Children.....................................................................................70 3.5.7.
Load more

Recommended publications
  • Resurrect Your Old PC
    Resurrect your old PCs Resurrect your old PC Nostalgic for your old beige boxes? Don’t let them gather dust! Proprietary OSes force users to upgrade hardware much sooner than necessary: Neil Bothwick highlights some great ways to make your pensioned-off PCs earn their keep. ardware performance is constantly improving, and it is only natural to want the best, so we upgrade our H system from time to time and leave the old ones behind, considering them obsolete. But you don’t usually need the latest and greatest, it was only a few years ago that people were running perfectly usable systems on 500MHz CPUs and drooling over the prospect that a 1GHz CPU might actually be available quite soon. I can imagine someone writing a similar article, ten years from now, about what to do with that slow, old 4GHz eight-core system that is now gathering dust. That’s what we aim to do here, show you how you can put that old hardware to good use instead of consigning it to the scrapheap. So what are we talking about when we say older computers? The sort of spec that was popular around the turn of the century. OK, while that may be true, it does make it seem like we are talking about really old hardware. A typical entry-level machine from six or seven years ago would have had something like an 800MHz processor, Pentium 3 or similar, 128MB of RAM and a 20- 30GB hard disk. The test rig used for testing most of the software we will discuss is actually slightly lower spec, it has a 700MHz Celeron processor, because that’s what I found in the pile of computer gear I never throw away in my loft, right next to my faithful old – but non-functioning – Amiga 4000.
    [Show full text]
  • 18 Free Ways to Download Any Video Off the Internet Posted on October 2, 2007 by Aseem Kishore Ads by Google
    http://www.makeuseof.com/tag/18-free-ways-to-download-any-video-off-the-internet/ 18 Free Ways To Download Any Video off the Internet posted on October 2, 2007 by Aseem Kishore Ads by Google Download Videos Now download.cnet.com Get RealPlayer® & Download Videos from the web. 100% Secure Download. Full Movies For Free www.YouTube.com/BoxOffice Watch Full Length Movies on YouTube Box Office. Absolutely Free! HD Video Players from US www.20north.com/ Coby, TV, WD live, TiVo and more. Shipped from US to India Video Downloading www.VideoScavenger.com 100s of Video Clips with 1 Toolbar. Download Video Scavenger Today! It seems like everyone these days is downloading, watching, and sharing videos from video-sharing sites like YouTube, Google Video, MetaCafe, DailyMotion, Veoh, Break, and a ton of other similar sites. Whether you want to watch the video on your iPod while working out, insert it into a PowerPoint presentation to add some spice, or simply download a video before it’s removed, it’s quite essential to know how to download, convert, and play these videos. There are basically two ways to download videos off the Internet and that’s how I’ll split up this post: either via a web app or via a desktop application. Personally, I like the web applications better simply because you don’t have to clutter up and slow down your computer with all kinds of software! UPDATE: MakeUseOf put together an excellent list of the best websites for watching movies, TV shows, documentaries and standups online.
    [Show full text]
  • How-To Gnome-Look Guide
    HHOOWW--TTOO Written by David D Lowe GGNNOOMMEE--LLOOOOKK GGUUIIDDEE hen I first joined the harddisk, say, ~/Pictures/Wallpapers. right-clicking on your desktop Ubuntu community, I and selecting the appropriate You may have noticed that gnome- button (you know which one!). Wwas extremely look.org separates wallpapers into impressed with the amount of different categories, according to the customization Ubuntu had to size of the wallpaper in pixels. For Don't let acronyms intimidate offer. People posted impressive the best quality, you want this to you; you don't have to know screenshots, and mentioned the match your screen resolution. If you what the letters stand for to themes they were using. They don't know what your screen know what it is. Basically, GTK is soon led me to gnome-look.org, resolution is, click System > the system GNOME uses to the number one place for GNOME Preferences > Screen Resolution. display things like buttons and visual customization. The However, Ubuntu stretches controls. GNOME is Ubuntu's screenshots there looked just as wallpapers quite nicely if you picked default desktop environment. I impressive, but I was very the wrong size, so you needn't fret will only be dealing with GNOME confused as to what the headings about it. on the sidebar meant, and I had customization here--sorry no idea how to use the files I SVG is a special image format that Kubuntu and Xubuntu folks! downloaded. Hopefully, this guide doesn't use pixels; it uses shapes Gnome-look.org distinguishes will help you learn what I found called vectors, which means you can between two versions of GTK: out the slow way.
    [Show full text]
  • The Glib/GTK+ Development Platform
    The GLib/GTK+ Development Platform A Getting Started Guide Version 0.8 Sébastien Wilmet March 29, 2019 Contents 1 Introduction 3 1.1 License . 3 1.2 Financial Support . 3 1.3 Todo List for this Book and a Quick 2019 Update . 4 1.4 What is GLib and GTK+? . 4 1.5 The GNOME Desktop . 5 1.6 Prerequisites . 6 1.7 Why and When Using the C Language? . 7 1.7.1 Separate the Backend from the Frontend . 7 1.7.2 Other Aspects to Keep in Mind . 8 1.8 Learning Path . 9 1.9 The Development Environment . 10 1.10 Acknowledgments . 10 I GLib, the Core Library 11 2 GLib, the Core Library 12 2.1 Basics . 13 2.1.1 Type Definitions . 13 2.1.2 Frequently Used Macros . 13 2.1.3 Debugging Macros . 14 2.1.4 Memory . 16 2.1.5 String Handling . 18 2.2 Data Structures . 20 2.2.1 Lists . 20 2.2.2 Trees . 24 2.2.3 Hash Tables . 29 2.3 The Main Event Loop . 31 2.4 Other Features . 33 II Object-Oriented Programming in C 35 3 Semi-Object-Oriented Programming in C 37 3.1 Header Example . 37 3.1.1 Project Namespace . 37 3.1.2 Class Namespace . 39 3.1.3 Lowercase, Uppercase or CamelCase? . 39 3.1.4 Include Guard . 39 3.1.5 C++ Support . 39 1 3.1.6 #include . 39 3.1.7 Type Definition . 40 3.1.8 Object Constructor . 40 3.1.9 Object Destructor .
    [Show full text]
  • A Successor to the X Window System
    Y: A Successor to the X Window System Mark Thomas <[email protected]> Project Supervisor: D. R¨uckert <[email protected]> Second Marker: E. Lupu <[email protected]> June 18, 2003 ii Abstract UNIX desktop environments are a mess. The proliferation of incompatible and inconsistent user interface toolkits is now the primary factor in the failure of enterprises to adopt UNIX as a desktop solution. This report documents the creation of a comprehensive, elegant framework for a complete windowing system, including a standardised graphical user interface toolkit. ‘Y’ addresses many of the problems associated with current systems, whilst keeping and improving on their best features. An initial implementation, which supports simple applications like a terminal emulator, a clock and a calculator, is provided. iii iv Acknowledgements Thanks to Daniel R¨uckert for supervising the project and for his help and advice regarding it. Thanks to David McBride for his assistance with setting up my project machine and providing me with an ATI Radeon for it. Thanks to Philip Willoughby for his knowledge of the POSIX standard and help with the GNU Autotools and some of the more obscure libc functions. Thanks to Andrew Suffield for his help with the GNU Autotools and Arch. Thanks to Nick Maynard and Karl O’Keeffe for discussions on window system and GUI design. Thanks to Tim Southerwood for discussions about possible features of Y. Thanks to Duncan White for discussions about the virtues of X. All company and product names are trademarks and/or registered trademarks of their respective owners.
    [Show full text]
  • Fuzzing Project, Funded by Linux Foundation's Core Infrastructure Initiative
    FIX ALL THE BUGS AMERICAN FUZZY LOP AND ADDRESS SANITIZER Hanno Böck 1 INTRODUCTION Hanno Böck, freelance journalist and hacker. Writing for Golem.de and others. Author of monthly Bulletproof TLS Newsletter. Fuzzing Project, funded by Linux Foundation's Core Infrastructure Initiative. 2 BUG EXAMPLE (QT file src/plugins/platforminputcontexts/compose/qcomposeplatforminputcontext.cpp) 3 KDE / QT BUGS Use aer free in qmake Underflow / out of bounds read in QT / QCompose Out of bounds read in QtGui Out of bounds read in Kwin (last 2 not sure if I should blame Xorg/xcb API) 4 FOR FAIRNESS: GNOME #762417: Out of bounds read in glib / token parser #762483: Out of bounds read in glib / unicode parser #768441: Heap overflow in gnome-session parameter parsing #770027: Out of bounds read in pango / test suite 5 BUG EXAMPLE /* +2 for our new arguments, +1 for NULL */ new_argv = g_malloc (argc + 3 * sizeof (*argv)); (gnome-session 3.20.1, bug #768441) 6 ADDRESS SANITIZER (ASAN) All this bugs can be trivially found with Address Sanitizer. Just add -fsanitize=address to the compiler flags in GCC/CLANG. 7 FIND BUGS WITH ASAN ./configure CFLAGS="-fsanitize=address -g" \ CXXFLAGS="-fsanitize=address -g" \ LDFLAGS="-fsanitize=address" make make check 8 WHAT IS ASAN DOING? Shadow memory tracking which memory areas are valid. Finds out of bounds access (read/write) and use aer free bugs (and other less common issues). 9 OUT OF BOUNDS READ #include <stdio.h> int main() { int a[2] = {3,1}; int i = 2; printf("%i\n", a[i]); } 10 USE AFTER FREE #include <stdio.h> #include <stdlib.h> int main() { char *c = calloc(10,1); printf("%i\n", c[0]); free(c); printf("%i\n", c[1]); } 11 MISSION: TEST EVERYTING WITH ASAN Every project using C/C++ code should test with ASAN.
    [Show full text]
  • Annual Report 2006
    Annual Report 2006 Table of contents Foreword Letter from the Chairman, Dave Neary 4–5 A year in review 2006—a year in GNOME 8–10 Distributions in 2006 11 Events and community initiatives GUADEC—The GNOME Conference 12–13 GNOME hackers descend on MIT Media Center 14–15 GNOME User Groups 16 The www.gnome.org revamp 17 GNOME platform 17 GNOME Foundation Administrator 17 Foundation development The Women’s Summer Outreach Program 18–20 The GNOME Mobile and Embedded Initiative 21 The GNOME Advisory Board 22–23 PHOTO The GNOME Foundation Board and Advisory Board members by David Zeuthen (continued on the inside back cover) GNOME Foundation 3 Dear Friends, All traditions need a starting point, they say. What you now hold in your hands is the first annual report of the GNOME Foundation, at the end of what has been an eventful year for us. Each year brings its challenges and rewards for the members of this global project. This year, many of our biggest challenges are in the legal arena. European countries have been passing laws to conform with the European Union Copyright Directive, and some, including France, have brought into law provisions which we as software developers find it hard to understand, but which appear to make much of what we do illegal. We have found our- selves in the center of patent wars as bigger companies jockey for position with offerings based on our hard work. And we are scratching our heads trying to figure out how to deal with the constraints of DRM and patents in multimedia, while still offering our users access to their media files.
    [Show full text]
  • Part I. GTK+ Overview: GTK+ 3 Reference Manual GTK+ Is a Library for Creating Graphical User Interfaces
    Part I. GTK+ Overview: GTK+ 3 Reference Manual GTK+ is a library for creating graphical user interfaces. It works on many UNIX-like platforms, Windows, and OS X. GTK+ is released under the GNU Library General Public License (GNU LGPL), which allows for flexible licensing of client applications. GTK+ has a C-based object-oriented architecture that allows for maximum flexibility. Bindings for many other languages have been written, including C++, Objective-C, Guile/ Scheme, Perl, Python, TOM, Ada95, Free Pascal, and Eiffel. GTK+ depends on the following libraries: GLib A general-purpose utility library, not specific to graphical user interfaces. GLib provides many useful data types, macros, type conversions, string utilities, file utilities, a main loop abstraction, and so on. GObject A library that provides a type system, a collection of fundamental types including an object type, a signal system. GIO A modern, easy-to-use VFS API including abstractions for files, drives, volumes, stream IO, as well as network programming and DBus communication. cairo Cairo is a 2D graphics library with support for multiple output devices. Pango Pango is a library for internationalized text handling. It centers around the PangoLayout object, representing a paragraph of text. Pango provides the engine for GtkTextView, GtkLabel, GtkEntry, and other widgets that display text. ATK ATK is the Accessibility Toolkit. It provides a set of generic interfaces allowing accessibility technologies to interact with a graphical user interface. For example, a screen reader uses ATK to discover the text in an interface and read it to blind users. GTK+ widgets have built-in support for accessibility using the ATK framework.
    [Show full text]
  • Learn Raspberry Pi with Linux
    For your convenience Apress has placed some of the front matter material after the index. Please use the Bookmarks and Contents at a Glance links to access them. Contents at a Glance About the Authors .............................................................................................................. xv About the Technical Reviewer .......................................................................................... xvii Acknowledgments ............................................................................................................. xix Introduction ....................................................................................................................... xxi ■ Chapter 1: Your First Bite of Raspberry Pi .........................................................................1 ■ Chapter 2: Surveying the Landscape ...............................................................................31 ■ Chapter 3: Getting Comfortable .......................................................................................53 ■ Chapter 4: The File-Paths to Success ..............................................................................69 ■ Chapter 5: Essential Commands ......................................................................................89 ■ Chapter 6: Editing Files on the Command Line ..............................................................109 ■ Chapter 7: Managing Your Pi .........................................................................................129 ■ Chapter 8: A
    [Show full text]
  • Gtk2-Perl: an Introduction
    Gtk2-Perl: An Introduction Gtk2-Perl: An Introduction Or How I Learned to Stop Worrying and Make Things Pretty Scott Paul Robertson http://spr.mahonri5.net [email protected] May 9, 2007 Gtk2-Perl: An Introduction Background What is Gtk2-Perl? Gtk2-Perl is the set of Perl bindings for Gtk2, and related libraries1. These allow you to code Gtk2 and Gnome applications in Perl. Gtk2-Perl is fairly easy to get started using, but has a few hang ups that can be difficult to discover, or sometimes the documentation is just not there. The developers are aware of the issue, and encourage users to provide documentation, reference guides, or tutorials. 1Glade, Glib, etc Gtk2-Perl: An Introduction Background Online Documentation There are a few major online sources for Gtk2-Perl documentation: ◮ Gtk2-Perl Tutorial - The offical tutorial. ◮ Gtk2-Perl Study Guide - Another excellent tutorial/reference ◮ Introduction to GUI Programming with Gtk2-Perl - As it says, it’s a good introduction to gui programming in general. ◮ Gtk2-Perl Pod Documentation - You might have these as man pages as well, very helpful. Gtk2-Perl: An Introduction Basic Application A Simple Window We’ll start with an example of a simple single button application. First we have to initalize Gtk2: #!/usr/bin/perl -w use strict; use Gtk2 ’-init’; use readonly TRUE => 1; use readonly FALSE => 0; ◮ The ’-init’ prepares the Gtk2 environment, otherwise we would have to do it ourselves later. ◮ Defining the constants is very helpful for code readability later. Gtk2-Perl: An Introduction Basic Application A Simple Window Now we set up the window object and a button.
    [Show full text]
  • Clutter Version 1.10.0, Updated 9 May 2012
    Guile-GNOME: Clutter version 1.10.0, updated 9 May 2012 Matthew Allum and OpenedHand LTD Intel Corporation This manual is for (gnome clutter) (version 1.10.0, updated 9 May 2012) Copyright 2006,2007,2008 OpenedHand LTD Copyright 2009,2010,2011,2012 Intel Corporation Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You may obtain a copy of the GNU Free Documentation License from the Free Software Foundation by visiting their Web site or by writing to: The Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA i Short Contents 1 Overview :::::::::::::::::::::::::::::::::::::::::::: 1 2 ClutterAction :::::::::::::::::::::::::::::::::::::::: 2 3 ClutterActorMeta ::::::::::::::::::::::::::::::::::::: 3 4 ClutterActor ::::::::::::::::::::::::::::::::::::::::: 5 5 ClutterAlignConstraint:::::::::::::::::::::::::::::::: 63 6 ClutterAlpha :::::::::::::::::::::::::::::::::::::::: 65 7 ClutterAnimatable ::::::::::::::::::::::::::::::::::: 68 8 Implicit Animations :::::::::::::::::::::::::::::::::: 69 9 ClutterAnimator ::::::::::::::::::::::::::::::::::::: 76 10 ClutterBackend :::::::::::::::::::::::::::::::::::::: 82 11 ClutterBinLayout :::::::::::::::::::::::::::::::::::: 84 12 ClutterBindConstraint :::::::::::::::::::::::::::::::: 87 13 Key Bindings:::::::::::::::::::::::::::::::::::::::: 90
    [Show full text]
  • Create User Interfaces with Glade 9/29/09 7:18 AM
    Create User Interfaces with Glade 9/29/09 7:18 AM Home Topics Community Forums Magazine Shop Buyer's Guide Archive CD Search Home Create User Interfaces with Glade Subscribe Renew Free Issue Customer service July 1st, 2001 by Mitch Chapman in Software Mitch shows how to use gnome-python's libglade binding to build Python-based GUI applications with little manual coding. Digg submit Average: Your rating: None Average: 2.3 (3 votes) Glade is a GUI builder for the Gtk+ toolkit. Glade makes it easy to create user interfaces interactively, and it can generate source code for those interfaces as well as stubs for user interface callbacks. The libglade library allows programs to instantiate widget hierarchies defined in Glade project files easily. It includes a way to bind callbacks named in the project file to program-supplied callback routines. The Latest James Henstridge maintains both libglade and the gnome-python package, which is a Python binding to the Gtk+ toolkit, the GNOME user interface libraries and libglade itself. Using libglade Without Free Software, Open Source Would Lose Sep-28- binding to build Python-based GUI applications can provide significant savings in development and its Meaning 09 maintenance costs. Sep-25- Flip Flops Are Evil 09 All code examples in this article have been developed using Glade 0.5.11, gnome-python 1.0.53 Sep-24- and Python 2.1b1 running on Mandrake Linux 7.2. The Linux Desktop - The View from LinuxCon 09 Running Glade Sep-24- Create Image Galleries With Konqueror 09 When launched, Glade displays three top-level windows (see Figure 1).
    [Show full text]