バージョン

ButtonMode プロパティ

ツールバーボタンの現在のモードを指定するButtonMode値を取得または設定します。
シンタックス
'宣言
 
Public Property ButtonMode As ButtonMode
public ButtonMode ButtonMode {get; set;}

プロパティ値

ツールバーボタンの現在のモードを指定するButtonMode値。デフォルト値はButtonMode.Imageです。
解説

デフォルトでは、このプロパティはButtonMode.Imageです。これは、ひとつの画像が各ボタンを表し、DHTMLを使用してマウス効果が適用されることを指定します（詳細はWebHtmlEditor.ButtonStyleプロパティを参照）。マウスオーバーの画像切り替えなどの高度な画像ボタン表示を使用したい場合、このプロパティをButtonMode.TwoStateImage（各ボタンに2つの画像があり、「オフ」画像と「クリックされた」画像を指定する）またはButtonMode.ThreeStateImage（各ボタンに3つの画像があり、「オフ」、「オーバー」、および「クリック」画像を指定する）に設定します。これらの2種類のひとつは一般的にスキン実装で使用されます（詳細はスキンの使用を参照）。ツールバーボタンから画像を削除したい場合、このプロパティをButtonMode.HTMLに設定し、HTML入力ボタンがツールバーボタンを表すために使用されます。

プロパティに関係する複数の画像名は、ボタンモードによって意味を持たなくなります。例：

ButtonMode.HTML

  • ImageNameプロパティ – 使用されません。
  • MouseDownImageNameプロパティ – 使用されません。
  • MouseOverImageNameプロパティ – 使用されません。

ButtonMode.Image

  • ImageNameプロパティ – ボタンに使用される画像を表します（例："bold.gif"）
  • MouseDownImageNameプロパティ – 使用されません。
  • MouseOverImageNameプロパティ – 使用されません。

ButtonMode.TwoStateImage

  • ImageNameプロパティ – ボタンに使用される画像を表します（例："bold.gif"）
  • MouseDownImageNameプロパティ – クリックされたときにボタンに使用される画像を表します（例："bold_down.gif"）
  • MouseOverImageNameプロパティ – 使用されません。

ButtonMode.TwoStateImage

  • ImageNameプロパティ – ボタンに使用される画像を表します（例："bold.gif"）
  • MouseDownImageNameプロパティ – クリックされたときにボタンに使用される画像を表します（例："bold_down.gif"）
  • MouseOverImageNameプロパティ - マウスをボタンに上に置いたときにボタンに使用される画像を表します（例："bold_over.gif"）
参照