cValue

Определяет источник для значений, отображаемых в элементе управления.

Замечание
Когда вы устанавливаете значение для свойства RowSource програмнным способом, вы должны взять это значение в кавычки ("").

В приведенной ниже таблице перечислены возможные значения для cValue.

cValue	Описание
Nothing	Элемент управления заполняется в run time с помощью методов AddItem или AddListItem или с помощью свойств List или ListItem. (По умолчанию) Для получения более подробной информации смотрите описания Метод AddItem, Метод AddListItem Method, Свойство List и Свойство ListItem.
Val1,Val2,Val3,...	A comma-delimited list of values. Элемент управления заполняется значениями из разделенного запятыми списка значений.
TableAlias	Псевдоимя открытой таблицы. Элемент управления заполняется значениями из полей таблицы.
SQLSELECTStatement	Предложение SQL SELECT, которое создает курсор или таблицу, например, "SELECT * FROM  Table". Элемент управления заполняется значениями из колонок курсора или таблицы, созданной предложнием SQL. Замечание При исполнении предложения SQL SELECT появляется окно просмотра (browse).
MyQueryFile.qpr	Имя файла запроса (.qpr). Замечание Убедитесь, что вы указали расширение имени файла .qpr. При исполнении запроса появляется окно просмотра (browse). Элемент управления заполняется значениями из колонок результата запроса.
myArray	Имя массива. Элемент управления заполняется значениями из массива.
TableAlias.Field1, Field2, Field3, ...	Разделенный запятыми список полкй из одной открытой таблицы, который может быть предварен псевдоименем таблицы и разделяющей его и список точой. Элемент управления заполняется значениями из полей. Свойство ColumnCount должно соответствовать числе указанных полей.
*.fileExt	Шаблон файла (например, "*.dbf" or "*.txt") или маска. Элемент управления заполняется именами файлов из текущего каталога наряду с опциями, позволяющими выбрать другой диск или каталог, содержащий файлы.
TableName or TableAlias	Имя или псевдоимя таблицы. Элемент управления заполняется именами полей из таблицы. Замечание Когда свойство RowSourceType установлено в значение, равное8, а его свойство RowSource не заполнено, то элемент управления заполняется именами полей из текущей открытой таблицы. В противном случае, если свойство RowSource указывает имя таблицы, псевдоимя таблицы или имя базы данных, элемент управления заполняется именами полей из указанного источника.
MenuName	Имя меню. Вклчюено для совместимости назад.
CollectionName [, CollectionMemberProp [, CollectionMemberProp2 [, ...]]]	CollectionName указывает строку, содержащую выражение, которое оценивается в объект коллекции Visual FoxPro или коллекцию COM объекта. Вы можете, кроме того, указать свойства объектов в коллекции. Элемент управления заполняется значениями свойства, указанными наряду с другими членами коллекции, которые не являются объектами. Замечание Когда вы указываете коллекцию и свойства объектов в коллекции в качестве значения свойства RowSource, значения каждого свойства отображаются в отдельной колонке. Члены коллекции, которые не являются объектами, отображаются в первой колонке. Замечание Если вы не указали никаких свойств для RowSource, то элемент управления отображает других членов коллекции, которые не являются объектами и строку "(Object)" для каждого объекта коллекции в одной колонке. Строка "(Object)" возвращается для свойства Value. Для получения более подробной информации смотрите описание свойства Value.

Применяется к: ComboBox | ListBox

Вы можете отображать в элементе управления множество колонок соответствующей установкой свойства ColumnCount. Значения, которые вы укажете для RowSource заполнят элемент управления по строкам и колонкам в соответствии со значением свойства ColumnCount. Например, вы можете отобразить значения во множестве колонок путем установки свойства RowSourceType в 1 (Value) и указать значения, разделенные запятыми, для каждой колонки и строки для свойства RowSource так, как это показано в приведенной ниже примере:

	Скопировать код
myListBox.ColumnCount = 2 myListBox.RowSource = "Col1Row1,Col2Row1,Col1Row2,Col2Row2,Col2Row3"

В этом примере, не указано значение между значением 2 строки 2-й колонки и значением для третьей строки второй колонки, поэтому не отображается значение в первой колонке третьей строки.

Примечание переводчика. Это не соответствует действительности. При проверке указанного примера вы получите результат, показанный на картике внизу:

Объяснение этому очень простое. Если мы указывает тип источника данных = Value, а в качестве источника данных для строки укажем разделенный запятыми список значений, то значения будут заполнять списочную часть элемента управления в следующем порядке: колонки первой строки, колонки второй строки и так далее.

Для указания псевдоимени таблицы, содержащей колонки, используйте приведенный ниже синтаксис:

	Скопировать код
myListBox.RowSource = Alias.Col1Row1,Col2Row1,Col1Row2,Col2Row2,Col2Row3

Примечание переводчика. Данный синтаксис абсурден, если рассматриривать его формально. Мы не можем указать конкретных значений для конкретных строк и колонок. Это вожможно только для колонок! Если же пример приводился в качестве примера использования псевдоимени для значения свойства RowSourceType=1 (Value) то в первой колонке первой строки будет указано значение Alias.Col1Row1. Такой синтаксис применим к значению свойства RowSourceType=2 (Alias) и должен выглядет так:

	Скопировать код
myListBox.RowSource = Alias.Field_name_for_Col1,Field_name_for_Col2 && для использования со значением ColumnCount=2

Замечание

Когда свойство ColumnCount установлено в значение 0 или 1, элемент управления отображает первый предмет или значегние только в единственной колонке. В противном случае, элемент управления отображает каждый предмет или значение поколоночно в соответствии с числом колонок, указанном в свойстве ColumnCount. Вам может быть придется правильно установить свойство ColumnWidths для установки ширины колонок с тем, чтобы значения отображались корректно.

Для получения более подробной информации смотрите описание свойства ColumnCount, задачи Как: создать многоколоночные ListBox'ы и образец Отображение множества колонок в List Box.

Поскольку значением по умолчанию свойства Value является число, вам придется установить значение свойства Value в пустую строку, для отражения символьной строки текста выбранного предмета в listbox или combobox. Для ввода пустой строки в окне Properties, нажмите последовательно клавиши SPACEBAR и BACKSPACE. Для получения более подробной информации смотрите описания свойства Value и окна Properties.

Задачи

Справочное руководство

Концепции

Прочие ресурсы