Application.HyperlinkPart メソッド (Access)

HyperlinkPart メソッドは、Hyperlink データ型として格納されているデータに関する情報を返します。

構文

式。HyperlinkPart (Hyperlink,Part)

expressionApplication オブジェクトを 表す変数。

パラメーター

名前	必須 / オプション	データ型	説明
Hyperlink	必須	バリアント型	ハイパーリンク フィールドに格納されているデータ。
指定項目	省略可能	AcHyperlinkPart	HyperlinkPart メソッドによって返される情報を表す AcHyperlinkPart 定数。

戻り値

文字列

注釈

HyperlinkPart メソッドを使用して、Hyperlink フィールドまたは表示される値から 3 つの値のいずれかを返します。 返される値は 、part 引数の設定によって異なります。

part 引数は省略可能です。 使用されていない場合、関数はハイパーリンクに対して表示される値 (part 引数の acDisplayedValue 設定に対応) を返します。 返される値は、 Hyperlink フィールドの 4 つの部分 (表示テキスト、 アドレス、 サブアドレス、または ヒント)、完全なアドレス、 アドレス# サブアドレス、またはハイパーリンクに対して Microsoft Access が表示する値のいずれかです。

注:

クエリで HyperlinkPart メソッドを使用する場合は、 part 引数が必要であり、上記の定数を使用することはできませんが、代わりに実際の値を使用する必要があります。

ハイパーリンク フィールドの表示テキスト部分に値を指定すると、Microsoft Access によって表示される値は表示テキスト設定と同じになります。 Hyperlink フィールドの表示テキスト部分に値がない場合、表示される値は、フィールドに最初に存在する値に応じて、[ハイパーリンク] フィールドのアドレスまたはサブアドレス部分になります。

次の表は、Hyperlink フィールドに格納されているデータに対して HyperlinkPart メソッドによって返される値を示しています。

ハイパーリンク フィールドのデータ	HyperlinkPart メソッドが返す値
#https://www.microsoft.com#	acDisplayedValue: https://www.microsoft.com acDisplayText: acAddress: https://www.microsoft.com acSubAddress: acScreenTip: acFullAddress: https://www.microsoft.com
Microsoft#https://www.microsoft.com#	acDisplayedValue: Microsoft acDisplayText: Microsoft acAddress: https://www.microsoft.com acSubAddress: acScreenTip: acFullAddress: https://www.microsoft.com
Customers#https://www.microsoft.com#Form Customers	acDisplayedValue: Customers acDisplayText: Customers acAddress: https://www.microsoft.com acSubAddress: Form Customers acScreenTip: acFullAddress: https://www.microsoft.com#Form Customer
##Form Customers#Enter Information	acDisplayedValue: Form Customers acDisplayText: acAddress: acSubAddress: Form Customers acScreenTip: Enter Information acFullAddress: #FormCustomer

[ハイパーリンクの挿入] ダイアログ ボックス ([挿入] メニューの [ハイパーリンク] を選択して使用できます) または [ハイパーリンク] フィールドに住所パーツを直接入力して、ハイパーリンク フィールドにアドレスパーツを追加すると、ハイパーリンク データの一部を区切る 2 つの # 記号が追加されます。

ハイパーリンク フィールドの 表示テキスト 部分を追加または編集するには、テーブル、フォーム、またはレポート内のハイパーリンクを右クリックし、ショートカット メニューの [ハイパーリンク ] をポイントし、[表示 するテキスト ] ボックスに表示テキストを入力します。

ハイパーリンク フィールドにデータを直接追加する場合は、 ハイパーリンク データの部分を区切るために 2 つの # 記号を含める必要があります。

例

次の例では、4 つのすべての part 引数定数を使用して、Hyperlink フィールドを含むテーブル内の各レコードの HyperlinkPart メソッドによって返される情報を表示します。 この例を試すには、DisplayHyperlinkParts プロシージャをモジュールの [宣言] セクションに貼り付けます。 DisplayHyperlinkParts プロシージャは、[デバッグ] ウィンドウから呼び出して、ハイパーリンクを含むテーブルの名前と、Hyperlink データを含むフィールドの名前を渡すことができます。 例:

DisplayHyperlinkParts "MyHyperlinkTableName", "MyHyperlinkFieldName" 
 
Public Sub DisplayHyperlinkParts(ByVal strTable As String, _ 
 ByVal strField As String) 
 
 Dim rst As New ADODB.Recordset 
 Dim strMsg As String 
 
 
 rst.Open strTable, CurrentProject.Connection, _ 
 adOpenForwardOnly, adLockReadOnly 
 
 ' For each record in table. 
 Do Until rst.EOF 
 strMsg = "DisplayValue = " _ 
 & HyperlinkPart(rst(strField), acDisplayedValue) _ 
 & vbCrLf & "DisplayText = " _ 
 & HyperlinkPart(rst(strField), acDisplayText) _ 
 & vbCrLf & "Address = " _ 
 & HyperlinkPart(rst(strField), acAddress) _ 
 & vbCrLf & "SubAddress = " _ 
 & HyperlinkPart(rst(strField), acSubAddress) _ 
 & vbCrLf & "ScreenTip = " _ 
 & HyperlinkPart(rst(strField), acScreenTip) _ 
 & vbCrLf & "Full Address = " _ 
 & HyperlinkPart(rst(strField), acFullAddress) 
 
 ' Show parts returned by HyperlinkPart function. 
 MsgBox strMsg 
 rst.MoveNext 
 Loop 
 
End Sub

HyperlinkPart メソッドをクエリ内で使う場合、引数 part は省略できません。 たとえば、次の SQL ステートメントでは HyperlinkPart メソッドを使用して、Links テーブルの URL フィールドに Hyperlink データ型として格納されているデータに関する情報を返します。

SELECT Links.URL, HyperlinkPart([URL],0) 
 AS Display, HyperlinkPart([URL],1) 
 AS Name, HyperlinkPart([URL],2) 
 AS Addr, HyperlinkPart([URL],3) 
 AS SubAddr, HyperlinkPart([URL],4) 
 AS ScreenTip 
 FROM Links

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。