Метод IXpsSignatureRequest::SetSpotLocation (xpsdigitalsignature.h)
Указывает страницу и расположение на странице, где будет отображаться видимая цифровая подпись или запрос цифровой подписи.
Синтаксис
HRESULT SetSpotLocation(
[in] INT32 pageIndex,
[in] float x,
[in] float y
);
Параметры
[in] pageIndex
Значение индекса части FixedPage в документе XPS, которая содержит видимую цифровую подпись или запрос цифровой подписи.
Если значение этого параметра равно –1, элемент SpotLocation не будет записан в разметку SignatureDefinitions.
Если значение этого параметра не равно –1, это должен быть номер страницы, который существует в части FixedDocument, к которой присоединен блок подписи, содержащий этот запрос.
[in] x
Значение X-координаты места подписывания на странице.
[in] y
Значение координаты Y точки подписывания на странице.
Возвращаемое значение
Метод возвращает HRESULT. Возможные значения включают, помимо прочего, значения в следующей таблице. Возвращаемые значения, не перечисленные в этой таблице, см. в разделах Ошибки API цифровой подписи XPS и Ошибки документов XPS.
| Код возврата | Описание |
|---|---|
|
Метод выполнен успешно. |
|
Интерфейс не подключен к диспетчеру подписей. |
Комментарии
Расположение места подписывания указывается в единицах XPS в левом верхнем углу страницы. На дюйм приходится 96 единиц XPS.
Требования
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | xpsdigitalsignature.h |