ApplicationHelper - класс

Вспомогательные методы для приложения.

Definition

Пространство имён: Tessa.UI
Сборка: Tessa.UI (в Tessa.UI.dll) Версия: 4.0.4
C#
public static class ApplicationHelper
Inheritance
Object    ApplicationHelper

Свойства

ApplicationIcon Иконка, с которым приложение было опубликовано, или иконка, встроенная в сборку, если приложение не было опубликовано, или стандартная иконка приложения, если иконка отсутствует в сборке приложения.
AssemblyIcon Иконка, встроенная в сборку приложения, или стандартная иконка приложения, если иконка не найдена.
CanSaveCredentials Признак того, что возможно сохранение логина или пароля в Tessa Applications. Если значение отсутствует, то логин и пароль сохранять нельзя, и уже сохранённые логин/пароль также не могут быть использованы, всегда требуется вводить их заново.
DefaultWallpaper Путь к фоновому изображению по умолчанию или null, если фоновое изображение по умолчанию не указано.
DialogOwner Объект, являющийся родительским для диалоговых окон, или null, если в качестве родительского будет использоваться основное окно приложения. Для получения значения используйте метод GetDialogOwner(Boolean).
LogoBackground Цвет фона на экране загрузки или null, если используется стандартный цвет.
LogoForeground Цвет текста на экране загрузки или null, если используется стандартный цвет.
LogoHideFrame Признак того, что обрамление надо скрыть на экране загрузки. По умолчанию равен false.
LogoHideProgress Признак того, что прогресс бар надо скрыть на экране загрузки. По умолчанию равен false.
LogoHideText Признак того, что строку с текстом надо скрыть на экране загрузки. По умолчанию равен false.
LogoHideVersion Признак того, что строку с версией надо скрыть на экране загрузки. По умолчанию равен false.
LogoText Текст под логотипом на экране загрузки или null, если текст не задан и следует использовать стандартный текст. Строка "\n" заменяется на перевод строки.
MaxPreviewInstances Максимальное количество одновременно возможных экземпляров процессов для просмотра файлов.
RemoteSession Возвращает признак того, что приложение запущено в терминальной сессии, такой как RDP. Позволяет отключить такие визуальные эффекты, как затемнение экрана.
SoftwareRendering Признак того, что отображение интерфейса в WPF не должно использовать аппаратное ускорение, т.е. должен производиться программный рендеринг.
Title Заголовок окна приложения или null, если используется стандартный заголовок.
UseFilePreview64Bit Признак того, что предпросмотр файлов в 64-битном приложении должен выполняться также средствами 64-битного обработчика предпросмотра. В таком случае возможны некоторые проблемы предпросмотра средствами Microsoft Office. Настройка не влияет на запуск приложений в 32-битном процессе (и на 32-битных ОС).
WallpaperFolder Путь к папке с доступными фоновыми изображениями (относительно файлов приложения) или null, если используется папка по умолчанию wallpapers. Используйте совместно с методом GetExistentFolderPathList(String, Assembly).

Методы

ActivateMainWindow Активирует главное окно приложения. Работает только в потоке UI, если у приложения существует главное окно. Возвращает признак того, что главное окно было успешно активировано.
AppendClosingHandlersSync Добавляет к событиям ClosingBeforeCheck и ClosingAfterCheck заданные обработчики. Если такие обработчики уже были установлены, то они не добавляются, но порядок обработчиков при этом может измениться. Вызовы метода синхронизированы между потоками, т.е. гарантированно последовательны.
ApplySoftwareRenderingFromConfiguration Применяет программный рендеринг (без аппаратного ускорения), если это установлено в конфигурационном файле, т.е. установлена настройка SoftwareRendering.
BringMainWindowIntoView Переводит главное окно процесса на передний план. Не переводит фокус с других приложений.
BringMainWindowToTop Выводит главное окно приложения на передний план. Если окно было свёрнуто, то разворачивает его. Работает только в потоке UI, если у приложения существует главное окно. Возвращает признак того, что главное окно было успешно выведено на передний план.
CreateDefaultApplicationIcon Возвращает стандартную иконку, используемую для приложения в Windows.
CreateLauncherFromSettings Создаёт объект загрузочного экрана в соответствии с настройками из конфигурационного файла app.json.
GetAssemblyIconDataFullSize Возвращает массив байт, соответствующий иконке, встроенной в сборку, или же стандартной иконке приложения, если в сборке отсутствует встроенная иконка. В отличие от свойства AssemblyIcon, возвращённые данные по иконке не изменяются в размерах (что выполнялось в AssemblyIcon для отображения в панели задач без артефактов).
GetAssemblyIconStream Возвращает поток с данными иконки в формате PNG, которая встроена в заданную сборку.
GetDialogOwner Метод для получения текущего основного окна в соответствии со значением из свойства DialogOwner. При этом не вызывается обращение к потоку UI или связанным с ним свойствам.
GetLogoUri Возвращает Uri к логотипу, указанному в настройках приложения, или null, если должен быть использован стандартный логотип. Рекомендуется использовать совместно с методом CreateLauncher(Uri, String, String, Boolean, Boolean, Boolean, NullableColor, NullableColor).
HandleDispatcherUnhandledException Выполняет обработку исключения для события DispatcherUnhandledException.
HandleDispatcherUnhandledExceptionWithSafeLocalization Выполняет обработку исключения для события DispatcherUnhandledException, учитывая безопасную инициализацию локализации.
InitializeDescriptorAsync Выполняет инициализацию дескриптора приложения, посредством которого может быть получена иконка ApplicationIcon, а также текущие настройки приложения.
PerformClosingCheckWithEventsAsync Вызывает обработку событий контролируемого закрытия приложения с использованием событий ClosingBeforeCheck и ClosingAfterCheck, и с возможностью указать стандартную обработку закрытия defaultCheckFuncAsync. Метод обрабатывает исключения, которые могут возникнуть в обработчиках события или в функции defaultCheckFuncAsync, в этом случае исключение выводится пользователю и закрытие отменяется. Возвращает признак того, что закрытие окна подтверждено.
SetupAppContextSwitchesForWpf Устанавливает настройки AppContext для оптимального функционирования приложений WPF.
ShouldShowMessageInTaskBar Возвращает признак того, что окно с сообщением должно быть выведено в панели задач. Если метод вызван в потоке UI и главное окно приложения отсутствует или ещё не создано, или если приложение WPF ещё не инициализировано, то возвращает true. В других случаях возвращает false.
TryExtractIconFromFile Извлекает иконку, встроенную в заданный файл, и возвращает её в виде объекта Icon. Возвращает null, если извлечь иконку не удалось.
TryGetRecommendedIconDataFromIcoFileAsync Возвращает данные для рекомендуемой иконки, полученной из заданного файла формата .ICO, или null, если данные получить не удалось. Метод не выбрасывает исключений, ошибки логируются и возвращаются как null.

Поля

ClosingAfterCheck Событие по закрытию окна приложения, выполняемое после того, как пользователь был проинформирован о необходимости сохранить изменения во вкладках и подтвердил закрытие, несмотря на это. Если обработчики события ClosingBeforeCheck уже отменили закрытие, установив e.Cancel = true, или обработчики вызвали исключение, то это событие не будет вызвано, а закрытие будет отменено. Если пользователь подтвердил закрытие или обработчики события ClosingBeforeCheck установили e.ForceClosing = true, то это событие будет вызвано, но в этом случае будет установлено e.Cancel = true в аргументах события.
ClosingBeforeCheck Событие по закрытию окна приложения, выполняемое до того, как будут сделаны проверки по умолчанию, и пользователь будет проинформирован о необходимости сохранить изменения во вкладках.

См. также