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
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
|
<Type Name="Dialog" FullName="Gtk.Dialog">
<TypeSignature Language="C#" Maintainer="Duncan Mak" Value="public class Dialog : Gtk.Window" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit Dialog extends Gtk.Window" />
<AssemblyInfo>
<AssemblyName>gtk-sharp</AssemblyName>
<AssemblyPublicKey>
</AssemblyPublicKey>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>Gtk.Window</BaseTypeName>
</Base>
<Interfaces>
</Interfaces>
<Docs>
<summary>Creates popup windows.</summary>
<remarks>
<para>
<see cref="T:Gtk.Dialog" /> boxes are a convenient way to prompt the user for a small amount of input, eg. to display a message, ask a question, or anything else that does not require extensive effort by the user.</para>
<para>Gtk# treats a dialog as a window split vertically. The top section is a <see cref="T:Gtk.VBox" />, and is where widgets such as a <see cref="T:Gtk.Label" /> or an <see cref="T:Gtk.Entry" /> should be packed. The bottom area is known as the <see cref="P:Gtk.Dialog.ActionArea" />. This is generally used for packing buttons into the dialog which may perform functions such as cancel, ok, or apply. The two areas are separated by a <see cref="T:Gtk.HSeparator" />.</para>
<para>The two primary areas of a dialog can be accessed as the <see cref="P:Gtk.Dialog.Vbox" /> property and the <see cref="P:Gtk.Dialog.ActionArea" /> property. To set the dialog to be modal, use the <see cref="P:Gtk.Window.Modal" /> property.</para>
<para>If you want to block waiting for a dialog to return before returning control flow to your code, you can call <see cref="M:Gtk.Dialog.Run" />. This function enters a recursive main loop and waits for the user to respond to the dialog, returning the <see cref="T:Gtk.ResponseType" /> corresponding to the <see cref="T:Gtk.Button" /> the user clicked.</para>
<para>For a simple dialog, you would probably use <see cref="T:Gtk.MessageDialog" /> to save yourself some effort. However, you would need to create the <see cref="T:Gtk.Dialog" /> contents manually if you had more than a simple message in the <see cref="T:Gtk.Dialog" />.</para>
<example>
<code lang="C#">
using System;
using Gtk;
namespace GtkDialogSample
{
public class GtkDialogSample
{
Dialog dialog;
Window win;
static void Main()
{
new GtkDialogSample ();
}
GtkDialogSample ()
{
Application.Init ();
win = new Window ("Test");
win.SetDefaultSize (250, 250);
win.DeleteEvent += delegate {
Application.Quit ();
}
Button btn = new Button ("Show About");
btn.Clicked += on_btn_clicked;
win.Add (btn);
win.ShowAll ();
Application.Run ();
}
void on_btn_clicked (object obj, EventArgs args)
{
dialog = new Dialog
("Sample", win, Gtk.DialogFlags.DestroyWithParent);
dialog.Modal = true;
dialog.AddButton ("Close", ResponseType.Close);
dialog.Response += on_dialog_response;
dialog.Run ();
dialog.Destroy ();
}
void on_dialog_response (object obj, ResponseArgs args)
{
Console.WriteLine (args.ResponseId);
}
}
}
</code>
</example>
<para>
You also can subclass the <see cref="T:Gtk.Dialog" /> when you want to use the same Dialog on several places in your application.
</para>
<example>
<code lang="C#">
using System;
using Gtk;
namespace GtkDialogSample
{
public class MyDialog:Dialog
{
public MyDialog(Window w,DialogFlags f ):base("Sample", w, f)
{
this.Modal = true;
this.AddButton ("Close", ResponseType.Close);
}
protected override void OnResponse (ResponseType response_id){
Console.WriteLine (response_id);
}
}
public class GtkDialogSample
{
MyDialog dialog;
Window win;
static void Main()
{
new GtkDialogSample ();
}
GtkDialogSample ()
{
Application.Init ();
win = new Window ("Test");
win.SetDefaultSize (250, 250);
win.DeleteEvent += new DeleteEventHandler (on_win_delete);
Button btn = new Button ("Show About");
btn.Clicked += new EventHandler (on_btn_clicked);
win.Add (btn);
win.ShowAll ();
Application.Run ();
}
void on_btn_clicked (object obj, EventArgs args)
{
dialog = new MyDialog(win, Gtk.DialogFlags.DestroyWithParent);
dialog.Run ();
dialog.Destroy ();
}
void on_win_delete (object obj, DeleteEventArgs args)
{
Application.Quit ();
}
}
}
</code>
</example>
</remarks>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public Dialog ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters />
<Docs>
<summary>Creates a new dialog box.</summary>
<remarks>
Creates a new dialog box.
This is an internal constructor, and should not be used by user code.
</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public Dialog (IntPtr raw);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(native int raw) cil managed" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="raw" Type="System.IntPtr" />
</Parameters>
<Docs>
<param name="raw">Pointer to the C object.</param>
<summary>Internal constructor</summary>
<remarks>
<para>This is an internal constructor, and should not be used by user code.</para>
</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public Dialog (string title, Gtk.Window parent, Gtk.DialogFlags flags, object[] button_data);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string title, class Gtk.Window parent, valuetype Gtk.DialogFlags flags, object[] button_data) cil managed" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="title" Type="System.String" />
<Parameter Name="parent" Type="Gtk.Window" />
<Parameter Name="flags" Type="Gtk.DialogFlags" />
<Parameter Name="button_data" Type="System.Object[]">
<Attributes>
<Attribute>
<AttributeName>System.ParamArray</AttributeName>
</Attribute>
</Attributes>
</Parameter>
</Parameters>
<Docs>
<param name="title">a title <see cref="T:System.String" /></param>
<param name="parent">a parent <see cref="T:Gtk.Window" />, or <see langword="null" /> for an unparented dialog.</param>
<param name="flags">dialog characteristic such as modality and destruction policy.</param>
<param name="button_data">a list of button text/response pairs if desired.</param>
<summary>Creates a new dialog box.</summary>
<remarks>
<para>Creates a new <see cref="T:Gtk.Dialog" /> with the specified title and parent widget.</para>
<para>
The <see cref="T:Gtk.DialogFlags" /> argument can be used to make the dialog modal (<see cref="F:Gtk.DialogFlags.Modal" />)
and/or to have it destroyed along with its parent (<see cref="F:Gtk.DialogFlags.DestroyWithParent" />).
</para>
<example>
<code lang="C#">
using System;
using Gtk;
class MainClass
{
public static void Main (string[] args)
{
Application.Init ();
// Shows two buttons that use stock icons, and a custom button
// Add button will return 1000
// Delete button will return 2000
// "My Own Butotn" will return 3000
Dialog d = new Gtk.Dialog ("What to do?", null, DialogFlags.Modal,
Stock.Add, 1000,
Stock.Delete, 2000,
"My Own Button", 3000);
int response = d.Run ();
if (response == (int) ResponseType.DeleteEvent)
Console.WriteLine ("The user closed the dialog box");
Console.WriteLine (response);
}
}
</code>
</example>
</remarks>
<since version="Gtk# 2.4" />
</Docs>
</Member>
<Member MemberName="ActionArea">
<MemberSignature Language="C#" Value="public Gtk.ButtonBox ActionArea { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class Gtk.ButtonBox ActionArea" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gtk.ButtonBox</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>The area of the Dialog where the action widgets are placed.</summary>
<value>a <see cref="T:Gtk.HButtonBox" /></value>
<remarks />
</Docs>
</Member>
<Member MemberName="AddActionWidget">
<MemberSignature Language="C#" Value="public void AddActionWidget (Gtk.Widget child, Gtk.ResponseType response);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void AddActionWidget(class Gtk.Widget child, valuetype Gtk.ResponseType response) cil managed" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="child" Type="Gtk.Widget" />
<Parameter Name="response" Type="Gtk.ResponseType" />
</Parameters>
<Docs>
<param name="child">a <see cref="T:Gtk.Widget" /></param>
<param name="response">a <see cref="T:Gtk.ResponseType" /></param>
<summary>Adds an activatable widget to the <see cref="T:Gtk.Dialog.ActionArea" /> of a <see cref="T:Gtk.Dialog" />.</summary>
<remarks>
Adds an activatable <see cref="T:Gtk.Widget" /> to the <see cref="T:Gtk.Dialog.ActionArea" /> of a <see cref="T:Gtk.Dialog" />, connecting a signal handler that will <see cref="E:Gtk.Dialog.Response" /> on the <see cref="T:Gtk.Dialog" /> when the <see cref="T:Gtk.Widget" /> is activated.
The <see cref="T:Gtk.Widget" /> is appended to the end of the <see cref="T:Gtk.Dialog.ActionArea" />. If you want to add a non-activatable <see cref="T:Gtk.Widget" />, simply pack it into the <see cref="T:Gtk.Dialog.ActionArea" /> field of the <see cref="T:Gtk.Dialog" />.
</remarks>
</Docs>
</Member>
<Member MemberName="AddActionWidget">
<MemberSignature Language="C#" Value="public void AddActionWidget (Gtk.Widget child, int response_id);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void AddActionWidget(class Gtk.Widget child, int32 response_id) cil managed" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="child" Type="Gtk.Widget" />
<Parameter Name="response_id" Type="System.Int32" />
</Parameters>
<Docs>
<param name="child">an object of type <see cref="T:Gtk.Widget" />.</param>
<param name="response_id">an object of type <see cref="T:System.UInt32" />.</param>
<summary>Adds an activatable widget to the <see cref="T:Gtk.Dialog.ActionArea" /> of a <see cref="T:Gtk.Dialog" />.</summary>
<remarks>
Adds an activatable <see cref="T:Gtk.Widget" /> to the <see cref="T:Gtk.Dialog.ActionArea" /> of a <see cref="T:Gtk.Dialog" />, connecting a signal handler that will <see cref="E:Gtk.Dialog.Response" /> on the <see cref="T:Gtk.Dialog" /> when the <see cref="T:Gtk.Widget" /> is activated.
The <see cref="T:Gtk.Widget" /> is appended to the end of the <see cref="T:Gtk.Dialog.ActionArea" />. If you want to add a non-activatable <see cref="T:Gtk.Widget" />, simply pack it into the <see cref="T:Gtk.Dialog.ActionArea" /> field of the <see cref="T:Gtk.Dialog" />.
</remarks>
</Docs>
</Member>
<Member MemberName="AddButton">
<MemberSignature Language="C#" Value="public Gtk.Widget AddButton (string button_text, Gtk.ResponseType response);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance class Gtk.Widget AddButton(string button_text, valuetype Gtk.ResponseType response) cil managed" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>Gtk.Widget</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="button_text" Type="System.String" />
<Parameter Name="response" Type="Gtk.ResponseType" />
</Parameters>
<Docs>
<param name="button_text">a <see cref="T:System.String" />, text for the button</param>
<param name="response">a <see cref="T:Gtk.ResponseType" />, the numeric response code emitted when the button is pressed.</param>
<summary>Adds a new response button to the dialog.</summary>
<returns>a <see cref="T:Gtk.Widget" />representing the button added.</returns>
<remarks />
<since version="Gtk# 2.4" />
</Docs>
</Member>
<Member MemberName="AddButton">
<MemberSignature Language="C#" Value="public Gtk.Widget AddButton (string button_text, int response_id);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance class Gtk.Widget AddButton(string button_text, int32 response_id) cil managed" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>Gtk.Widget</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="button_text" Type="System.String" />
<Parameter Name="response_id" Type="System.Int32" />
</Parameters>
<Docs>
<param name="button_text">an object of type <see cref="T:System.String" />.</param>
<param name="response_id">an object of type <see cref="T:System.UInt32" />.</param>
<summary>Adds a <see cref="T:Gtk.Button" /> with the given text.</summary>
<returns>an object of type <see cref="T:Gtk.Widget" /></returns>
<remarks>
Adds a <see cref="T:Gtk.Button" /> with the given text (or a stock button, if button_text is a stock ID)
and sets things up so that clicking the <see cref="T:Gtk.Button" /> will emit a <see cref="E:Gtk.Dialog.Response" /> with the given response_id.
The <see cref="T:Gtk.Button" /> is appended to the end of the <see cref="T:Gtk.Dialog.ActionArea" />.
The <see cref="T:Gtk.Button" /> is returned, but usually you do not need it.
</remarks>
</Docs>
</Member>
<Member MemberName="AlternativeButtonOrder">
<MemberSignature Language="C#" Value="public int[] AlternativeButtonOrder { set; }" />
<MemberSignature Language="ILAsm" Value=".property instance int32[] AlternativeButtonOrder" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Int32[]</ReturnType>
</ReturnValue>
<Docs>
<summary>AlternativeButtonOrder property.</summary>
<value>An array of Response IDs.</value>
<remarks>Sets the button order to an alternative arrangement when the gtk-alternive-button-order setting is <see langword="true" />.</remarks>
<since version="Gtk# 2.10" />
</Docs>
</Member>
<Member MemberName="Close">
<MemberSignature Language="C#" Value="public event EventHandler Close;" />
<MemberSignature Language="ILAsm" Value=".event class System.EventHandler Close" />
<MemberType>Event</MemberType>
<Attributes>
<Attribute>
<AttributeName>GLib.Signal("close")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.EventHandler</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Emitted when the dialog is closed.</summary>
<remarks />
</Docs>
</Member>
<Member MemberName="ContentArea">
<MemberSignature Language="C#" Value="public Gtk.Box ContentArea { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class Gtk.Box ContentArea" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gtk.Box</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
<since version="Gtk# 3.0" />
</Docs>
</Member>
<Member MemberName="DefaultResponse">
<MemberSignature Language="C#" Value="public Gtk.ResponseType DefaultResponse { set; }" />
<MemberSignature Language="ILAsm" Value=".property instance valuetype Gtk.ResponseType DefaultResponse" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gtk.ResponseType</ReturnType>
</ReturnValue>
<Docs>
<summary>Sets the default response_id.</summary>
<value>a <see cref="T:Gtk.ResponseType" /></value>
<remarks>Sets the default response_id.</remarks>
</Docs>
</Member>
<Member MemberName="GetResponseForWidget">
<MemberSignature Language="C#" Value="public int GetResponseForWidget (Gtk.Widget widget);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance int32 GetResponseForWidget(class Gtk.Widget widget) cil managed" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Int32</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="widget" Type="Gtk.Widget" />
</Parameters>
<Docs>
<param name="widget">A <see cref="T:Gtk.Widget" /> in the action area of the dialog.</param>
<summary>Gets the response id associated with an action area Widget.</summary>
<returns>an <see cref="T:System.Int32" /> representing the response id or <see cref="F:Gtk.Response.None" /> if the widget has no response id set.</returns>
<remarks />
<since version="Gtk# 2.8" />
</Docs>
</Member>
<Member MemberName="GetWidgetForResponse">
<MemberSignature Language="C#" Value="public Gtk.Widget GetWidgetForResponse (int response_id);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance class Gtk.Widget GetWidgetForResponse(int32 response_id) cil managed" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>Gtk.Widget</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="response_id" Type="System.Int32" />
</Parameters>
<Docs>
<param name="response_id">To be added.</param>
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
<since version="Gtk# 3.0" />
</Docs>
</Member>
<Member MemberName="GType">
<MemberSignature Language="C#" Value="public static GLib.GType GType { get; }" />
<MemberSignature Language="ILAsm" Value=".property valuetype GLib.GType GType" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>GLib.GType</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>GType Property.</summary>
<value>a <see cref="T:GLib.GType" /></value>
<remarks>Returns the native <see cref="T:GLib.GType" /> value for <see cref="T:Gtk.Dialog" />.</remarks>
</Docs>
</Member>
<Member MemberName="OnClose">
<MemberSignature Language="C#" Value="protected virtual void OnClose ();" />
<MemberSignature Language="ILAsm" Value=".method familyhidebysig newslot virtual instance void OnClose() cil managed" />
<MemberType>Method</MemberType>
<Attributes>
<Attribute>
<AttributeName>GLib.DefaultSignalHandler(ConnectionMethod="OverrideClose", Type=typeof(Gtk.Dialog))</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Default handler for the <see cref="M:Gtk.Dialog.Close" /> event.</summary>
<remarks>Override this method in a subclass to provide a default handler for the <see cref="M:Gtk.Dialog.Close" /> event.</remarks>
</Docs>
</Member>
<Member MemberName="OnResponse">
<MemberSignature Language="C#" Value="protected virtual void OnResponse (Gtk.ResponseType response_id);" />
<MemberSignature Language="ILAsm" Value=".method familyhidebysig newslot virtual instance void OnResponse(valuetype Gtk.ResponseType response_id) cil managed" />
<MemberType>Method</MemberType>
<Attributes>
<Attribute>
<AttributeName>GLib.DefaultSignalHandler(ConnectionMethod="OverrideResponse", Type=typeof(Gtk.Dialog))</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="response_id" Type="Gtk.ResponseType" />
</Parameters>
<Docs>
<param name="response_id">a <see cref="T:System.Int32" /></param>
<summary>Default handler for the <see cref="M:Gtk.Dialog.Response" /> event.</summary>
<remarks>Override this method in a subclass to provide a default handler for the <see cref="M:Gtk.Dialog.Response" /> event.</remarks>
</Docs>
</Member>
<Member MemberName="Respond">
<MemberSignature Language="C#" Value="public void Respond (Gtk.ResponseType response);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Respond(valuetype Gtk.ResponseType response) cil managed" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="response" Type="Gtk.ResponseType" />
</Parameters>
<Docs>
<param name="response">a <see cref="T:System.Int32" />, the chosen response.</param>
<summary>Activate one of the responses.</summary>
<remarks />
</Docs>
</Member>
<Member MemberName="Respond">
<MemberSignature Language="C#" Value="public void Respond (int response_id);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Respond(int32 response_id) cil managed" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="response_id" Type="System.Int32" />
</Parameters>
<Docs>
<param name="response_id">an object of type <see cref="T:System.UInt32" />.</param>
<summary>Emits the <see cref="E:Gtk.Dialog.Response" /> event with the given response ID.</summary>
<remarks>
Emits the <see cref="E:Gtk.Dialog.Response" /> event with the given response ID.
Used to indicate that the user has responded to the <see cref="T:Gtk.Dialog" /> in some way;
typically either you or <see cref="M:Gtk.Dialog.Run()" /> will be monitoring the <see cref="E:Gtk.Dialog.Response" /> event and take appropriate action.
</remarks>
</Docs>
</Member>
<Member MemberName="Response">
<MemberSignature Language="C#" Value="public event Gtk.ResponseHandler Response;" />
<MemberSignature Language="ILAsm" Value=".event class Gtk.ResponseHandler Response" />
<MemberType>Event</MemberType>
<Attributes>
<Attribute>
<AttributeName>GLib.Signal("response")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>Gtk.ResponseHandler</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>
Emitted when an action widget is clicked, the <see cref="T:Gtk.Dialog" />
receives a delete event, or the application programmer calls <see cref="M:Gtk.Dialog.Respond(System.Int32)" />.
</summary>
<remarks>
On a delete event, the response ID is <see cref="F:Gtk.ResponseType.None" />.
Otherwise, it depends on which action widget was clicked.
</remarks>
</Docs>
</Member>
<Member MemberName="Run">
<MemberSignature Language="C#" Value="public int Run ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance int32 Run() cil managed" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Int32</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Waits for the <see cref="E:Gtk.Dialog.Response" /> event or the <see cref="T:Gtk.Dialog" /> to be destroyed.</summary>
<returns>an object of type <see cref="T:System.UInt32" />.</returns>
<remarks>
<para>
Waits for the <see cref="E:Gtk.Dialog.Response" /> event or the <see cref="T:Gtk.Dialog" /> to be destroyed.
If the <see cref="T:Gtk.Dialog" /> is destroyed during the call to <see cref="M:Gtk.Dialog.Run()" />, <see cref="T:Gtk.Dialog" /> returns <see cref="F:Gtk.ResponseType.None" />.
Otherwise, it returns the response ID from the <see cref="E:Gtk.Dialog.Response" /> event.
Before entering the recursive main loop, <see cref="M:Gtk.Dialog.Run()" /> calls <see cref="M:Gtk.Widget.Show()" /> on the <see cref="T:Gtk.Dialog" /> for you.
Note that you still need to show any children of the <see cref="T:Gtk.Dialog" /> yourself.
</para>
<para>
During <see cref="M:Gtk.Dialog.Run()" />, the default behavior of <see cref="E:Gtk.Window.DeleteEvent" /> is disabled;
if the <see cref="T:Gtk.Dialog" /> receives <see cref="E:Gtk.Window.DeleteEvent" />, it will not be destroyed as usual, and <see cref="M:Gtk.Dialog.Run()" /> will return <see cref="F:Gtk.ResponseType.DeleteEvent" />.
Also, during <see cref="M:Gtk.Dialog.Run()" /> the <see cref="T:Gtk.Dialog" /> will be modal.
You can force <see cref="M:Gtk.Dialog.Run()" /> to return at any time by calling <see cref="M:Gtk.Dialog.Respond" /> to emit the <see cref="E:Gtk.Dialog.Response" /> event.
Destroying the <see cref="T:Gtk.Dialog" /> during <see cref="M:Gtk.Dialog.Run()" /> is a very bad idea, because your post-run code will not know whether the <see cref="T:Gtk.Dialog" /> was destroyed or not.
</para>
<para>
After <see cref="M:Gtk.Dialog.Run()" /> returns, you are responsible for hiding or destroying the <see cref="T:Gtk.Dialog" /> if you wish to do so.
</para>
</remarks>
</Docs>
</Member>
<Member MemberName="SetAlternativeButtonOrderFromArray">
<MemberSignature Language="C#" Value="public int SetAlternativeButtonOrderFromArray (int n_params);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance int32 SetAlternativeButtonOrderFromArray(int32 n_params) cil managed" />
<MemberType>Method</MemberType>
<Attributes>
<Attribute>
<AttributeName>System.Obsolete("Replaced by AlternativeButtonOrder property")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Int32</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="n_params" Type="System.Int32" />
</Parameters>
<Docs>
<param name="n_params">a <see cref="T:System.Int32" /></param>
<summary>To be added</summary>
<returns>a <see cref="T:System.Int32" /></returns>
<remarks>To be added</remarks>
<since version="Gtk# 2.6" />
</Docs>
</Member>
<Member MemberName="SetResponseSensitive">
<MemberSignature Language="C#" Value="public void SetResponseSensitive (Gtk.ResponseType response_id, bool setting);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void SetResponseSensitive(valuetype Gtk.ResponseType response_id, bool setting) cil managed" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="response_id" Type="Gtk.ResponseType" />
<Parameter Name="setting" Type="System.Boolean" />
</Parameters>
<Docs>
<param name="response_id">a <see cref="T:System.Int32" /></param>
<param name="setting">a <see cref="T:System.Boolean" /></param>
<summary>A convenient way to sensitize/desensitize dialog buttons.</summary>
<remarks>Sets <see cref="P:Gtk.Widget.Sensitive" /> = <see langword="true" /> for each widget in the <see cref="P:Gtk.Dialog.ActionArea" /> with the given response_id. A convenient way to sensitize/desensitize dialog buttons.</remarks>
</Docs>
</Member>
</Members>
</Type>
|
