Печать и вывод текста, страница 16

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

BOOL. В случае успешного выполнения возвращаемое значение — TRUE; в ином случае возвращаемое значение — FALSE.

Включаемыйфайл

wingdi.h

См. также

GetTextExtentPoint32, ExtTextOut, TextOut

Пример

В следующем примере выполняется выравнивание строки с тремя словами, чтобы она точно поместилась в границах прямоугольника, как показано на рис. 14.12. Для вычисления размера строки перед выравниванием применяется функция GetTextExtentPoint32. Затем функция

SetTextJustification добавляет достаточно места, чтобы раздвинуть эту строку на всю ширину прямоугольника. При следующем вызове функции TextOut это выравнивание  используется  во  время вывода   для   увеличения   промежутка между словами.

См .    \ local -sources \ chapl 4\14-21.txt

StartDoc                                  Windows 98   • Windows 2000

Описание

Функция StartDoc запускает задание на печать на указанном принтере.

Синтаксис

int StartDoc( HDC hDC, CONST DOCINFO* Ipdi )

Параметры

hDC

HDC. Контекст устройства для задания на печать.

Ipdi

CONST DOCINFO*. Указатель на структуру DOCINFO, содержащую имя файла  документа  и   имя   выходного  файла.   Определение   структуры DOCINFO приведено ниже.

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

int. В случае успешного выполнения функция возвращает значение больше нуля, которое является идентификатором задания на печать для данного документа; в ином случае возвращаемое значение — SP_ERROR

Включаемый файл

wingdi.h

См. также

EndDoc, AbortDoc, StartPage

Определение DOCINFO

typedef struct {

int         cbSize;

LPCTSTR IpszDocName;

LPCTSTR IpszOutput;

LPCTSTR IpszDatatype;

DWORD    f wType ; }   DOCINFO;

Члены

cbSize

int. Размер структуры (в байтах).

IpszDocName

LPCTSTR. Указатель на строку с нулевым символом в конце, содержащую имя документа.

IpszOutput

LPCTSTR. Указатель на строку с нулевым символом в конце, содержащую имя выходного файла. Если значение этого параметра установлено равным

NULL, вывод направляется на устройство, обозначенное параметром hDC, который передан функции StartDoc.

IpszDatatype

LPCTSTR. Указатель на строку с нулевым символом в конце, содержащую тип данных, используемый для регистрации задания на печать.

fwType

DWORD. Дополнительная информация о задании на печать. Этот параметр может быть равен 0 или DI_APPBANDING, если в приложении используется разбиение выводимых данных на фрагменты. Для обеспечения оптимальной производительности печати в приложениях, в которых используется разбиение выводимых данных на фрагменты, должно быть указано значение DI_APPBANDING.

Пример

См. пример для функции ResetDC.

StartPage                                Windows 98   • Windows 2000

Описание

Функция StartPage сообщает драйверу принтера о начале приема данных для новой страницы. В приложении необходимо вызывать эту функций после функции EndPage каждый раз, когда во время печати происходит переход на новую страницу.

Синтаксис

int StartPage( HDC hDC )

Параметры

HOC

HDC. Контекст устройства для задания на печать.

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

int. В случае успешного выполнения возвращаемое значение больше нуля; в ином случае возвращаемое значение — SP_ERROR.

Включаемый файл

wingdi.h

См. также

EndPage

Пример

См. пример для функции EndPage.

TabbedTextOut                          Windows 98   • Windows 2000

Описание

Функция TabbedTextOut выводит символьную строку в указанном месте DC, заменяя символы табуляции значениями, указанными в массиве позиций табуляции. Для вывода текста применяется текущий шрифт.

Синтаксис

LONG TabbedTextOut( HDC hDC, int x, int y, LPCTSTR IpString, int nCount; int nTabPositions, CONST LPINT IpnTabStopPositions, int nTabOrigin )

Параметры

hDC

HDC. Контекст устройства.

X

int. Координата х начальной точки строки (в логических единицах длины);

У

int. Координата у начальной точки строки (в логических единицах длины).

IpString

LPCTSTR. Указатель на символьную строку, которая должна быть выведена на печать.

nCount

int. Число символов в строке, указанной параметром IpString.

nTab Positions

int. Число значений в массиве позиций табуляции, указанном параметром IpnTabStopPositions. Если этот параметр установлен равным 0, символы табуляции развертываются на ширину восьми средних символов. Если этот параметр установлен равным 1, символы табуляции развертываются на расстояние, обозначенное первым символом табуляции, на который указывает параметр IpnTabStopPositions.

Ipn TabStopPositions

CONST LPINT. Указатель на массив, содержащий позиции табуляции в возрастающем порядке, в логических единицах длины. В Windows 98 для выравнивания по правому краю должны быть указаны отрицательные значения.

nTabOrigin

int. Координата х исходной позиции, с которой начинается развертывание символов табуляции, в логических единицах длины.

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

LONG. В случае успешного выполнения — размеры строки, в логических единицах длины. Значение высоты находится в старшем слове, а значение ширины — в младшем слове.

Включаемый файл

winuser.h

См. также

DrawText, TextOut, ExtTextOut, SetTextAlign

Пример

См. пример для функции GetTabbedTextExtent.

TextOut                                   Windows 98   ф Windows 2000

Описание

Функция TextOut позволяет вывести символьную строку в указанном месте с использованием выбранного шрифта. Выбор места вывода зависит от текущего режима выравнивания текста. В приложении можно определить этот режим, вызвав функцию GetTextAlign, и изменить его, вызвав функцию SetTextAlign.

Синтаксис

BOOL TextOut( HDC hDC, int nXStart, int nYStart, LPCTSTR IpszString, int cbString )

Параметры

hDC

HDC. Контекст устройства.

nXStart

int. Логическая координата х точки отсчета, применяемой для выравнивания строки.

пУ Start

int. Логическая координата у точки отсчета, применяемой для выравнивания строки.

IpszString

LPCTSTR. Указатель на строку, которая должна быть выведена.

cbString

int. Число символов в строке.

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

BOOL. В случае успешного выполнения возвращаемое значение — TRUE; в ином случае возвращаемое значение — FALSE.

Включаемый файл

wingdi.h

См. также

ExtTextOut, SetTextAlign, DrawText

Пример

См. пример для функций SetTextJustification и ResetDC.