Отображает диалоговое окно Font и возвращает информацию о шрифте, который Вы выбираете. 

GETFONT([cFontName [, nFontSize [, cFontStyle [, nFontCharSet]]]])

Параметры

cFontName

Определяет имя шрифта, первоначально выбранного в диалоговом окне Font. Если шрифт, который Вы определяете, не установлен, то заданный по умолчанию шрифт выбирается первоначально.
nFontSize

Определяет размер шрифта, выбранный первоначально в диалоговом окне Font. Если размер шрифта, который Вы определяете, не поддерживается, заданный по умолчанию размер шрифта выбрается первоначально. Если Вы опускаете nFontSize или если nFontSize является меньше или равным нулю, то размер выбранного шрифта принимает значение по умолчанию в 10 пунктов.
Обратите внимание:
Диалоговое окно разрешает Вам выбирать размеры между 4 и 127 включительно. Вы можете определить другие значения для nFontSize при вызовве функции GETFONT ; никакой ошибки не происходит. Однако, если Вы допускаете это, то пользователь должен выбрать размер в пределах определяемого диапазона значений, перед вводом OK в диалоговом окне. Иначе, диалоговое окно отображает предупреждение и не разрешает назначить это значение.

cFontStyle

Определяет начертание шрифта, выбранное первоначально в диалоговом окне Font или доступное для отображения на выбранном принтере. Если начертание шрифта, которое Вы определяете, не поддерживается, заданное по умолчанию начертание шрифта выбирается первоначально. Следующая таблица перечисляет значения, доступные для cFontStyle .

cFontStyle Описание

B

Выберите начертание шрифта Bold первоначально.

I

Выберите начертание шрифта Italic первоначально.

BI

Выберите начертание шрифта Bold Italic первоначально.

P

Отобразите только те шрифты, которые доступные в текущем по умолчанию принтере.

nFontCharSet

Определяет значение для языковых начертаний. Значения, которые Вы можете определить, различаются в зависимости от вашей версии Windows.
Обратите внимание:
Исключение этого параметра, отключает раскрывающийся список начертаний в диалоговом окне.

Следующая таблица описывает примеры некоторых значений для nFontCharSet.

nFontCharSet Языковое начертание

0

Western

1

Default

2

Symbol

128

Japanese

161

Greek

162

Turkish

163

Vietnamese

177

Hebrew

178

Arabic

186

Baltic

204

Cyrillic

238

Central European

Обратите внимание:
Если Вы определяете 1 для nFontCharSet , то диалоговое окно, которое открывает GETFONT( ) выводит заданное по умолчанию языковое начертание для операционной системы. GETFONT( ) никогда не возвращения 1, потому что она возвращает значение для языкового начертания, выбранного в диалоговом окне GETFONT( ) .

Для подробной информации, см. FontCharSet Свойство .

Возвращаемое значение

Символьное. GETFONT( ) возвращает одно из следующего, в зависимости от некоторых условий:

  • Символьную строку, содержащую три типа данных о шрифте с запятыми, разделяющими эти пункты: имя шрифта, размер и стиль. Это действие происходит, когда Вы выбираете 1 в диалоговом окне Font, и при этом не включили четвертый дополнительный параметр при вызове функции GETFONT( ) .

  • Символьную строку, содержащую четыре типа данных о шрифте с запятыми, разтделяющими пункты: имя шрифта, размер, стиль и языковое начертание. Это действие происходит, если Вы включаете значение для параметра nFontCharSet .

Обратите внимание:
В версиях VisualFoxPro младше чем Visual FoxPro 9.0, если Вы включали значение 0 как четвертый параметр в GETFONT() , Вы получали ту же самую информацию, как если бы Вы не включали четвертый параметр вообще. Раскрывающийся список начертаний был не доступен, и возвращаемое значение содержало только три типа данных о шрифтах. В Visual FoxPro 9.0, значение 0 явно указывает числовое значение, соответствующее Западному начертанию. Раскрывающийся список начертаний мог бы также первоначально отображаться как Западный, если бы Вы определили 1 для этого значения, но только в том случае, если Западный - это заданное по умолчанию начертание для ваших локализованных параметров настройки.

  • Пустую строку, если Вы выходите из диалогового окна Font, щелкая Cancel, Close в Оконном меню, или нажимая клавишу ESC.

Замечания

Совет:
Вы можете сокращать некоторые команды и функции Visual FoxPro до четырех символов, если не существует конфликтов с другими командами и функциями. В случае с GETFONT( ) и GETFILE( ) , которые обе начинаются с одних и тех же четырех символов, старшинство отдается GETFILE( ) ; поэтому, выполнение GETF( ) выводит диалоговое окно Open.

Пример

Следующий пример иллюстрирует другие типы возвращаемых значений, которые Вы можете получить от функции GETFONT( ) .

Скопировать код 
* Invoke the dialog with script drop-down list disabled:
? GETFONT("Arial",12,"B") && press OK in the dialog box
* return value is the string:
* "Arial,12,B"
* Enable the script drop-down list, Western script selected:
? GETFONT("Arial",12,"B",0) && press OK after selections
* sample return value is the string:
* "Verdana,16,N,161"
* Return from the dialog box without making a selection:
? GETFONT("Arial",12,"B") && press Cancel in the dialog box
* return value is an empty string
? GETFONT("Arial",12,"B",0) && press Cancel in the dialog box
* return value is still an empty string

См. Также