Surface.GetGraphics - метод

Статья
11/04/2008

Обновлен: Ноябрь 2007

Получает контекст устройства.

Пространство имен: Microsoft.WindowsMobile.DirectX.Direct3D
Сборка: Microsoft.WindowsMobile.DirectX (в Microsoft.WindowsMobile.DirectX.dll)

Синтаксис

'Декларация
Public Function GetGraphics As Graphics
'Применение
Dim instance As Surface
Dim returnValue As Graphics

returnValue = instance.GetGraphics()

public Graphics GetGraphics()

public:
Graphics^ GetGraphics()

public function GetGraphics() : Graphics

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

Тип: System.Drawing.Graphics
Объект Graphics, представляющий контекст устройства для поверхности.

Исключения

Исключение	Условие
InvalidCallException	Вызов метода недопустим. Например, параметр метода может содержать недопустимое значение.

Заметки

Существуют следующие ограничения.

Данный метод действительный только для форматов: Format R5G6B5, X1R5G5B5, R8G8B8, и X8R8G8B8. Форматы, содержащие альфа-компоненту, не поддерживаются, так как внедрения интерфейса графических устройств (GDI) Microsoft Windows могут некорректно работать с альфа-каналом.

Одновременно может запрашиваться только один контекст устройства.

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

Данный метод выдает сбой при прорисовке, даже если они создавались как доступные для блокировки (или в случае задних буферов, LockableBackBuffer в PresentFlag).

Если контекст устройства выступает за поверхность, приложение не способно вызвать следующие методы.

Метод ColorFill
Метод Device.StretchRectangle
Метод Device.UpdateTexture
Метод Surface.LockRectangle
Метод SwapChain.Present (в цепочке свопинга, содержащей поверхность)
Методы Texture.LockRectangle

Данный метод вызывает неявную блокировку; не сохраняйте контекст устройства для использования в дальнейшем. Выполните вызов ReleaseGraphics для снятия блокировки.

Полезно вызывать этот метод и ReleaseGraphics при работе с уровнями mipmap или кубической детализации; вместе с тем, эти вызовы являются медленными для всех уровней mip, кроме наивысшего, а операции GDI на этих уровнях не будут ускоряться.

Объект Graphics обеспечивает доступ к функциональным возможностям графического интерфейса GDI и Microsoft Win32.

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

Платформы

Windows CE, Windows Mobile for Smartphone, Windows Mobile для карманных ПК

Среды .NET Framework и .NET Compact Framework поддерживают не все версии каждой платформы. Поддерживаемые версии перечислены в разделе Требования к системе для .NET Framework.

Сведения о версии

.NET Compact Framework

Поддерживается в версиях: 3.5, 2.0

См. также

Ссылки

Surface Класс

Surface - члены

Microsoft.WindowsMobile.DirectX.Direct3D - пространство имен

Поделиться через