The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Win32::GUI::ComboboxEx - Create and manipulate extended combobox controls

DESCRIPTION

[TBD]

METHODS

Common methods apply to most windows, controls and resources.

new

new(PARENT, %OPTIONS)

Creates a new ComboboxEx object; can also be called as PARENT->AddComboboxEx(%OPTIONS).

Class specific %OPTIONS are:

  -imagelist => Win32::GUI::ImageList object
    Set Imagelist object
  -casesensitive => 0/1 (default 0)
    Set/Unset casesensitive extended style.
  -noeditimage => 0/1 (default 0)
    Set/Unset noeditimage extended style.
  -noeditimageindent => 0/1 (default 0)
    Set/Unset noeditimageindent extended style.
  -nosizelimit => 0/1 (default 0)
    Set/Unset nosizelimit extended style.

Except for images, a ComboboxEx object acts like a Win32::GUI::Combobox object. See also new Win32::GUI::Combobox().

See also the common options.

DeleteItem

DeleteItem(INDEX)

Delete an indexed item of the control's list.

GetComboControl

GetComboControl()

Retrieves the handle to the child combo box control.

GetEditControl

GetEditControl()

Retrieves the handle to the edit control portion of a ComboBoxEx control.

GetExtendedStyle

GetExtendedStyle()

Retrieves the extended styles that are in use for a ComboBoxEx control.

GetImageList

GetImageList()

Retrieves the handle to an image list assigned to a ComboBoxEx.

GetItem

GetItem(NODE)

Retrieves item information for a given ComboBoxEx item.

GetUnicodeFormat

GetUnicodeFormat()

Retrieves the UNICODE character format flag for the control.

HasEditChanged

HasEditChanged()

Determines if the user has changed the contents of the ComboBoxEx edit control by typing.

InsertItem

InsertItem(%OPTIONS)

Inserts a new item in the ComboboxEx control. Returns the newly created item zero-based index or -1 on errors.

%OPTIONS can be:

  -index => position (-1 for the end of the list)
  -image => index of an image from the associated ImageList
  -selectedimage => index of an image from the associated ImageList
  -text => string
  -indent => indentation spaces (1 space == 10 pixels)

SetExtendedStyle

SetExtendedStyle(mask, exstyle)

Sets extended styles within a ComboBoxEx control.

SetImageList

SetImageList(imagelist)

Sets an image list for a ComboBoxEx control.

SetItem

SetItem(%OPTIONS)

Sets the attributes for an item in a ComboBoxEx control.

%OPTIONS can be:

  -image => index of an image from the associated ImageList
  -selectedimage => index of an image from the associated ImageList
  -text => string
  -indent => indentation spaces (1 space == 10 pixels)

SetUnicodeFormat

SetUnicodeFormat(FLAG)

Sets the UNICODE character format flag for the control.

EVENTS

Common events apply to most windows and controls.

Change (Win32::GUI::Combobox)

Change()

Sent when the user selects an item from the Combobox

CloseUp (Win32::GUI::Combobox)

CloseUp()

Sent when the list box of a combo box has been closed. This event allows you to populate the dropdown dynamically. This event is only fired if the combo box has the CBS_DROPDOWN or CBS_DROPDOWNLIST style.

If the user changed the current selection, the combo box also sends the Change event when the drop-down list closes. In general, you cannot predict the order in which notifications will be sent. In particular, a Change event message may occur either before or after a CloseUp event.

DblClick (Win32::GUI::Combobox)

DblClick()

Sent when the user double clicks on an item from the Combobox

DropDown()

Sent when the user selects the list box. This event allows you to populate the dropdown dynamically. This event is only fired if the combo box has the CBS_DROPDOWN or CBS_DROPDOWNLIST style.

GotFocus (Win32::GUI::Combobox)

GotFocus()

Sent when the control is activated.

LostFocus (Win32::GUI::Combobox)

LostFocus()

Sent when the control is deactivated.

VERSION

Documentation for Win32::GUI v1.08_06 created 13 Oct 2014

This document is autogenerated by the build process. Edits made here will be lost. Edit docs/per_package.tpl instead.

SUPPORT

Homepage: http://perl-win32-gui.sourceforge.net/.

For further support join the users mailing list from the website at http://lists.sourceforge.net/lists/listinfo/perl-win32-gui-users. There is a searchable list archive at http://sourceforge.net/p/perl-win32-gui/mailman/perl-win32-gui-users/.

COPYRIGHT and LICENCE

Copyright (c) 1997..2014 Aldo Calpini. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.