Что такое image visual studio

The Visual Studio image library

Applies to: Visual Studio Visual Studio for Mac Visual Studio Code

The Visual Studio Image Library contains application images that appear in Microsoft Visual Studio, Microsoft Windows, the Office system and other Microsoft software. This set of over 1,000 images can be used to create applications that look visually consistent with Microsoft software.

The image library is divided into five categories: Common Elements, Actions, Annotations, Icons, and Objects. Readme files are included in the PDF format for the Common Elements and Icon types. They contain information about how to use these images appropriately in your applications.

See also

• Install Visual Studio
• Images, bitmaps, and metafiles

Библиотека изображений Visual Studio

Область применения:Visual Studio Visual Studio для Mac Visual Studio Code

Библиотека изображений Visual Studio содержит изображения приложений, отображаемые в Microsoft Visual Studio, Microsoft Windows, системе Office и другом программном обеспечении Microsoft. Набор из более 1000 изображений можно использовать для создания приложений, внешний вид которых сочетается с программным обеспечением Microsoft.

Библиотека изображений состоит из пяти категорий: общие элементы, действия, заметки, значки и объекты. Для типов общих элементов и значков в библиотеку также включены файлы сведений в формате PDF. Они содержат информацию о правильном использовании этих изображений в приложениях.

См. также

• Установка Visual Studio
• Изображения, растровые изображения и метафайлы

Image Класс

Пространство имен: System.Drawing Сборка: System.Drawing.Common.dll Сборка: System.Drawing.dll Пакет: System.Drawing.Common v6.0.0 Пакет: System.Drawing.Common v7.0.0 Пакет: System.Drawing.Common v8.0.0

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Абстрактный базовый класс, который предоставляет функциональные возможности для производных классов Bitmap и Metafile.

public ref class Image abstract : MarshalByRefObject, ICloneable, IDisposable, System::Runtime::Serialization::ISerializable

public abstract class Image : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable

[System.ComponentModel.TypeConverter("System.Drawing.ImageConverter, System.Windows.Extensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51")] public abstract class Image : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable

[System.ComponentModel.TypeConverter(typeof(System.Drawing.ImageConverter))] public abstract class Image : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable

[System.ComponentModel.TypeConverter(typeof(System.Drawing.ImageConverter))] [System.Serializable] public abstract class Image : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable

[System.ComponentModel.TypeConverter(typeof(System.Drawing.ImageConverter))] [System.Serializable] [System.Runtime.InteropServices.ComVisible(true)] public abstract class Image : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable

type Image = class inherit MarshalByRefObject interface ICloneable interface IDisposable interface ISerializable

[] type Image = class inherit MarshalByRefObject interface ICloneable interface IDisposable interface ISerializable

[] type Image = class inherit MarshalByRefObject interface ICloneable interface IDisposable interface ISerializable

[] [] type Image = class inherit MarshalByRefObject interface IDisposable interface ICloneable interface ISerializable

[] [] [] type Image = class inherit MarshalByRefObject interface ISerializable interface ICloneable interface IDisposable

Public MustInherit Class Image Inherits MarshalByRefObject Implements ICloneable, IDisposable, ISerializable

Средство просмотра библиотеки образов

Область применения:Visual Studio Visual Studio для Mac Visual Studio Code

Средство просмотра библиотек изображений Visual Studio может загружать и искать манифесты изображений, позволяя пользователю управлять ими так же, как и Visual Studio. Пользователь может изменять фон, размеры, DPI, высокую контрастность и другие параметры. Средство также отображает сведения о загрузке каждого манифеста изображения и отображает исходную информацию для каждого изображения в манифесте изображения. Это средство полезно для следующих способов:

1. Диагностика ошибок
2. Обеспечение правильного задания атрибутов в манифестах пользовательского образа
3. Поиск изображений в каталоге образов Visual Studio, чтобы расширение Visual Studio пользовалось изображениями, которые соответствуют стилю Visual Studio

Моникер изображения

Моникер изображения (или моникер для короткого) — это пара GUID:ID, которая однозначно идентифицирует ресурс изображения или ресурс списка изображений в библиотеке образов.

Файлы манифеста изображения

Файлы манифеста изображения (.imagemanifest) — это XML-файлы, определяющие набор ресурсов изображений, моникеры, представляющие эти ресурсы, и реальные изображения или изображения, представляющие каждый ресурс. Манифесты изображений могут определять автономные изображения или списки изображений для поддержки устаревшего пользовательского интерфейса. Кроме того, существуют атрибуты, которые можно задать в активе или на отдельных изображениях, стоящих за каждым ресурсом, чтобы изменить время и способ отображения этих ресурсов.

Схема манифеста изображения

Полный манифест изображения выглядит следующим образом:

Символы

Как помощь в удобочитаемости и обслуживании манифест изображения может использовать символы для значений атрибутов. Символы определяются следующим образом:

Подэлемента	Определение
Импорт	Импортирует символы заданного файла манифеста для использования в текущем манифесте.
GUID	Символ представляет GUID и должен соответствовать форматированию GUID.
Идентификатор	Символ представляет идентификатор и должен быть ненужным целым числом.
Строка	Символ представляет произвольное строковое значение.

Символы чувствительны к регистру и ссылаются на них с помощью синтаксиса $(symbol-name):

Некоторые символы предопределяются для всех манифестов. Их можно использовать в атрибуте или для ссылки на пути на локальном компьютере.

Символ	Description
CommonProgramFiles	Значение переменной среды %CommonProgramFiles%
LocalAppData	Значение переменной среды %LocalAppData%
ManifestFolder	Папка, содержащая файл манифеста
MyDocuments	Полный путь к папке «Мои документы» текущего пользователя
ProgramFiles	Значение переменной среды %ProgramFiles%
Система	Папка Windows\System32
Windir	Значение переменной среды %WinDir%

Изображение

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

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

Атрибут	Определение
GUID	[Обязательный] Часть GUID моникера изображения
Идентификатор	[Обязательный] Часть идентификатора моникера изображения
AllowColorInversion	[Необязательно, значение true] Указывает, может ли изображение иметь его цвета программным образом, инвертированные при использовании на темном фоне.

Источник

Элемент определяет один исходный ресурс изображения (XAML и PNG).

Атрибут	Определение
URI-адрес	[Обязательный] Универсальный код ресурса (URI), определяющий, откуда можно загрузить изображение. Может принимать одно из следующих значений:

— универсальный код ресурса (URI ) пакета с помощью центра application:///

— ссылка на абсолютный ресурс компонента

Может принимать одно из следующих значений:

— Свет: источник может использоваться на светлом фоне.

— Темный: источник можно использовать на темном фоне.

— HighContrast: источник можно использовать в любом фоновом режиме в режиме высокой контрастности.

— HighContrastLight: источник можно использовать на светлом фоне в режиме высокой контрастности.

—HighContrastDark: источник можно использовать на темном фоне в режиме высокой контрастности.

Если атрибут Background опущен, источник можно использовать в любом фоновом режиме.

Элемент может иметь ровно один из следующих необязательных подэлементов:

Элемент также может иметь необязательный , который определяет , загруженный из собственной сборки, а не управляемой сборки.

Атрибут	Определение
Тип	[Обязательный] Тип собственного ресурса , XAML или PNG
Идентификатор	[Обязательный] Целочисленный идентификатор части собственного ресурса

ImageList

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

Атрибут	Определение
GUID	[Обязательный] Часть GUID моникера изображения
Идентификатор	[Обязательный] Часть идентификатора моникера изображения
Внешние	[Необязательно, значение false] Указывает, ссылается ли моникер на изображение в текущем манифесте.

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

Как использовать средство

Проверка манифеста пользовательского образа

Чтобы создать настраиваемый манифест, рекомендуется использовать средство ManifestFromResources для автоматического создания манифеста. Чтобы проверить настраиваемый манифест, запустите средство просмотра библиотеки изображений и выберите пути набора файлов > . чтобы открыть диалоговое окно «Каталоги поиска». Средство будет использовать каталоги поиска для загрузки манифестов изображений, но он также будет использовать их для поиска DLL-файлов, содержащих изображения в манифесте, поэтому обязательно включите в это диалоговое окно каталоги манифеста и БИБЛИОТЕК DLL.

Нажмите кнопку «Добавить. « , чтобы выбрать новые каталоги поиска, чтобы найти манифесты и соответствующие библиотеки DLL. Средство запоминает эти каталоги поиска, и их можно включить или отключить, проверка или отменив проверка каталог.

По умолчанию средство попытается найти каталог установки Visual Studio и добавить эти каталоги в список каталогов поиска. Вы можете вручную добавить каталоги, которые средство не находит.

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

Цвет фона можно задать в качестве светлого, темного или настраиваемого значения. При выборе «Настраиваемый цвет» откроется диалоговое окно выбора цвета и добавьте его в нижней части поля со списком фона, чтобы легко вспомнить позже.

При выборе моникера изображения отображаются сведения для каждого реального изображения, который стоит за моникером в области сведений об изображении справа. Панель также позволяет пользователям копировать моникер по имени или по необработанным значениям GUID:ID.

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

При проверке манифеста изображения рекомендуется развернуть библиотеку DLL манифеста и образа в их реальных расположениях. Это позволит убедиться, что все относительные пути работают правильно, и библиотека образов может найти и загрузить манифест и библиотеку DLL изображений.

Поиск известныхmonikers каталога образов

Чтобы лучше соответствовать стилю Visual Studio, расширение Visual Studio может использовать изображения в каталоге образов Visual Studio, а не создавать и использовать собственные. Это дает преимущество не поддерживать эти образы и гарантирует, что образ будет иметь изображение с высоким уровнем DPI, поэтому он должен выглядеть правильно во всех параметрах DPI, поддерживаемых Visual Studio.

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

При поиске моникеров изображений в существующих манифестах рекомендуется искать и использовать только моникеры каталога образов Visual Studio, другие намеренно общедоступные моникеры или собственные пользовательские моникеры. Если вы используете неопубликованные моникеры, пользовательский интерфейс может быть нарушен или изменен его изображения неожиданными способами, если или когда эти неопубликованные моникеры и изображения изменяются или обновляются.

Кроме того, можно выполнить поиск по GUID. Этот тип поиска полезен для фильтрации по списку до одного манифеста или одного подраздела манифеста, если этот манифест содержит несколько графических идентификаторов.

Наконец, поиск по идентификатору также возможен.

Примечания.

• По умолчанию средство извлекает несколько манифестов образа, присутствующих в каталоге установки Visual Studio. Единственным, который имеет общедоступные моникеры, является манифест Microsoft.VisualStudio.ImageCatalog . GUID: ae27a6b0-e345-4288-96df-5eaf394ee369 (не переопределяйте этот GUID в пользовательском манифесте) Тип: ИзвестныеMonikers
• Средство пытается загрузить все манифесты изображения, которые он находит, поэтому может потребоваться несколько секунд, чтобы приложение фактически отображалось. При загрузке манифестов также может быть медленным или неответственным.

Образец вывода

Это средство не создает выходные данные.