INDEX CLUSTER FEATURES SHORT FRAMES NO FRAMES

indexing

title: "Control which combines a list box and an edit control. ", "WEL: library of reusable components for Eiffel. ", "Based on WEL library for ISE Eiffel, used with permission. "
project: "Windows Eiffel Library"
copyright: "(c) 1986-1997 Interactive Software Engineering Inc. ", "Modifications and extensions: ", "(c) 1997-2001 Object Tools ", "All rights reserved. Duplication and distribution prohibited", "May be used only with Visual Eiffel under terms of user ", "license "
cluster: wel
deferred class WEL_COMBO_BOX
inherit

WEL_CONTROL
redefine
process_notification,
text_length
end

WEL_CB_CONSTANTS
export
{NONE}
all
end

WEL_CBN_CONSTANTS
export
{NONE}
all
end
feature -- Access

i_th_text (i: INTEGER): STRING
-- Text at the zero-based index `i'
require
exists: exists
i_large_enough: i >= 0
i_small_enough: i < count
ensure
result_exists: Result /= void

i_th_text_length (i: INTEGER): INTEGER
-- Length text at the zero-based index `i'
require
exists: exists
i_large_enough: i >= 0
i_small_enough: i < count
ensure
positive_result: Result >= 0
feature -- Basic operations

find_string (index: INTEGER; a_string: STRING): INTEGER
-- Find the first string that contains the
-- prefix `a_string'. `index' specifies the
-- zero-based index of the item before the first
-- item to be searched.
-- Returns -1 if the search was unsuccessful.
require
exists: exists
index_large_enough: index >= 0
index_small_enough: index < count
a_string_not_void: a_string /= void

find_string_exact (index: INTEGER; a_string: STRING): INTEGER
-- Find the first string that matches `a_string'.
-- `index' specifies the zero-based index of the
-- item before the first item to be searched.
-- Returns -1 if the search was unsuccessful.
require
exists: exists
index_large_enough: index >= 0
index_small_enough: index < count
a_string_not_void: a_string /= void
feature -- Element change

add_string (a_string: STRING)
-- Add `a_string' in the combo box.
require
exists: exists
a_string_not_void: a_string /= void
ensure
new_count: count = count + 1

insert_string_at (a_string: STRING; index: INTEGER)
-- Add `a_string' at the zero-based `index'.
require
exists: exists
a_string_not_void: a_string /= void
index_small_enough: index <= count
index_large_enough: index >= 0
ensure
new_count: count = count + 1

delete_string (index: INTEGER)
-- Delete the item at the zero-based `index'.
require
exists: exists
index_large_enough: index >= 0
index_small_enough: index < count
ensure
new_count: count = count - 1

add_files (attribut: INTEGER; files: STRING)
-- Add `files' to the combo box. `files' may contain
-- wildcards (?*). See class WEL_DDL_CONSTANTS for
-- `attribut' values.
require
exists: exists
files_not_void: files /= void

reset_content
-- Reset the content of the list.
require
exists: exists
ensure
new_count: count = 0
feature -- Status setting

select_item (index: INTEGER)
-- Select item at the zero-based `index'.
require
exists: exists
index_large_enough: index >= 0
index_small_enough: index < count
ensure
selected_item: selected_item = index
feature -- Status report

selected: BOOLEAN
-- Is an item selected?
require
exists: exists

selected_item: INTEGER
-- Zero-based index of the selected item
require
exists: exists
selected: selected
ensure
result_large_enough: Result >= 0
result_small_enough: Result < count

selected_string: STRING
-- String currently selected
require
exists: exists
selected: selected
ensure
result_not_void: Result /= void

dropped_rect: WEL_RECT
-- Rectangle of the drop down list box
require
exists: exists
ensure
result_not_void: Result /= void

text_length: INTEGER
-- Text length
feature -- Measurement

count: INTEGER
-- Number of lines
require
exists: exists
ensure
positive_result: Result >= 0
feature -- Notifications

on_cbn_closeup
-- The combo box has been closed.
require
exists: exists

on_cbn_dblclk
-- The user double-clicks a string in the list box.
require
exists: exists

on_cbn_dropdown
-- The list box is about to be made visible.
require
exists: exists

on_cbn_editchange
-- The user has taken an action that may have altered
-- the text in the edit control portion.
require
exists: exists

on_cbn_editupdate
-- The edit control portion is about to
-- display altered text.
require
exists: exists

on_cbn_errspace
-- The combo box can not allocate enough memory to
-- meet a specific request.
require
exists: exists

on_cbn_killfocus
-- The combo box loses the keyboard focus.
require
exists: exists

on_cbn_selchange
-- The selection is about to be changed.
require
exists: exists

on_cbn_selendcancel
-- The user selects an item, but then selects another
-- control or closes the dialog box.
require
exists: exists

on_cbn_selendok
-- The user selects a list item, or selects
-- an item an then closes the list.
require
exists: exists

on_cbn_setfocus
-- The combo box receives the keyboard focus.
require
exists: exists
end -- class WEL_COMBO_BOX

INDEX CLUSTER FEATURES SHORT FRAMES NO FRAMES