INDEX CLUSTER FEATURES SHORT FRAMES NO FRAMES

indexing

title: "Visual Eiffel Library.", "Win32 API: Dialog Box Functions"
project: "Visual Eiffel Win32 Library"
revision: "$Revision: 1.1 $"
copyright: "Copyright (C) 1996-2005 Object Tools Group"
license: "http://visual-eiffel.com/license"
cluster: winlib
class WAPI_DIALOG_BOX_FUNCTIONS
inherit

WAPI_ERROR_SERVER
end
feature -- Access

CreateDialog (hinst: INTEGER; lpsztemplate: POINTER; hwndowner: INTEGER; dlgprc: POINTER): INTEGER
-- The 'CreateDialog' function creates a modeless dialog box
-- from a dialog box template resource.
require
correct_hinst: hinst /= null_
correct_lpsztemplate: lpsztemplate /= default_pointer
correct_dlgprc: dlgprc /= default_pointer

CreateDialogParam (hinst: INTEGER; lpsztemplate: POINTER; hwndowner: INTEGER; dlgprc: POINTER; lparaminit: INTEGER): INTEGER
-- The 'CreateDialogParam' function creates a modeless dialog box
-- from a dialog box template resource. Before displaying the dialog box,
-- the function passes an application-defined value to the dialog box
-- procedure as the lParam parameter of the the WM_INITDIALOG message.
-- An application can use this value to initialize dialog box controls.
require
correct_hinst: hinst /= null_
correct_lpsztemplate: lpsztemplate /= default_pointer
correct_dlgprc: dlgprc /= default_pointer

DialogBox (hinst: INTEGER; lpsztemplate: POINTER; hwndowner: INTEGER; dlgprc: POINTER): INTEGER
-- The 'DialogBox' function creates a modal dialog box from a dialog box
-- template resource. 'DialogBox' does not return control until the
-- specified callback function terminates the modal dialog box by
-- calling the 'EndDialog' procedure.
require
correct_hinst: hinst /= null_
correct_lpsztemplate: lpsztemplate /= default_pointer
correct_dlgprc: dlgprc /= default_pointer

DialogBoxParam (hinst: INTEGER; lpsztemplate: POINTER; hwndowner: INTEGER; dlgprc: POINTER; lparaminit: INTEGER): INTEGER
-- The 'DialogBoxParam' function creates a modal dialog box from a dialog
-- box template resource. Before displaying the dialog box, the function
-- passes an application-defined value to the dialog box procedure as
-- the lParam parameter of the WM_INITDIALOG message. An application can
-- use this value to initialize dialog box controls.
require
correct_hinst: hinst /= null_
correct_lpsztemplate: lpsztemplate /= default_pointer
correct_dlgprc: dlgprc /= default_pointer

EndDialog (hwnddlg, nresult: INTEGER)
-- The 'EndDialog' procedure destroys a modal dialog box, causing
-- the system to end any processing for the dialog box.
require
correct_hwnddlg: hwnddlg /= null_

GetDlgCtrlID (hwndctl: INTEGER): INTEGER
-- The 'GetDlgCtrlID' function returns the identifier
-- of the specified control.
require
correct_hwndctl: hwndctl /= null_

GetDlgItem (hwnddlg, idcontrol: INTEGER): INTEGER
-- The 'GetDlgItem' function retrieves the handle of a control in the
-- specified dialog box.
require
correct_hwnddlg: hwnddlg /= null_

GetDlgItemText (hwnddlg, idcontrol: INTEGER; lpsz: POINTER; cchmax: INTEGER): INTEGER
-- The 'GetDlgItemText' function retrieves the title or text associated
-- with a control in a dialog box.
require
correct_hwnddlg: hwnddlg /= null_
correct_lpsz: lpsz /= default_pointer

GetNextDlgGroupItem (hdlg, hctl, bprevoius: INTEGER): INTEGER
-- The 'GetNextDlgGroupItem' function retrieves the handle of the first
-- control in a group of controls that precedes (or follows)
-- the specified control in a dialog box.
require
correct_hdlg: hdlg /= null_

GetNextDlgTabItem (hdlg, hctl, bprevoius: INTEGER): INTEGER
-- The 'GetNextDlgTabItem' function retrieves the handle of the first
-- control that has the WS_TABSTOP style that precedes (or follows)
-- the specified control.
require
correct_hdlg: hdlg /= null_

IsDialogMessage (hwnddlg: INTEGER; lpmsg: POINTER): INTEGER
-- The 'IsDialogMessage' function determines whether a message
-- is intended for the specified dialog box and, if it is, processes
-- the message.
require
correct_lpmsg: lpmsg /= default_pointer

MessageBox (hwndowner: INTEGER; lpsztext, lpsztitle: POINTER; fustyle: BIT 32): INTEGER
-- The 'MessageBox' function creates, displays, and operates a message box.
-- The message box contains an application-defined message and title, plus
-- any combination of predefined icons and push buttons.
require
correct_lpsztext: lpsztext /= default_pointer

MessageBoxEx (hwndowner: INTEGER; lpsztext, lpszcaption: POINTER; fustyle, wlanguageid: BIT 32): INTEGER
-- The 'MessageBoxEx' function creates, displays, and operates a message
-- box. The message box contains an application-defined message and title,
-- plus any combination of predefined icons and push buttons. The
-- wLanguageId parameter specifies which set of language resources is used
-- for the predefined push buttons. For full descriptions of the other
-- parameters of 'MessageBoxEx', see 'MessageBox'.
require
correct_lpsztext: lpsztext /= default_pointer

SendDlgItemMessage (hwnddlg, idcontrol, umsg, wparam, lparam: INTEGER): INTEGER
-- The 'SendDlgItemMessage' function sends a message
-- to the specified control in a dialog box.
require
correct_hwnddlg: hwnddlg /= null_

SetDlgItemInt (hwnddlg, idcontrol, uvalue, fsigned: INTEGER)
-- The 'SetDlgItemInt' procedure sets the text of a control in a
-- dialog box to the string representation of a specified integer value.
require
correct_hwnddlg: hwnddlg /= null_
correct_fsigned: fsigned = 1 or fsigned = 0

SetDlgItemText (hwnddlg, idcontrol: INTEGER; lpsz: POINTER)
-- The 'SetDlgItemText' procedure sets the title or text of a control
-- in a dialog box.
require
correct_hwnddlg: hwnddlg /= null_
correct_lpsz: lpsz /= default_pointer
end -- class WAPI_DIALOG_BOX_FUNCTIONS

INDEX CLUSTER FEATURES SHORT FRAMES NO FRAMES