Elemen perintah

Artikel
2023-06-13

Mewakili definisi Perintah.

Penggunaan

<Command
  Name = "xs:string"
  Symbol = "xs:string"
  Id = "xs:positiveInteger union xs:string"
  Comment = "xs:string"
  LabelTitle = "xs:string"
  LabelDescription = "xs:string"
  TooltipTitle = "xs:string"
  TooltipDescription = "xs:string"
  Keytip = "xs:string">
  child elements
</Command>

Atribut

Atribut	Jenis	Diperlukan	Deskripsi
Komentar	xs:string	Tidak	Digunakan untuk membuat anotasi elemen perintah. (xs:string) String yang terdiri dari urutan karakter apa pun, termasuk spasi kosong dan karakter pemisah baris. Panjang maksimum: 250 karakter.
Id	xs:positiveInteger union xs:string	Tidak	ID sumber daya yang unik. (Persatuan xs:positiveInteger dan xs:string) Nilai bilangan bulat antara 2 dan 59999, inklusif, atau 0x2 dan 0xea5f dalam heksadesimal, inklusif. Panjang maksimum adalah 10 karakter, termasuk nol di depan opsional.
TipsAlat	xs:string	Tidak	String yang mewakili pintasan keyboard dari elemen perintah. (xs:string) String yang terdiri dari urutan karakter apa pun, termasuk spasi kosong.
LabelDescription	xs:string	Tidak	String yang mewakili teks yang ditampilkan pada elemen perintah. (xs:string) String yang terdiri dari urutan karakter apa pun, termasuk spasi kosong dan karakter pemisah baris.
LabelTitle	xs:string	Tidak	String yang mewakili teks yang ditampilkan pada elemen perintah. (xs:string) String yang terdiri dari urutan karakter apa pun, termasuk spasi kosong dan karakter pemisah baris.
Nama	xs:string	Tidak	(xs:string) String yang terdiri dari huruf atau garis bawah diikuti dengan urutan digit, huruf, atau garis bawah apa pun. Panjang maksimum: 100 karakter.
Simbol	xs:string	Tidak	(xs:string) String yang terdiri dari huruf atau garis bawah diikuti dengan urutan digit, huruf, atau garis bawah apa pun. Panjang maksimum: 100 karakter.
TooltipDescription	xs:string	Tidak	String yang mewakili teks yang ditampilkan pada elemen perintah. (xs:string) String yang terdiri dari urutan karakter apa pun, termasuk spasi kosong dan karakter pemisah baris.
TooltipTitle	xs:string	Tidak	String yang mewakili teks yang ditampilkan pada elemen perintah. (xs:string) String yang terdiri dari urutan karakter apa pun, termasuk spasi kosong dan karakter pemisah baris.

Elemen anak

Elemen	Deskripsi
Command.Comment	Dapat terjadi paling banyak sekali
Command.Id	Dapat terjadi paling banyak sekali
Command.Keytip	Dapat terjadi paling banyak sekali
Command.LabelDescription	Dapat terjadi paling banyak sekali
Command.LabelTitle	Dapat terjadi paling banyak sekali
Command.LargeHighContrastImages	Dapat terjadi paling banyak sekali
Command.LargeImages	Dapat terjadi paling banyak sekali
Command.Name	Dapat terjadi paling banyak sekali
Command.SmallHighContrastImages	Dapat terjadi paling banyak sekali
Command.SmallImages	Dapat terjadi paling banyak sekali
Command.Symbol	Dapat terjadi paling banyak sekali
Command.TooltipDescription	Dapat terjadi paling banyak sekali
Command.TooltipTitle	Dapat terjadi paling banyak sekali

Elemen induk

Elemen
Application.Commands

Keterangan

Wajib diisi.

Dapat terjadi satu atau beberapa kali untuk setiap elemen Application.Commands .

Elemen turunan dari elemen Perintah dapat terjadi dalam urutan apa pun.

Biasanya, sumber daya Perintah dideklarasikan dalam markup Pita, tetapi juga dapat diatur pada durasi dengan panggilan ke SetUICommandProperty. Misalnya, dimungkinkan untuk mengatur properti UI_PKEY_Keytip untuk Perintah alih-alih mendeklarasikan nilai dalam markup dengan elemen Command.Keytip .

Dalam kasus di mana properti Perintah, seperti label dan gambar, tidak dapat diatur dengan SetUICommandProperty , properti tersebut dapat dibatalkan dengan panggilan ke InvalidateUICommand. Setelah pembatalan, kerangka kerja meminta aplikasi host untuk detail sumber daya.

Catatan

Sumber daya tidak dapat dipulihkan dari tabel sumber daya markup setelah tidak valid.

Definisi Perintah ditambahkan ke file header markup Pita untuk setiap Perintah yang dinyatakan dalam markup.

Nilai Keytip bertindak sebagai akselerator keyboard untuk Perintah kecuali Perintah tersebut diekspos melalui item menu. Dalam hal ini, kerangka kerja mengabaikan nilai Keytip dan sebaliknya menggunakan karakter yang didahului oleh ampersand seperti yang ditentukan oleh LabelTitle atau UI_PKEY_Label. Jika tidak ada ampersand yang ditentukan oleh LabelTitle atau UI_PKEY_Label, tidak ada keytip atau akselerator keyboard yang terekspos.

Contoh

Contoh berikut menunjukkan manifes elemen Command untuk tab Beranda .

<Application.Commands>

<Command Name="cmdHomeTab"
         LabelTitle="Home"
         Keytip="H" />
<Command Name="cmdClipboardGroup"
         Symbol="IDR_CMD_CLIPBOARD"
         Id="10000"
         Comment="Command definition for clipboard group"
         LabelTitle="Clipboard"
         Keytip="CB" />
<Command Name="cmdCopy"
         Symbol="IDR_CMD_COPY"
         LabelTitle="Copy"
         LabelDescription="Copy"
         Keytip="C"
         TooltipTitle="Copy"
         TooltipDescription="Click to copy">
  <Command.SmallImages>
    <Image>res/copyS_16.bmp</Image>
  </Command.SmallImages>
  <Command.LargeImages>
    <Image>res/copyL_32.bmp</Image>
  </Command.LargeImages>
</Command>
<Command Name="cmdPaste"
         Symbol="IDR_CMD_PASTE" >
  <Command.LabelTitle>Paste</Command.LabelTitle>
  <Command.LabelDescription>
    <String Content="Paste contents of clipboard"
            Id="10001"
            Symbol="IDR_RES_LABELDESC_PASTE" />
  </Command.LabelDescription>
  <Command.Keytip>P</Command.Keytip>
  <Command.TooltipTitle>
    <String Content="Paste contents of clipboard"
            Id="10002"
            Symbol="IDR_RES_TOOLTIP_PASTE"/>
  </Command.TooltipTitle>
  <Command.TooltipDescription>
    <String Content="Click to paste contents of clipboard"/>
  </Command.TooltipDescription>
  <Command.SmallImages>
    <Image
      Id="10010"
      MinDPI="96"
      Symbol="IDR_RES_SMALL_IMAGE96">
      <Image.Source>res/pasteS_96bpp.bmp</Image.Source>
    </Image>
    <Image Source="res/pasteS_120bpp.bmp"
           Id="10011"
           MinDPI="120"
           Symbol="IDR_RES_SMALL_IMAGE120" />
  </Command.SmallImages>
  <Command.LargeImages>
    <Image>res/pasteL_32.bmp</Image>
  </Command.LargeImages>
</Command>
<Command Name="cmdMinimize"
         Symbol="IDR_CMD_MINIMIZE"
         Id="10001"
         LabelTitle="Minimize" />

</Application.Commands>

Informasi Elemen

Sistem minimum yang didukung: Windows 7
Bisa kosong: Tidak

Bagikan melalui