~ubuntu-branches/ubuntu/precise/libglade2/precise-proposed

<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Glade 2.0 File Format</title><meta name="generator" content="DocBook XSL Stylesheets V1.66.1"><link rel="start" href="index.html" title="Libglade Reference Manual"><link rel="up" href="index.html" title="Libglade Reference Manual"><link rel="prev" href="libglade-embedding.html" title="Embedding Libglade Interfaces"><link rel="next" href="libglade-dtd-exceptions.html" title="Exceptions"><meta name="generator" content="GTK-Doc V1.3 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="chapter" href="libglade-notes.html" title="Libglade Programming Notes"><link rel="chapter" href="libglade-dtd.html" title="Glade 2.0 File Format"><link rel="part" href="libglade-lib.html" title="Part�I.�Libglade Library Reference"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libglade-embedding.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Libglade Reference Manual</th><td><a accesskey="n" href="libglade-dtd-exceptions.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="libglade-dtd"></a>Glade 2.0 File Format</h2></div></div></div><div class="toc"><dl><dt><span class="sect1"><a href="libglade-dtd.html#property-representations">Property Representations</a></span></dt><dt><span class="sect1"><a href="libglade-dtd-exceptions.html">Exceptions</a></span></dt></dl></div><p>Libglade 2.0 introduces a new file format for storing the

132

user interface. Unlike the previous format, this one does not

133

introduce a new element for each new property. This was done so

134

that the format could be described with a fairly small DTD:</P

135

><TABLE

136

BORDER="0"

137

BGCOLOR="#D6E8FF"

138

WIDTH="100%"

139

CELLPADDING="6"

140

><TR

141

><TD

142

><PRE

143

CLASS="PROGRAMLISTING"

144

>

145

146

<!ELEMENT glade-interface (requires*, widget*) >

147

<!ATTLIST glade-interface

148

xmlns CDATA #FIXED 'http://glade.gnome.org/glade-2.0.dtd' >

149

150

<!ELEMENT requires EMPTY >

151

<!ATTLIST requires

152

lib CDATA #REQUIRED >

153

154

<!ELEMENT widget (property*, accessibility?, signal*, accelerator*, child*) >

155

<!ATTLIST widget

that the format could be described with a fairly small DTD:</p><pre class="programlisting">

<!ELEMENT glade-interface (requires*, widget*) >

<!ATTLIST glade-interface

xmlns CDATA #FIXED 'http://glade.gnome.org/glade-2.0.dtd' >

<!ELEMENT requires EMPTY >

<!ATTLIST requires

lib CDATA #REQUIRED >

<!ELEMENT widget (property*, accessibility?, signal*, accelerator*, child*) >

<!ATTLIST widget

156

class CDATA #REQUIRED

157

id ID #REQUIRED >

158

159

<!ELEMENT property (#PCDATA) >

160

<!-- type is an optional tag, and should be the string name of the

161

GType for the property -->

162

<!-- translatable specifies whether the property should be translated

163

before use. -->

164

<!ATTLIST property

165

name CDATA #REQUIRED

166

type CDATA #IMPLIED

167

translatable (yes|no) 'no'

168

agent CDATA #IMPLIED >

169

170

<!ELEMENT atkproperty (#PCDATA | accessibility)* >

171

<!ATTLIST atkproperty

172

name CDATA #REQUIRED

173

type CDATA #IMPLIED >

174

175

<!ELEMENT atkrelation EMPTY >

176

<!ATTLIST atkrelation

id ID #REQUIRED >

<!ELEMENT property (#PCDATA) >

<!-- type is an optional tag, and should be the string name of the

GType for the property -->

<!-- translatable specifies whether the property should be translated

before use. -->

<!-- context indicates that the value has a |-separated

context which must be stripped before use, look up g_strip_context()

in the GLib API documentation for details.-->

<!ATTLIST property

name CDATA #REQUIRED

type CDATA #IMPLIED

translatable (yes|no) 'no'

context (yes|no) 'no'

comments CDATA #IMPLIED

agent CDATA #IMPLIED >

<!ELEMENT atkproperty (#PCDATA | accessibility)* >

<!ATTLIST atkproperty

name CDATA #REQUIRED

type CDATA #IMPLIED

translatable (yes|no) 'no'

context (yes|no) 'no'

comments CDATA #IMPLIED >

<!ELEMENT atkrelation EMPTY >

<!ATTLIST atkrelation

177

target CDATA #REQUIRED

178

type CDATA #REQUIRED >

179

180

<!ELEMENT atkaction EMPTY >

181

<!ATTLIST atkaction

<!ELEMENT atkaction EMPTY >

<!ATTLIST atkaction

182

action_name CDATA #REQUIRED

183

description CDATA #IMPLIED >

184

185

<!ELEMENT accessibility (atkrelation | atkaction | atkproperty)* >

186

187

<!ELEMENT signal EMPTY >

188

<!ATTLIST signal

description CDATA #IMPLIED >

<!ELEMENT accessibility (atkrelation | atkaction | atkproperty)* >

<!ELEMENT signal (property*) >

<!ATTLIST signal

189

name CDATA #REQUIRED

190

handler CDATA #REQUIRED

191

after (yes|no) 'no'

192

object IDREF #IMPLIED

193

last_modification_time CDATA #IMPLIED >

194

195

<!ELEMENT accelerator EMPTY >

196

<!ATTLIST accelerator

<!ELEMENT accelerator EMPTY >

<!ATTLIST accelerator

197

key CDATA #REQUIRED

198

modifiers CDATA #REQUIRED

199

signal CDATA #REQUIRED >

200

201

<!ELEMENT child ((widget|placeholder), packing?) >

202

<!-- internal children should not have any properties set on them.

<!ELEMENT child ((widget|placeholder), packing?) >

<!-- internal children should not have any properties set on them.

203

(Internal children are things like the scrollbars in a

204

GtkScrolledWindow, or the vbox in a GtkDialog). -->

205

<!ATTLIST child

206

internal-child CDATA #IMPLIED >

207

208

<!ELEMENT packing (property+) >

209

210

<!ELEMENT placeholder EMPTY ></PRE

211

></TD

212

></TR

213

></TABLE

214

><P

215

>The <TT

216

CLASS="SGMLTAG"

217

><widget></TT

218

> elements contain

219

<TT

220

CLASS="SGMLTAG"

221

><property></TT

222

> elements which define widget

GtkScrolledWindow, or the vbox in a GtkDialog). -->

<!ATTLIST child

internal-child CDATA #IMPLIED >

<!ELEMENT packing (property+) >

<!ELEMENT placeholder EMPTY >

</pre><p>The <tt class="sgmltag-element"><widget></tt> elements contain

<tt class="sgmltag-element"><property></tt> elements which define widget

223

properties. In general these map to

224

<TT

225

CLASS="CLASSNAME"

226

>GObject</TT

227

> properties.</P

228

><P

229

>The <TT

230

CLASS="SGMLTAG"

231

><signal></TT

232

> and

233

<TT

234

CLASS="SGMLTAG"

235

><accelerator></TT

236

> elements are used to define

237

signals and accelerators on the widget.</P

238

><P

239

>The <TT

240

CLASS="SGMLTAG"

241

><widget></TT

242

> element may also

243

contain an <TT

244

CLASS="SGMLTAG"

245

><accessibility></TT

246

> element, which

<tt class="classname">GObject</tt> properties.</p><p>The <tt class="sgmltag-element"><signal></tt> and

<tt class="sgmltag-element"><accelerator></tt> elements are used to define

signals and accelerators on the widget.</p><p>The <tt class="sgmltag-element"><widget></tt> element may also

contain an <tt class="sgmltag-element"><accessibility></tt> element, which

247

contains accessibility related properties. These set various ATK

248

options (such as ATK properties, relations and actions).</P

249

><P

250

>For each child of the widget, there is an

251

<TT

252

CLASS="SGMLTAG"

253

><child></TT

254

> element. The

255

<TT

256

CLASS="PARAMETER"

257

><I

258

>internal-child</I

259

></TT

260

> attribute is used to mark

options (such as ATK properties, relations and actions).</p><p>For each child of the widget, there is an

<tt class="sgmltag-element"><child></tt> element. The

<i class="parameter"><tt>internal-child</tt></i> attribute is used to mark

261

"internal children of the parent. These children are widgets that

262

are created when the parent is constructed, such as the

263

<TT

264

CLASS="CLASSNAME"

265

>GtkVBox</TT

266

> and

267

<TT

268

CLASS="CLASSNAME"

269

>GtkHButtonBox</TT

270

> in a

271

<TT

272

CLASS="CLASSNAME"

273

>GtkDialog</TT

274

>.</P

275

><P

276

>The <TT

277

CLASS="SGMLTAG"

278

><child></TT

279

> element contains either

280

a <TT

281

CLASS="SGMLTAG"

282

><widget></TT

283

> element representing the child

284

widget, or a <TT

285

CLASS="SGMLTAG"

286

><placeholder></TT

287

> element, which

<tt class="classname">GtkVBox</tt> and

<tt class="classname">GtkHButtonBox</tt> in a

<tt class="classname">GtkDialog</tt>.</p><p>The <tt class="sgmltag-element"><child></tt> element contains either

a <tt class="sgmltag-element"><widget></tt> element representing the child

widget, or a <tt class="sgmltag-element"><placeholder></tt> element, which

288

is ignored when building the interface. It may also contain a

289

<TT

290

CLASS="SGMLTAG"

291

><packing></TT

292

> element, which contains

293

<TT

294

CLASS="SGMLTAG"

295

><property></TT

296

> elements defining packing

<tt class="sgmltag-element"><packing></tt> element, which contains

100

<tt class="sgmltag-element"><property></tt> elements defining packing

297

101

properties. These map to GtkContainer child packing

298

properties.</P

299

><BR

300

CLEAR="all"><DIV

301

CLASS="SECT1"

302

><H1

303

CLASS="SECT1"

304

><A

305

NAME="PROPERTY-REPRESENTATIONS">Property Representations</H1

306

><P

307

>Properties are represented as straight content data in the

102

properties.</p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="property-representations"></a>Property Representations</h2></div></div></div><p>Properties are represented as straight content data in the

308

103

glade file. All programs working with glade files must

309

represent the various types in the same way.</P

310

></DIV

311

></DIV

312

><DIV

313

CLASS="NAVFOOTER"

314

><BR

315

CLEAR="all"><BR><TABLE

316

WIDTH="100%"

317

BORDER="0"

318

BGCOLOR="#000000"

319

CELLPADDING="1"

320

CELLSPACING="0"

321

><TR

322

><TD

323

WIDTH="25%"

324

BGCOLOR="#C00000"

325

ALIGN="left"

326

><A

327

HREF="libglade-libglade-build.html"

328

><FONT

329

COLOR="#FFFFFF"

330

SIZE="3"

331

><B

332

><<< Previous Page</B

333

></FONT

334

></A

335

></TD

336

><TD

337

WIDTH="25%"

338

BGCOLOR="#0000C0"

339

ALIGN="center"

340

><FONT

341

COLOR="#FFFFFF"

342

SIZE="3"

343

><B

344

><A

345

HREF="libglade.html"

346

><FONT

347

COLOR="#FFFFFF"

348

SIZE="3"

349

><B

350

>Home</B

351

></FONT

352

></A

353

></B

354

></FONT

355

></TD

356

><TD

357

WIDTH="25%"

358

BGCOLOR="#00C000"

359

ALIGN="center"

360

><FONT

361

COLOR="#FFFFFF"

362

SIZE="3"

363

><B

364

> </B

365

></FONT

366

></TD

367

><TD

368

WIDTH="25%"

369

BGCOLOR="#C00000"

370

ALIGN="right"

371

><A

372

HREF="libglade-dtd-exceptions.html"

373

><FONT

374

COLOR="#FFFFFF"

375

SIZE="3"

376

><B

377

>Next Page >>></B

378

></FONT

379

></A

380

></TD

381

></TR

382

><TR

383

><TD

384

COLSPAN="2"

385

ALIGN="left"

386

><FONT

387

COLOR="#FFFFFF"

388

SIZE="3"

389

><B

390

>Libglade Build</B

391

></FONT

392

></TD

393

><TD

394

COLSPAN="2"

395

ALIGN="right"

396

><FONT

397

COLOR="#FFFFFF"

398

SIZE="3"

399

><B

400

>Exceptions</B

401

></FONT

402

></TD

403

></TR

404

></TABLE

405

></DIV

406

></BODY

407

></HTML

408

b'\\ No newline at end of file'

104

represent the various types in the same way.</p></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libglade-embedding.html"><b><<�Embedding Libglade Interfaces</b></a></td><td align="right"><a accesskey="n" href="libglade-dtd-exceptions.html"><b>Exceptions�>></b></a></td></tr></table></body></html>

Older »