İngilizce dilinde oku

Aracılığıyla paylaş


Görüntü Kitaplığı Görüntüleyicisi

Visual Studio Görüntü Kitaplığı Görüntüleyicisi aracı, görüntü bildirimlerini yükleyip arayabilir ve kullanıcının bunları Visual Studio'da olduğu gibi işlemesine olanak tanır. Kullanıcı arka planı, boyutları, DPI'yı, yüksek karşıtlığı ve diğer ayarları değiştirebilir. Araç ayrıca her görüntü bildirimi için yükleme bilgilerini görüntüler ve görüntü bildirimindeki her görüntünün kaynak bilgilerini görüntüler. Bu araç şunlar için kullanışlıdır:

  1. Hataları tanılama

  2. Özel görüntü bildirimlerinde özniteliklerin doğru ayarlandığından emin olun

  3. Visual Studio uzantısının Visual Studio stiline uygun görüntüleri kullanabilmesi için Visual Studio Görüntü Kataloğu'nda görüntü arama

Image Library Viewer Hero

Görüntü adı

Görüntü takma adı (veya kısaca bilinen ad), Görüntü Kitaplığı'ndaki bir görüntü varlığını veya görüntü listesi varlığını benzersiz olarak tanımlayan GUID:ID çiftidir.

Görüntü bildirim dosyaları

Görüntü bildirimi (.imagemanifest) dosyaları, bir görüntü varlıkları kümesini tanımlayan XML dosyaları, bu varlıkları temsil eden takma adlar ve her varlığı temsil eden gerçek görüntü veya görüntülerdir. Görüntü bildirimleri, eski kullanıcı arabirimi desteği için tek başına görüntüler veya görüntü listeleri tanımlayabilir. Ayrıca, varlıkların ne zaman ve nasıl görüntüleneceğini değiştirmek için varlıkta veya her varlığın arkasındaki tek tek görüntülerde ayarlanabilen öznitelikler vardır.

Görüntü bildirimi şeması

Tam bir görüntü bildirimi şöyle görünür:

XML
<ImageManifest>
      <!-- zero or one Symbols elements -->
      <Symbols>
        <!-- zero or more Guid, ID, or String elements -->
      </Symbols>
      <!-- zero or one Images elements -->
      <Images>
        <!-- zero or more Image elements -->
      </Images>
      <!-- zero or one ImageLists elements -->
      <ImageLists>
        <!-- zero or more ImageList elements -->
      </ImageLists>
</ImageManifest>

Simgeler

Okunabilirlik ve bakım yardımı olarak, görüntü bildirimi öznitelik değerleri için sembolleri kullanabilir. Simgeler şu şekilde tanımlanır:

XML
<Symbols>
      <Import Manifest="manifest" />
      <Guid Name="ShellCommandGuid" Value="8ee4f65d-bab4-4cde-b8e7-ac412abbda8a" />
      <ID Name="cmdidSaveAll" Value="1000" />
      <String Name="AssemblyName" Value="Microsoft.VisualStudio.Shell.UI.Internal" />
      <!-- If your assembly is strongly named, you'll need the version and public key token as well -->
      <!-- <String Name="AssemblyName" Value="Microsoft.VisualStudio.Shell.UI.Internal;v17.0.0.0;b03f5f7f11d50a3a" /> -->
</Symbols>
Alt öğesi Tanım
Import Verilen bildirim dosyasının sembollerini geçerli bildirimde kullanılmak üzere içeri aktarır.
GUID Simge bir GUID'yi temsil eder ve GUID biçimlendirmesi ile eşleşmelidir.
Kimlik Simge bir kimliği temsil eder ve zorunlu olmayan bir tamsayı olmalıdır.
String simgesi rastgele bir dize değerini temsil eder.

Simgeler büyük/küçük harfe duyarlıdır ve $(sembol-adı) söz dizimi kullanılarak başvurulur:

XML
<Image Guid="$(ShellCommandGuid)" ID="$(cmdidSaveAll)" >
      <Source Uri="/$(AssemblyName);Component/Resources/image.xaml" />
</Image>

Bazı simgeler tüm bildirimler için önceden tanımlanmıştır. Bunlar, yerel makinedeki yollara başvurmak için Source> veya <Import> öğesinin Uri özniteliğinde <kullanılabilir.

Sembolü Açıklama
CommonProgramFiles %CommonProgramFiles% ortam değişkeninin değeri
Localappdata %LocalAppData% ortam değişkeninin değeri
ManifestFolder Bildirim dosyasını içeren klasör
Mydocuments Geçerli kullanıcının Belgelerim klasörünün tam yolu
ProgramFiles %ProgramFiles% ortam değişkeninin değeri
Sistem Windows\System32 klasörü
WinDir %WinDir% ortam değişkeninin değeri

Görsel

<Image> öğesi, bir takma ad tarafından başvurulabilen bir görüntü tanımlar. Birlikte alınan GUID ve kimlik, görüntü adını oluşturur. Görüntünün adı, tüm görüntü kitaplığında benzersiz olmalıdır. Birden fazla görüntüde belirli bir takma ad varsa, kitaplığı oluştururken karşılaşılan ilk görüntü korunan görüntüdür.

En az bir kaynak içermelidir. Boyut açısından bağımsız kaynaklar çok çeşitli boyutlarda en iyi sonuçları verecektir ancak bunlar gerekli değildir. Hizmet, Image> öğesinde tanımlanmayan bir boyutun <görüntüsü istenirse ve boyuta bağımsız kaynak yoksa, hizmet boyuta özgü en iyi kaynağı seçer ve istenen boyuta ölçeklendirir.

XML
<Image Guid="guid" ID="int" AllowColorInversion="true/false">
      <Source ... />
      <!-- optional additional Source elements -->
</Image>
Öznitelik Tanım
GUID [Gerekli] Görüntü takma adını guid bölümü
Kimlik [Gerekli] Görüntü takma adını id bölümü
AllowColorInversion [İsteğe bağlı, varsayılan true] Görüntünün koyu arka planda kullanıldığında renklerinin program aracılığıyla ters çevrilip çevrilemeyeceğini gösterir.

Kaynak

<Source> öğesi tek bir görüntü kaynak varlığını (XAML ve PNG) tanımlar.

XML
<Source Uri="uri" Background="background">
      <!-- optional NativeResource element -->
 </Source>
Öznitelik Tanım
Uri [Gerekli] Görüntünün nereden yüklenebileceğini tanımlayan bir URI. Şunlardan biri olabilir:

- application:/// yetkilisini kullanan bir Paket URI'si

- Mutlak bileşen kaynak başvurusu

- Yerel kaynak içeren bir dosyanın yolu
Background [İsteğe bağlı] Kaynağın ne tür bir arka plan üzerinde kullanılmasını hedeflediğini gösterir.

Şunlardan biri olabilir:

- Işık: Kaynak, açık arka planda kullanılabilir.

- Koyu: Kaynak koyu arka planda kullanılabilir.

- HighContrast: Kaynak, Yüksek Karşıtlık modunda herhangi bir arka planda kullanılabilir.

- HighContrastLight: Kaynak, Yüksek Karşıtlık modunda açık arka planda kullanılabilir.

-HighContrastDark: Kaynak, Yüksek Karşıtlık modunda koyu arka planda kullanılabilir.

Background özniteliği atlanırsa, kaynak herhangi bir arka planda kullanılabilir.

Arka Plan Açık, Koyu, HighContrastLight veya HighContrastDark ise, kaynağın renkleri hiçbir zaman ters çevrilemez. Arka Plan atlanırsa veya HighContrast olarak ayarlanırsa, kaynağın renklerinin ters çevrilmesi görüntünün AllowColorInversion özniteliği tarafından denetlenır.

Source <> öğesi, aşağıdaki isteğe bağlı alt öğelerden tam olarak birine sahip olabilir:

Öğe Öznitelikler (tümü gereklidir) Tanım
<Büyüklük> Değer Kaynak, belirtilen boyuttaki görüntüler için (cihaz birimlerinde) kullanılacaktır. Görüntü kare olacak.
<SizeRange> MinSize, MaxSize Kaynak, MinSize'den MaxSize'a (cihaz birimlerinde) dahil olmak üzere görüntüler için kullanılır. Görüntü kare olacak.
<Boyutlar> Genişlik, Yükseklik Kaynak, verilen genişlik ve yükseklik görüntüleri için kullanılır (cihaz birimlerinde).
<DimensionRange> MinWidth, MinHeight,

MaxWidth, MaxHeight
Kaynak, en düşük genişlik/yükseklik ile en yüksek genişlik/yükseklik (cihaz birimlerinde) dahil olmak üzere görüntüler için kullanılır.

Source <> öğesi, yönetilen bir derleme yerine yerel bir derlemeden yüklenen bir <Kaynağı> tanımlayan isteğe bağlı <bir NativeResource> alt öğesine de sahip olabilir.

XML
<NativeResource Type="type" ID="int" />
Öznitelik Tanım
Tür [Gerekli] Yerel kaynağın türü (XAML veya PNG)
Kimlik [Gerekli] Yerel kaynağın tamsayı kimliği bölümü

Imagelist

<ImageList> öğesi, tek bir şeritte döndürülebilen bir görüntü koleksiyonunu tanımlar. Şerit, gerektiğinde isteğe bağlı olarak inşa edilmiştir.

XML
<ImageList>
      <ContainedImage Guid="guid" ID="int" External="true/false" />
      <!-- optional additional ContainedImage elements -->
 </ImageList>
Öznitelik Tanım
GUID [Gerekli] Görüntü takma adını guid bölümü
Kimlik [Gerekli] Görüntü takma adını id bölümü
Harici [İsteğe bağlı, varsayılan false] Görüntü takma adını geçerli bildirimdeki bir görüntüye başvurup başvurmadığını gösterir.

kapsanan görüntünün adı geçerli bildirimde tanımlanan bir görüntüye başvurmak zorunda değildir. İçeren görüntü görüntü kitaplığında bulunamazsa, yerine boş bir yer tutucu görüntü kullanılır.

Aracı kullanma

Özel görüntü bildirimini doğrulama

Özel bildirim oluşturmak için ManifestFromResources aracını kullanarak bildirimi otomatik olarak oluşturmanızı öneririz. Özel bildirimi doğrulamak için Görüntü Kitaplığı Görüntüleyicisi'ni başlatın ve Dosya > Kümesi Yolları... öğesini seçin. arama dizinleri iletişim kutusunu açın. Araç, görüntü bildirimlerini yüklemek için arama dizinlerini kullanır, ancak bildirimdeki görüntüleri içeren .dll dosyalarını bulmak için de bu dizinleri kullanır, bu nedenle bu iletişim kutusuna hem bildirim hem de DLL dizinlerini eklediğinizden emin olun.

Image Library Viewer Search

Bildirimleri ve ilgili DLL'leri aramak üzere yeni arama dizinlerini seçmek için Ekle... seçeneğine tıklayın. Araç bu arama dizinlerini anımsar ve bir dizin denetlenerek veya işaretlerini kaldırılarak açılabilir veya kapatılabilir.

Varsayılan olarak, araç Visual Studio yükleme dizinini bulmaya ve bu dizinleri arama dizinleri listesine eklemeye çalışır. Aracın bulmadığı dizinleri el ile ekleyebilirsiniz.

Tüm bildirimler yüklendikten sonra araç, bir kullanıcının çeşitli ayarlar için doğru şekilde işlendiğini doğrulamak üzere görüntü varlıklarını görsel olarak denetleyebilmesi için resimler için arka plan renklerini, DPI'yı, yüksek karşıtlığı veya gri ölçeklendirmeyi değiştirmek için kullanılabilir.

Image Library Viewer Background

Arka plan rengi Açık, Koyu veya özel bir değer olarak ayarlanabilir. "Özel Renk" seçildiğinde bir renk seçimi iletişim kutusu açılır ve daha sonra kolayca geri çekebilmek için bu özel rengi arka plan birleşik giriş kutusunun altına ekleyin.

Image Library Viewer Custom Color

Bir resim takma adı seçildiğinde, sağ taraftaki Görüntü Ayrıntıları bölmesinde bu takma adın arkasındaki her gerçek görüntünün bilgileri görüntülenir. Bölme ayrıca kullanıcıların ada veya ham GUID:ID değerine göre bir takma ad kopyalamasına da olanak tanır.

Image Library Viewer Image Details

Her görüntü kaynağı için görüntülenen bilgiler, ne tür bir arka plan üzerinde görüntüleneceğini, temalı olup olmadığını veya Yüksek Karşıtlığı destekleyip desteklemediğini, hangi boyutlar için geçerli olduğunu veya boyut nötr olup olmadığını ve görüntünün yerel bir derlemeden mi geldiğini içerir.

Image Library Viewer Can Theme

Bir görüntü bildirimi doğrulanırken, bildirimi ve görüntü DLL'sini gerçek dünya konumlarına dağıtmanızı öneririz. Bu, göreli yolların düzgün çalıştığını ve görüntü kitaplığının bildirim ve görüntü DLL'sini bulup yükleyebildiğini doğrular.

Bilinen Resim kataloğu aranıyor

Visual Studio stiliyle daha iyi eşleşmesi için, Visual Studio uzantısı kendi görüntüsünü oluşturmak ve kullanmak yerine Visual Studio Görüntü Kataloğu'ndaki görüntüleri kullanabilir. Bu, bu görüntüleri korumak zorunda kalmadan avantaja sahiptir ve görüntünün yüksek DPI destekli bir görüntüye sahip olacağını garanti eder, bu nedenle Visual Studio'nun desteklediği tüm DPI ayarlarında doğru görünmelidir.

Görüntü kitaplığı görüntüleyicisi, kullanıcının bir görüntü varlığını temsil eden takma adı bulabilmesi ve kodda bu takma adı kullanabilmesi için bir bildirimin aranmasına izin verir. Resim aramak için, arama kutusuna istediğiniz arama terimini girin ve Enter tuşuna basın. Alttaki durum çubuğunda, tüm bildirimlerdeki toplam görüntülerden kaç eşleşme bulunduğu gösterilir.

Image Library Viewer Filter

Mevcut bildirimlerde görüntü takma adlarını ararken, yalnızca Visual Studio Görüntü Kataloğu'nun diğer bilinen adlarını, kasıtlı olarak genel olarak erişilebilen diğer takma adlarını veya kendi özel takma adlarınızı aramanızı ve kullanmanızı öneririz. Abonelik dışı adlar kullanıyorsanız, özel kullanıcı arabirimi bozulabilir veya bu nonpublic ad ve görüntülerin değiştirilmesi veya güncelleştirildiği durumlarda görüntüleri beklenmedik şekilde değiştirilebilir.

Ayrıca, GUID ile arama yapılabilir. Bu tür bir arama, listeyi tek bir bildirime veya bildirim birden çok GUID içeriyorsa bildirimin tek bir alt bölümüne filtrelemek için kullanışlıdır.

Image Library Viewer Filter GUID

Son olarak, kimlikle arama da mümkündür.

Image Library Viewer Filter ID

Notlar

  • Varsayılan olarak, araç Visual Studio yükleme dizininde bulunan çeşitli görüntü bildirimlerini çeker. Genel olarak kullanılabilir adlara sahip olan tek ad Microsoft.VisualStudio.ImageCatalog bildirimidir. GUID: ae27a6b0-e345-4288-96df-5eaf394ee369 (özel bildirimde bu GUID'i geçersiz kılma) Tür: Bilinen Adlar

  • Araç, bulduğu tüm görüntü bildirimlerini yüklemeyi dener, bu nedenle uygulamanın gerçekten görünmesi birkaç saniye sürebilir. Bildirimleri yüklerken yavaş veya yanıt vermiyor da olabilir.

Örnek Çıkış

Bu araç herhangi bir çıkış oluşturmaz.