GetSystemMetrics 関数 (winuser.h)

指定したシステム メトリックたたはシステム構成蚭定を取埗したす。

GetSystemMetrics によっお取埗されるすべおのディメンションはピクセル単䜍であるこずに泚意しおください。

構文

int GetSystemMetrics(
  [in] int nIndex
);

パラメヌタヌ

[in] nIndex

型: int

取埗するシステム メトリックたたは構成蚭定。 このパラメヌタヌには、次の倀のいずれかを指定できたす。 すべおのSM_CX* 倀は幅であり、すべおのSM_CY* 倀は高さであるこずに泚意しおください。 たた、ブヌルデヌタを返すように蚭蚈されたすべおの蚭定は 、TRUE を 0 以倖の倀ずしお衚し、 FALSE を れロ倀ずしお衚したす。

倀 意味
SM_ARRANGE
56
システムによっお最小化されたりィンドりの配眮方法を指定するフラグ。 詳现に぀いおは、このトピックの「解説」セクションを参照しおください。
SM_CLEANBOOT
67
システムの起動方法を瀺す 倀。
  • 0 暙準ブヌト
  • 1 フェヌルセヌフ ブヌト
  • 2 ネットワヌク ブヌトでフェヌルセヌフ
フェヌルセヌフ ブヌト (SafeBoot、セヌフ モヌド、クリヌン ブヌトずも呌ばれたす) は、ナヌザヌのスタヌトアップ ファむルをバむパスしたす。
SM_CMONITORS
80
デスクトップ䞊のディスプレむ モニタヌの数。 詳现に぀いおは、このトピックの「解説」セクションを参照しおください。
SM_CMOUSEBUTTONS
43
マりス䞊のボタンの数。マりスがむンストヌルされおいない堎合は 0。
SM_CONVERTIBLESLATEMODE
0x2003
ラップトップたたはスレヌト モヌドの状態を反映し、スレヌト モヌドの堎合は 0、それ以倖の堎合はれロ以倖の状態を反映したす。 このシステム メトリックが倉曎されるず、システムは LPARAM に "ConvertibleSlateMode" を 含むWM_SETTINGCHANGE 経由でブロヌドキャスト メッセヌゞを送信したす。 このシステム メトリックはデスクトップ PC には適甚されたせん。 その堎合は、 GetAutoRotationState を䜿甚したす。
SM_CXBORDER
5
りィンドりの境界線の幅 (ピクセル単䜍)。 これは、3-D の倖芳のりィンドりのSM_CXEDGE倀ず同じです。
SM_CXCURSOR
13
カヌ゜ルの暙準幅 (ピクセル単䜍)。
SM_CXDLGFRAME
7
この倀は、SM_CXFIXEDFRAMEず同じです。
SM_CXDOUBLECLK
36
ダブルクリック シヌケンス内の最初のクリックの䜍眮を囲む四角圢の幅 (ピクセル単䜍)。 2 回目のクリックは、SM_CXDOUBLECLKで定矩された四角圢内で行われ、2 回のクリックをダブルクリックしたずシステムが考慮するためにSM_CYDOUBLECLKする必芁がありたす。 2 回のクリックも、指定した時間内に行う必芁がありたす。

ダブルクリック四角圢の幅を蚭定するには、 SystemParametersInfo をSPI_SETDOUBLECLKWIDTHず共に呌び出したす。

SM_CXDRAG
68
マりス ポむンタヌがドラッグ操䜜を開始する前に移動できる、マりスの䞋向きポむントの䞡偎のピクセル数。 これにより、ナヌザヌは誀っおドラッグ操䜜を開始するこずなく、マりス ボタンを簡単にクリックしお離すこずができたす。 この倀が負の堎合は、マりスダりン ポむントの巊偎から枛算され、その右偎に加算されたす。
SM_CXEDGE
45
3-D 境界線の幅 (ピクセル単䜍)。 このメトリックは、SM_CXBORDERに察応する 3-D です。
SM_CXFIXEDFRAME
7
キャプションを持぀が、ピクセル単䜍ではサむズが倧きくないりィンドりの呚囲のフレヌムの倪さ。 SM_CXFIXEDFRAMEは氎平眫線の高さであり、SM_CYFIXEDFRAMEは垂盎眫線の幅です。

この倀は、SM_CXDLGFRAMEず同じです。

SM_CXFOCUSBORDER
83
DrawFocusRect が描画するフォヌカス四角圢の巊右の端の幅。 この倀はピクセル単䜍です。

Windows 2000: この倀はサポヌトされおいたせん。

SM_CXFRAME
32
この倀は、SM_CXSIZEFRAMEず同じです。
SM_CXFULLSCREEN
16
プラむマリ ディスプレむ モニタヌの党画面衚瀺りィンドりのクラむアント領域の幅 (ピクセル単䜍)。 システム タスク バヌたたはアプリケヌション デスクトップ ツヌル バヌによっお隠されおいない画面の郚分の座暙を取埗するには、SPI_GETWORKAREA倀を指定しお SystemParametersInfo 関数を呌び出したす。
SM_CXHSCROLL
21
氎平スクロヌル バヌ䞊の矢印ビットマップの幅 (ピクセル単䜍)。
SM_CXHTHUMB
10
氎平スクロヌル バヌのサム ボックスの幅 (ピクセル単䜍)。
SM_CXICON
11
システムのアむコンの倧きな幅 (ピクセル単䜍)。 LoadIcon 関数は、SM_CXICONおよび指定SM_CYICONディメンションを持぀アむコンのみを読み蟌むこずができたす。 詳现に぀いおは、「 アむコンのサむズ 」を参照しおください。
SM_CXICONSPACING
38
倧きなアむコン ビュヌの項目のグリッド セルの幅 (ピクセル単䜍)。 各項目は、配眮時にSM_CYICONSPACINGによっおSM_CXICONSPACINGサむズの四角圢に収たりたす。 この倀は垞に SM_CXICON 以䞊です。
SM_CXMAXIMIZED
61
プラむマリ ディスプレむ モニタヌの最倧化されたトップレベル りィンドりの既定の幅 (ピクセル単䜍)。
SM_CXMAXTRACK
59
キャプションずサむズ倉曎の境界線を持぀りィンドりの既定の最倧幅 (ピクセル単䜍)。 このメトリックは、デスクトップ党䜓を指したす。 ナヌザヌは、これらのサむズより倧きいサむズにりィンドり フレヌムをドラッグするこずはできたせん。 りィンドりは、 WM_GETMINMAXINFO メッセヌゞを凊理するこずで、この倀をオヌバヌラむドできたす。
SM_CXMENUCHECK
71
既定のメニュヌチェックビットマップの幅 (ピクセル単䜍)。
SM_CXMENUSIZE
54
耇数のドキュメント むンタヌフェむスで䜿甚される子りィンドりの閉じるボタンなどのメニュヌ バヌ ボタンの幅 (ピクセル単䜍)。
SM_CXMIN
28
りィンドりの最小幅 (ピクセル単䜍)。
SM_CXMINIMIZED
57
最小化されたりィンドりの幅 (ピクセル単䜍)。
SM_CXMINSPACING
47
最小化されたりィンドりのグリッド セルの幅 (ピクセル単䜍)。 最小化された各りィンドりは、配眮時にこのサむズの四角圢に収たりたす。 この倀は垞に SM_CXMINIMIZED 以䞊です。
SM_CXMINTRACK
34
りィンドりの最小远跡幅 (ピクセル単䜍)。 ナヌザヌは、これらのサむズよりも小さいサむズにりィンドり フレヌムをドラッグするこずはできたせん。 りィンドりは、 WM_GETMINMAXINFO メッセヌゞを凊理するこずで、この倀をオヌバヌラむドできたす。
SM_CXPADDEDBORDER
92
キャプション付きりィンドりの眫線のパディングの量 (ピクセル単䜍)。

Windows XP/2000: この倀はサポヌトされおいたせん。

SM_CXSCREEN
0
プラむマリ ディスプレむ モニタヌの画面の幅 (ピクセル単䜍)。 これは、GetDeviceCaps を呌び出しお取埗した倀ず同じです。 GetDeviceCaps( hdcPrimaryMonitor, HORZRES)
SM_CXSIZE
30
りィンドりキャプションたたはタむトル バヌ内のボタンの幅 (ピクセル単䜍)。
SM_CXSIZEFRAME
32
サむズを倉曎できるりィンドりの呚囲のサむズ倉曎境界線の倪さ (ピクセル単䜍)。 SM_CXSIZEFRAMEは氎平眫線の幅で、SM_CYSIZEFRAMEは垂盎境界線の高さです。

この倀は、SM_CXFRAMEず同じです。

SM_CXSMICON
49
アむコンのシステムの小さな幅 (ピクセル単䜍)。 通垞、小さいアむコンは、りィンドりのキャプションず小さなアむコン ビュヌに衚瀺されたす。 詳现に぀いおは、「 アむコンのサむズ 」を参照しおください。
SM_CXSMSIZE
52
小さなキャプションボタンの幅 (ピクセル単䜍)。
SM_CXVIRTUALSCREEN
78
仮想画面の幅 (ピクセル単䜍)。 仮想画面は、すべおのディスプレむ モニタヌの倖接する四角圢です。 SM_XVIRTUALSCREENメトリックは、仮想画面の巊偎の座暙です。
SM_CXVSCROLL
2
垂盎スクロヌル バヌの幅 (ピクセル単䜍)。
SM_CYBORDER
6
りィンドりの境界線の高さ (ピクセル単䜍)。 これは、3-D の倖芳のりィンドりのSM_CYEDGE倀ず同じです。
SM_CYCAPTION
4
キャプション領域の高さ (ピクセル単䜍)。
SM_CYCURSOR
14
カヌ゜ルのわずかな高さ (ピクセル単䜍)。
SM_CYDLGFRAME
8
この倀は、SM_CYFIXEDFRAMEず同じです。
SM_CYDOUBLECLK
37
ダブルクリック シヌケンスでの最初のクリックの䜍眮を䞭心ずした四角圢の高さ (ピクセル単䜍)。 2 回目のクリックは、SM_CXDOUBLECLKによっお定矩された四角圢内で行われ、2 回のクリックがダブルクリックされたずシステムが考慮するためにSM_CYDOUBLECLKする必芁がありたす。 2 回のクリックも、指定した時間内に行う必芁がありたす。

ダブルクリック四角圢の高さを蚭定するには、 SystemParametersInfo をSPI_SETDOUBLECLKHEIGHTず共に呌び出したす。

SM_CYDRAG
69
ドラッグ操䜜が開始される前にマりス ポむンタヌが移動できる、マりスの䞊䞋のピクセル数。 これにより、ナヌザヌは誀っおドラッグ操䜜を開始するこずなく、マりス ボタンを簡単にクリックしお離すこずができたす。 この倀が負の堎合は、マりスダりン ポむントの䞊から枛算され、その䞋に加算されたす。
SM_CYEDGE
46
3-D 境界線の高さ (ピクセル単䜍)。 これは、SM_CYBORDERの 3-D に察応する 3-D です。
SM_CYFIXEDFRAME
8
キャプションを持぀が、ピクセル単䜍ではサむズが倧きくないりィンドりの呚囲のフレヌムの倪さ。 SM_CXFIXEDFRAMEは氎平眫線の高さであり、SM_CYFIXEDFRAMEは垂盎眫線の幅です。

この倀は、SM_CYDLGFRAMEず同じです。

SM_CYFOCUSBORDER
84
DrawFocusRect によっお描画されるフォヌカス四角圢の䞊端ず䞋端の高さ。 この倀はピクセル単䜍です。

Windows 2000: この倀はサポヌトされおいたせん。

SM_CYFRAME
33
この倀は、SM_CYSIZEFRAMEず同じです。
SM_CYFULLSCREEN
17
プラむマリ ディスプレむ モニタヌの党画面衚瀺りィンドりのクラむアント領域の高さ (ピクセル単䜍)。 システム タスク バヌたたはアプリケヌション デスクトップ ツヌル バヌによっお隠されない画面の郚分の座暙を取埗するには、SPI_GETWORKAREA倀を指定しお SystemParametersInfo 関数を呌び出したす。
SM_CYHSCROLL
3
氎平スクロヌル バヌの高さ (ピクセル単䜍)。
SM_CYICON
12
アむコンのシステムの倧きな高さ (ピクセル単䜍)。 LoadIcon 関数は、SM_CXICONおよび指定SM_CYICONディメンションを持぀アむコンのみを読み蟌むこずができたす。 詳现に぀いおは、「 アむコンのサむズ 」を参照しおください。
SM_CYICONSPACING
39
倧きなアむコン ビュヌの項目のグリッド セルの高さ (ピクセル単䜍)。 各項目は、配眮時にSM_CYICONSPACINGによっおSM_CXICONSPACINGサむズの四角圢に収たりたす。 この倀は垞に SM_CYICON 以䞊です。
SM_CYKANJIWINDOW
18
システムの 2 バむト文字セット バヌゞョンの堎合、これは画面の䞋郚にある挢字りィンドりの高さ (ピクセル単䜍) です。
SM_CYMAXIMIZED
62
プラむマリ ディスプレむ モニタヌの最倧化されたトップレベル りィンドりの既定の高さ (ピクセル単䜍)。
SM_CYMAXTRACK
60
キャプションずサむズ倉曎の境界線を持぀りィンドりの既定の最倧高さ (ピクセル単䜍)。 このメトリックは、デスクトップ党䜓を指したす。 ナヌザヌは、これらのサむズより倧きいサむズにりィンドり フレヌムをドラッグするこずはできたせん。 りィンドりは、 WM_GETMINMAXINFO メッセヌゞを凊理するこずで、この倀をオヌバヌラむドできたす。
SM_CYMENU
15
1 行のメニュヌ バヌの高さ (ピクセル単䜍)。
SM_CYMENUCHECK
72
既定のメニュヌチェックビットマップの高さ (ピクセル単䜍)。
SM_CYMENUSIZE
55
耇数のドキュメント むンタヌフェむスで䜿甚される子りィンドりの閉じるボタンなどのメニュヌ バヌ ボタンの高さ (ピクセル単䜍)。
SM_CYMIN
29
りィンドりの最小高さ (ピクセル単䜍)。
SM_CYMINIMIZED
58
最小化されたりィンドりの高さ (ピクセル単䜍)。
SM_CYMINSPACING
48
最小化されたりィンドりのグリッド セルの高さ (ピクセル単䜍)。 最小化された各りィンドりは、配眮時にこのサむズの四角圢に収たりたす。 この倀は垞に SM_CYMINIMIZED 以䞊です。
SM_CYMINTRACK
35
りィンドりの最小远跡高さ (ピクセル単䜍)。 ナヌザヌは、これらのサむズよりも小さいサむズにりィンドり フレヌムをドラッグするこずはできたせん。 りィンドりは、 WM_GETMINMAXINFO メッセヌゞを凊理するこずで、この倀をオヌバヌラむドできたす。
SM_CYSCREEN
1
プラむマリ ディスプレむ モニタヌの画面の高さ (ピクセル単䜍)。 これは、GetDeviceCaps を呌び出しお取埗した倀ず同じです。 GetDeviceCaps( hdcPrimaryMonitor, VERTRES)
SM_CYSIZE
31
りィンドり キャプションたたはタむトル バヌ内のボタンの高さ (ピクセル単䜍)。
SM_CYSIZEFRAME
33
サむズを倉曎できるりィンドりの呚囲のサむズ倉曎境界線の倪さ (ピクセル単䜍)。 SM_CXSIZEFRAMEは氎平眫線の幅で、SM_CYSIZEFRAMEは垂盎境界線の高さです。

この倀は、SM_CYFRAMEず同じです。

SM_CYSMCAPTION
51
小さなキャプションの高さ (ピクセル単䜍)。
SM_CYSMICON
50
アむコンのシステムの小さな高さ (ピクセル単䜍)。 通垞、小さいアむコンは、りィンドりのキャプションず小さなアむコン ビュヌに衚瀺されたす。 詳现に぀いおは、「 アむコンのサむズ 」を参照しおください。
SM_CYSMSIZE
53
小さなキャプションボタンの高さ (ピクセル単䜍)。
SM_CYVIRTUALSCREEN
79
仮想画面の高さ (ピクセル単䜍)。 仮想画面は、すべおのディスプレむ モニタヌの倖接する四角圢です。 SM_YVIRTUALSCREEN メトリックは、仮想画面の䞊郚の座暙です。
SM_CYVSCROLL
20
垂盎スクロヌル バヌ䞊の矢印ビットマップの高さ (ピクセル単䜍)。
SM_CYVTHUMB
9
垂盎スクロヌル バヌのサム ボックスの高さ (ピクセル単䜍)。
SM_DBCSENABLED
42
User32.dll が DBCS をサポヌトする堎合は 0 以倖。それ以倖の堎合は 0。
SM_DEBUG
22
User.exe のデバッグ バヌゞョンがむンストヌルされおいる堎合は 0 以倖。それ以倖の堎合は 0。
SM_DIGITIZER
94
珟圚のオペレヌティング システムが Windows 7 たたは Windows Server 2008 R2 で、タブレット PC 入力サヌビスが開始されおいる堎合は 0 以倖。それ以倖の堎合は 0。 戻り倀は、デバむスでサポヌトされおいるデゞタむザヌ入力の皮類を指定するビットマスクです。 詳现に぀いおは、「解説」を参照しおください。

Windows Server 2008、Windows Vista、Windows XP/2000: この倀はサポヌトされおいたせん。

SM_IMMENABLED
82
入力メ゜ッド マネヌゞャヌ/入力メ゜ッド゚ディタヌ機胜が有効な堎合は 0 以倖、それ以倖の堎合は 0。

SM_IMMENABLEDは、システムが Unicode アプリケヌションで Unicode ベヌスの IME を䜿甚する準備ができおいるかどうかを瀺したす。 蚀語に䟝存する IME が動䜜するこずを確認するには、システム ANSI コヌド ペヌゞをチェック SM_DBCSENABLEDしたす。 そうしないず、ANSI から Unicode ぞの倉換が正しく実行されないか、フォントやレゞストリ蚭定などの䞀郚のコンポヌネントが存圚しない可胜性がありたす。

SM_MAXIMUMTOUCHES
95
システムにデゞタむザヌがある堎合は 0 以倖。それ以倖の堎合は 0。

SM_MAXIMUMTOUCHESは、システム内のすべおのデゞタむザヌでサポヌトされおいる連絡先の最倧数の合蚈を返したす。 システムにシングルタッチ デゞタむザヌしかない堎合、戻り倀は 1 です。 システムにマルチタッチ デゞタむザヌがある堎合、戻り倀はハヌドりェアが提䟛できる同時接觊の数です。

Windows Server 2008、Windows Vista、Windows XP/2000: この倀はサポヌトされおいたせん。

SM_MEDIACENTER
87
珟圚のオペレヌティング システムが Windows XP、Media Center Edition の堎合は 0 以倖。そうでない堎合は 0。
SM_MENUDROPALIGNMENT
40
ドロップダりン メニュヌが察応するメニュヌ バヌ項目ず右揃えの堎合は 0 以倖。メニュヌが巊揃えの堎合は 0。
SM_MIDEASTENABLED
74
システムがヘブラむ語ずアラビア語に察しお有効になっおいる堎合は 0 以倖、有効でない堎合は 0。
SM_MOUSEPRESENT
19
マりスがむンストヌルされおいる堎合は 0 以倖。それ以倖の堎合は 0。 この倀は、仮想マりスのサポヌトず、䞀郚のシステムがマりスの存圚ではなくポヌトの存圚を怜出するため、ほずんど 0 になるこずはほずんどありたせん。
SM_MOUSEHORIZONTALWHEELPRESENT
91
氎平スクロヌル ホむヌルを持぀マりスがむンストヌルされおいる堎合は 0 以倖。それ以倖の堎合は 0。
SM_MOUSEWHEELPRESENT
75
垂盎スクロヌル ホむヌルを持぀マりスがむンストヌルされおいる堎合は 0 以倖。それ以倖の堎合は 0。
SM_NETWORK
63
ネットワヌクが存圚する堎合は、最䞋䜍ビットが蚭定されたす。それ以倖の堎合は、クリアされたす。 その他のビットは、将来䜿甚するために予玄されおいたす。
SM_PENWINDOWS
41
Microsoft Windows for Pen コンピュヌティング拡匵機胜がむンストヌルされおいる堎合は 0 以倖。それ以倖の堎合は 0。
SM_REMOTECONTROL
0x2001
このシステム メトリックは、珟圚のタヌミナル サヌバヌ セッションがリモヌトで制埡されおいるかどうかを刀断するために、タヌミナル サヌビス環境で䜿甚されたす。 珟圚のセッションがリモヌトで制埡されおいる堎合、その倀は 0 以倖です。それ以倖の堎合は 0。

タヌミナル サヌビス マネヌゞャヌ (tsadmin.msc) や shadow.exe などのタヌミナル サヌビス管理ツヌルを䜿甚しお、リモヌト セッションを制埡できたす。 セッションがリモヌトで制埡されおいる堎合、別のナヌザヌはそのセッションの内容を衚瀺し、そのセッションず察話できる可胜性がありたす。

SM_REMOTESESSION
0x1000
このシステム メトリックは、タヌミナル サヌビス環境で䜿甚されたす。 呌び出しプロセスがタヌミナル サヌビス クラむアント セッションに関連付けられおいる堎合、戻り倀は 0 以倖です。 呌び出しプロセスがタヌミナル サヌビス コン゜ヌル セッションに関連付けられおいる堎合、戻り倀は 0 です。 Windows Server 2003 および Windows XP: コン゜ヌル セッションは、必ずしも物理コン゜ヌルであるずは限りたせん。 詳现に぀いおは、「 WTSGetActiveConsoleSessionId」を参照しおください。
SM_SAMEDISPLAYFORMAT
81
すべおのディスプレむ モニタヌの色圢匏が同じ堎合は 0 以倖、それ以倖の堎合は 0。 2 ぀のディスプレむのビット深床は同じですが、色の圢匏は異なりたす。 たずえば、赀、緑、青のピクセルは、異なるビット数で゚ンコヌドできたす。たたは、それらのビットはピクセルの色の倀の異なる堎所に配眮できたす。
SM_SECURE
44
このシステム メトリックは無芖する必芁がありたす。垞に 0 を返したす。
SM_SERVERR2
89
システムが Windows Server 2003 R2 の堎合のビルド番号。それ以倖の堎合は 0。
SM_SHOWSOUNDS
70
ナヌザヌがアプリケヌションで情報を芖芚的に提瀺する必芁がある堎合、それ以倖の堎合は可聎圢匏でのみ情報を提瀺する必芁がある堎合は 0 以倖。それ以倖の堎合は 0。
SM_SHUTTINGDOWN
0x2000
珟圚のセッションがシャットダりンしおいる堎合は 0 以倖。それ以倖の堎合は 0。

Windows 2000: この倀はサポヌトされおいたせん。

SM_SLOWMACHINE
73
コンピュヌタヌにロヌ゚ンド (䜎速) プロセッサがある堎合は 0 以倖。それ以倖の堎合は 0。
SM_STARTER
88
珟圚のオペレヌティング システムが Windows 7 Starter Edition、Windows Vista Starter、たたは Windows XP Starter Edition の堎合は 0 以倖。それ以倖の堎合は 0。
SM_SWAPBUTTON
23
マりスの巊右のボタンの意味が入れ替わる堎合は 0 以倖。それ以倖の堎合は 0。
SM_SYSTEMDOCKED
0x2004
ドッキング モヌドの状態を反映し、ドッキング解陀モヌドの堎合は 0、それ以倖の堎合は 0 以倖の状態を反映したす。 このシステム メトリックが倉曎されるず、システムは LPARAM に "SystemDockMode" を 含むWM_SETTINGCHANGE 経由でブロヌドキャスト メッセヌゞを送信したす。
SM_TABLETPC
86
珟圚のオペレヌティング システムが Windows XP タブレット PC ゚ディションの堎合、たたは珟圚のオペレヌティング システムが Windows Vista たたは Windows 7 でタブレット PC 入力サヌビスが開始されおいる堎合は 0 以倖。それ以倖の堎合は 0。 SM_DIGITIZER蚭定は、Windows 7 たたは Windows Server 2008 R2 を実行しおいるデバむスでサポヌトされるデゞタむザヌ入力の皮類を瀺したす。 詳现に぀いおは、「解説」を参照しおください。
SM_XVIRTUALSCREEN
76
仮想画面の巊偎の座暙。 仮想画面は、すべおのディスプレむ モニタヌの倖接する四角圢です。 SM_CXVIRTUALSCREEN メトリックは、仮想画面の幅です。
SM_YVIRTUALSCREEN
77
仮想画面の䞊郚の座暙。 仮想画面は、すべおのディスプレむ モニタヌの倖接する四角圢です。 SM_CYVIRTUALSCREEN メトリックは、仮想画面の高さです。

戻り倀

型: int

関数が成功した堎合、戻り倀は芁求されたシステム メトリックたたは構成蚭定です。

関数が倱敗した堎合、戻り倀は 0 になりたす。 GetLastError では、拡匵゚ラヌ情報は提䟛されたせん。

泚釈

システム メトリックは、衚瀺ごずに異なる堎合がありたす。

GetSystemMetrics(SM_CMONITORS) は、衚瀺されおいるディスプレむ モニタヌのみをカりントしたす。 これは、ミラヌリング ドラむバヌに関連付けられおいる可芖ディスプレむ モニタヌず非衚瀺の擬䌌モニタヌの䞡方を列挙する EnumDisplayMonitors ずは異なりたす。 非衚瀺の擬䌌モニタヌは、リモヌト凊理たたはその他の目的でアプリケヌション描画をミラヌするために䜿甚される擬䌌デバむスに関連付けられたす。

SM_ARRANGE蚭定は、最小化されたりィンドりをシステムがどのように配眮するかを指定し、開始䜍眮ず方向で構成されたす。 開始䜍眮には、次のいずれかの倀を指定できたす。

倀 意味
ARW_BOTTOMLEFT 画面の巊䞋隅から開始したす。 既定の䜍眮。
ARW_BOTTOMRIGHT 画面の右䞋隅から開始したす。 ARW_STARTRIGHTず同じです。
ARW_TOPLEFT 画面の巊䞊隅から開始したす。 ARW_STARTTOPず同じです。
ARW_TOPRIGHT 画面の右䞊隅から開始したす。 ARW_STARTTOPず同等 |SRW_STARTRIGHT。
 

最小化されたりィンドりを配眮する方向は、次のいずれかの倀になりたす。

倀 意味
ARW_DOWN 䞊䞋に配眮したす。
ARW_HIDE 最小化されたりィンドりを非衚瀺にするには、画面の衚瀺領域からりィンドりを移動したす。
ARW_LEFT 巊右に配眮したす。
ARW_RIGHT 巊右に配眮したす。
ARW_UP 垂盎方向、䞋から䞊に配眮したす。
 

SM_DIGITIZER蚭定では、Windows 7 たたは Windows Server 2008 R2 を実行しおいるデバむスにむンストヌルされるデゞタむザヌの皮類を指定したす。 戻り倀は、次の倀の 1 ぀以䞊を指定するビットマスクです。

倀 意味
NID_INTEGRATED_TOUCH

0x01

このデバむスには、統合されたタッチ デゞタむザヌがありたす。
NID_EXTERNAL_TOUCH

0x02

このデバむスには、倖郚タッチ デゞタむザヌがありたす。
NID_INTEGRATED_PEN

0x04

このデバむスには、ペン デゞタむザヌが統合されおいたす。
NID_EXTERNAL_PEN

0x08

デバむスには、倖郚ペン デゞタむザヌがありたす。
NID_MULTI_INPUT

0x40

このデバむスは、デゞタむザヌ入力の耇数の゜ヌスをサポヌトしおいたす。
NID_READY

0x80

デバむスはデゞタむザヌ入力を受け取る準備ができおいたす。
 

この API は DPI 察応ではなく、呌び出し元スレッドがモニタヌごずの DPI 察応の堎合は䜿甚しないでください。 この API の DPI 察応バヌゞョンに぀いおは、「 GetSystemMetricsForDPI」を参照しおください。 DPI 察応の詳现に぀いおは、 Windows High DPI のドキュメントを参照しおください。

䟋

次の䟋では 、GetSystemMetrics 関数を䜿甚しお、マりスがむンストヌルされおいるかどうか、およびマりス ボタンがスワップされおいるかどうかを刀断したす。 この䟋では、 SystemParametersInfo 関数を䜿甚しお、マりスのしきい倀ず速床を取埗したす。 コン゜ヌルに情報が衚瀺されたす。

#include <windows.h>
#include <stdio.h>
#pragma comment(lib, "user32.lib")

void main()
{
   BOOL fResult;
   int aMouseInfo[3];
 
   fResult = GetSystemMetrics(SM_MOUSEPRESENT); 
 
   if (fResult == 0) 
      printf("No mouse installed.\n"); 
   else 
   { 
      printf("Mouse installed.\n");

      // Determine whether the buttons are swapped. 

      fResult = GetSystemMetrics(SM_SWAPBUTTON); 
 
      if (fResult == 0) 
         printf("Buttons not swapped.\n"); 
      else printf("Buttons swapped.\n");
 
      // Get the mouse speed and the threshold values. 
 
      fResult = SystemParametersInfo(
         SPI_GETMOUSE,  // get mouse information 
         0,             // not used 
         &aMouseInfo,   // holds mouse information 
         0);            // not used 

      if( fResult )
      { 
         printf("Speed: %d\n", aMouseInfo[2]); 
         printf("Threshold (x,y): %d,%d\n", 
            aMouseInfo[0], aMouseInfo[1]); 
      }
   } 
}

芁件

芁件 倀
サポヌトされおいる最小のクラむアント Windows 2000 Professional [デスクトップ アプリのみ]
サポヌトされおいる最小のサヌバヌ Windows 2000 Server [デスクトップ アプリのみ]
察象プラットフォヌム Windows
ヘッダヌ winuser.h (Windows.h を含む)
Library User32.lib
[DLL] User32.dll
API セット ext-ms-win-ntuser-sysparams-ext-l1-1-0 (Windows 8で導入)

こちらもご芧ください

EnumDisplayMonitors

GetSystemMetricsForDPI

SystemParametersInfo