Gtk2_EntryDialog
[ class tree: Gtk2_EntryDialog ] [ index: Gtk2_EntryDialog ] [ all elements ]
Packages:
Gtk2_EntryDialog


Classes:
Gtk2_EntryDialog
Files:
EntryDialog.php
normal.php
simple.php
verysimple.php

Class: Gtk2_EntryDialog

Source Location: /Gtk2_EntryDialog-0.0.3/Gtk2/EntryDialog.php

Class Overview

GtkMessageDialog
   |
   --Gtk2_EntryDialog

Dialog message box with text entry field.


Author(s):

Version:

  • CVS: $Id$

Variables

Methods

Inherited Variables

Inherited Methods

Class Details

[line 23]
Dialog message box with text entry field.

There are three modes to use it:

  • Normal constructor with (somewhat complicated) parameters as known from GtkMessageDialog.
  • new_simple() static method constructor with only one required parameter.
  • Static get() method that just returns the inputted text instead of the dialog itself. This is the most convenient and code-saving method to get an input.
Even when the dialog has an OK button only, the user can cancel it by closing the window.

  • Author: Christian Weiske <cweiske@php.net>
  • Version: CVS: $Id$
  • License: LGPL


[ Top ]

Class Variables

$entry =

[line 29]

The entry box
  • Access: protected

Type:   GtkEntry


[ Top ]

$nDefaultResponseId =  null

[line 35]

The response id that is used as default
  • Access: protected

Type:   int


[ Top ]


Method Detail

__construct (Constructor)   [line 50]

Gtk2_EntryDialog __construct( GtkWindow $parent, GtkDialogFlags $flags, GtkMessageType $type, GtkButtonsType $buttons, string $message, [string $default = null])

Normal constructor.

Parameters are the same as for GtkMessageDialog.

  • Access: public

Parameters:

GtkWindow   $parent   —  Parent window (can be null)
GtkDialogFlags   $flags   —  Dialog flags (use 0 as default)
GtkMessageType   $type   —  Message type (e.g. Gtk::MESSAGE_QUESTION)
GtkButtonsType   $buttons   —  Buttons to show (e.g. Gtk::BUTTONS_OK)
string   $message   —  Message to display
string   $default   —  Default text for the entry

[ Top ]

get   [line 111]

string get( string $message, string $default, [GtkWidget $parent = null])

Creates a dialog with the given parameters (@see new_simple), runs it, and returns the text set.

If the user cancelled the dialog, this method returns FALSE. In any other case (even when the text is empty), the a string with the text is returned.

  • Return: Text input by the user
  • Access: public

Parameters:

string   $message   —  Message/question to display
string   $default   —  Default entry text
GtkWidget   $parent   —  Parent widget if any

[ Top ]

getText   [line 228]

string getText( )

Alias for get_text().
  • Return: The input from the user
  • Access: public

[ Top ]

get_text   [line 158]

string get_text( )

Retrieves the text from the entry
  • Return: The input from the user
  • Access: public

[ Top ]

new_simple   [line 87]

Gtk2_EntryDialog new_simple( string $message, [string $default = null], [GtkWidget $parent = null])

Simplified constructor with not so much parameters.

Message type is Gtk::MESSAGE_QUESTION, the flags will be Gtk::DIALOG_MODAL if the parent is set. Only one OK button will be visible.

  • Return: Entry dialog instance
  • Access: public

Parameters:

string   $message   —  Message/question to display
string   $default   —  Default entry text
GtkWidget   $parent   —  Parent widget if any

[ Top ]

onActivateEntry   [line 184]

void onActivateEntry( )

Callback for the entry text.

Activates the default button.

  • Access: public

[ Top ]

run   [line 132]

int run( )

Show the dialog and block until a button has been pressed.
  • Return: The response id of the pressed button.
  • Access: public

[ Top ]

setRefaultResponse   [line 204]

void setRefaultResponse( int $response_id)

Alias for set_default_response()
  • Access: public

Parameters:

int   $response_id   —  Response code

[ Top ]

setText   [line 216]

void setText( string $text)

Alias for set_text().
  • Access: public

Parameters:

string   $text   —  The text to set

[ Top ]

set_default_response   [line 172]

void set_default_response( int $response_id)

Set the default response.

The button with the id will be the default one, allowing you to just press return to activate it

  • Access: public

Parameters:

int   $response_id   —  Response code

[ Top ]

set_text   [line 146]

void set_text( string $text)

Sets the text for the entry
  • Access: public

Parameters:

string   $text   —  The text to set

[ Top ]
Documentation generated on Mon, 11 Mar 2019 14:38:29 -0400 by phpDocumentor 1.4.4. PEAR Logo Copyright © PHP Group 2004.