現在のセッションの Microsoft Visio ステンシル ウィンドウの背景に表示されるグラデーション カラーを指定します。 値の取得と設定が可能です。
構文
式。StencilBackgroundColorGradient
式ApplicationSettings オブジェクトを表す変数。
戻り値
OLE_COLOR
注釈
StencilBackgroundColorGradient プロパティの設定は、Visio のセッション間で保持されません。
Visio 内部の OLE_COLOR プロパティの有効値は、次のいずれかです。
&H00 bbggrr です。bb は 0 から 0xFF (255) の青の値、gg は緑の値、rr は赤の値です。
&H800000 xx 、 xx は有効な GetSysColor インデックスです。
GetSysColor 関数の詳細については、MSDN の Microsoft Platform SDK で「GetSysColor」を検索してください。
OLE_COLOR データ型は、色を返すプロパティに使用されます。 プロパティが OLE_COLOR として宣言されると、プロパティ ウィンドウにカラー ピッカー ダイアログ ボックスが表示されます。このダイアログ ボックスを使用すると、ユーザーは、同等の数値を覚えておく必要なく、プロパティの色を視覚的に選択できます。
OLE_COLOR には、次の Microsoft Visual Basic for Applications (VBA) のカラー定数も使用できます。
| 定数 | 値 | 説明 |
|---|---|---|
| vbBlack | 0x0 | 黒 |
| vbRed | 0xFF | 赤 |
| vbGreen | 0xFF00 | 緑 |
| vbYellow | 0xFFFF | 黄 |
| vbBlue | 0xFF0000 | 青 |
| vbMagenta | 0xFF00FF | 紫 |
| vbCyan | 0xFFFF00 | シアン |
| vbWhite | 0xFFFFFF | ホワイト |
ActiveWindow.Windows(n) を使用して、個々のステンシル ウィンドウの背景グラデーション色を設定できます。BackgroundColorGradient プロパティ、n は Windows コレクション内のステンシル ウィンドウのインデックス番号を表します。 ステンシル ウィンドウをフローティング ウィンドウとして開くと、そのウィンドウはアクティブ ウィンドウにすることができ、 ActiveWindow.BackgroundColorGradient プロパティを使用して背景グラデーションの色を設定できます。 この方法でステンシル ウィンドウを開いた場合、アクティブなステンシル ウィンドウの BackgroundColor プロパティを既定の (-1) 以外の値に設定すると、そのウィンドウの StencilBackgroundColorGradient 設定が上書きされます。 StencilBackgroundColorGradient プロパティを設定して、同じアクティブなステンシル ウィンドウの背景グラデーションの色をリセットできるようにするには、BackgroundColorGradient を既定値の -1 にリセットする必要があります。 この種類のステンシル ウィンドウが複数開いている場合、1 つのウィンドウの BackgroundColorGradient を設定しても、開いている他のウィンドウの設定には影響しません。
注:
ステンシルの背景には 2 つの色を指定できます。 ユーザーの画面の解像度が適切であれば、画面の上から下に向かって、1 つの色からもう 1 つの色にグラデーション表示されます。 この機能を使用するには、ユーザーはモニターの設定を 32 ビット カラーにする必要があります。 ハイコントラスト モードで実行しているユーザーの場合は、ステンシルの背景色のプログラムでの設定は制限されます。
サポートとフィードバック
Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。